实操指南，如何将欧逸Web3 APP集成引入你的开发工程

随着Web3行业的发展，越来越多开发者选择基于成熟基础设施搭建自有DApp和链上应用，欧逸Web3作为一站式Web3服务平台，开放了完整的APP端能力供第三方开发者集成，将欧逸Web3 APP的能力引入自有工程，可以快速获得安全稳定的钱包管理、多链交互、交易清算等核心能力，无需从零搭建全套Web3基础设施，本文将从前置准备到不同工程类型的实操步骤,带你完成完整接入。

集成前的前置准备

在开始引入前，需要先完成基础准备工作,避免后续出现配置错误：

1. 获取开发者认证与凭证：首先前往欧逸Web3官方开发者平台，注册账号后提交你的应用信息（包括应用包名、iOS Bundle ID、应用用途等），完成资质审核后，即可获得专属的AppID和SDK调用密钥,这是后续接入鉴权的核心凭证。
2. 确认环境适配：根据欧逸官方文档确认SDK版本的适配要求：比如Android要求API级别21以上、Gradle 7.0以上，iOS要求iOS 13以上，提前调整你的工程环境,避免兼容性问题。

不同类型工程的引入步骤

原生Android工程引入

第一步，添加依赖配置：打开项目根目录的settings.gradle（旧版本项目为根目录build.gradle）,在仓库块中添加欧逸的Maven地址：

repositories {
    google()
    mavenCentral()
    maven { url 'https://maven.ouyi.dev/release' }
}

随后在App模块的build.gradle中添加SDK依赖：

dependencies {
    implementation 'com.ouyi.web3:ouyi-web3-sdk:1.2.0' // 请替换为官方最新版本号
}

同步Gradle依赖完成后，配置权限：在AndroidManifest.xml中添加必要权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

最后在自定义Application类的onCreate方法中完成初始化：

OuYiWeb3Config config = new OuYiWeb3Config.Builder()
        .withAppId("你申请的AppID")
        .withEnv(OuYiEnv.PRODUCTION) // 开发测试可选择 OuYiEnv.DEV
        .build();
OuYiWeb3SDK.init(this, config);

至此Android工程的引入就完成了。

原生iOS工程引入

推荐使用CocoaPods管理依赖，在你的项目Podfile中添加：

pod 'OuYiWeb3SDK', '~> 1.2.0'

执行pod install --repo-update等待依赖安装完成，打开生成的.xcworkspace工程。 接下来配置跳转白名单，因为需要唤起欧逸APP完成授权，需要在Info.plist中添加Scheme声明：

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>ouyiweb3</string>
</array>

最后在AppDelegate中完成初始化：

#import <OuYiWeb3SDK/OuYiWeb3SDK.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    OuYiWeb3Config *config = [[OuYiWeb3Config alloc] init];
    config.appId = @"你申请的AppID";
    config.env = OuYiEnvProduction;
    [[OuYiWeb3SDK sharedInstance] initSDKWithConfig:config];
    return YES;
}

跨平台工程（React Native/Flutter）引入

针对主流跨平台开发框架,欧逸也提供了封装好的SDK：

• React Native：执行npm install ouyi-web3-rn --save完成安装，iOS端额外执行cd ios && pod install,在入口文件按照官方文档传入参数完成初始化即可。
• Flutter：在pubspec.yaml中添加依赖ouyi_web3_flutter: ^1.2.0，执行flutter pub get后完成初始化配置即可。

引入后的验证与常见问题排查

引入完成后，建议先测试核心流程验证集成是否成功：比如调用SDK唤起欧逸钱包授权、测试链上余额查询，确认跳转、返回、参数传递全流程正常，开发测试阶段建议使用欧逸提供的测试链环境,避免资产损失。

常见问题的排查方向：

1. 鉴权失败：检查AppID是否正确，应用包名/Bundle ID、签名信息是否和开发者后台填写一致,环境参数是否匹配。
2. 依赖同步失败：检查网络能否正常访问欧逸的代码仓库,更换网络环境后重试。
3. 依赖冲突：Android可以在依赖声明中排除重复依赖库，iOS可通过调整Pod版本约束解决冲突,具体可参考官方文档。

合规提示

需要注意的是，集成欧逸Web3能力需要严格遵守项目运营地区对区块链、Web3服务的相关监管规定，仅可用于合法合规的应用场景，本文仅为技术集成流程分享,不支持任何违规业务行为。

将欧逸Web3 APP能力引入工程的流程清晰，借助官方封装的SDK可以快速完成基础集成，帮助开发者节省大量Web3基础设施的开发和维护成本,快速落地自有链上应用。