Android客户端

IMPORTANT

本文档介绍U8SDK Android客户端工程导入和配置，以及生成jar/aar包等方式；
Android客户端需要使用Android Studio(2021)，如果您还没有下载安装，请先完成下载安装：AndroidStudio下载地址

项目结构

U8SDK Android整个客户端源码工程叫U8SDK_Projects，该工程是一个标准的Android Studio工程，首次打开，你可以直接通过Android Studio导入该工程，该工程由多个子工程组成。 示例工程结构如下：

1、 U8SDK3: U8SDK Android抽象层框架源码工程；该工程抽象了渠道SDK相关的API，将游戏层和渠道SDK接入彻底解耦，框架源码库直接编译出aar，即可使用。

2、 U8SDKDemo: U8SDK Android原生Demo源码工程；自己在测试的时候，可以用这个Demo出apk母包，然后用打包工具打出渠道包测试；提供给游戏接入的时候，Demo工程可以一并提供过去

4、 U8SDKSimpleSDK: U8SDK 默认实现的一个登陆界面和支付界面的源码工程，编译的jar包放到上面U8SDKRelease目录下libs里面，res资源和assets资源也放进去，这样打出来的母包就带一个测试的登陆界面和支付界面，游戏层接入之后，不需要通过打包工具打包，就可以直接测试登陆和支付功能，减少联调测试的时间

5、 其他工程： 各个渠道SDK或者插件SDK的接入工程，比如上图中U8SDK_BiliBili工程，就是B站的渠道SDK接入工程。 接入工程只有在接入新渠道SDK或者升级渠道SDK才需要用到，打包工具打包的时候，不依赖接入工程。

编译框架

整个U8SDK_Projects项目中，除了U8SDKDemo工程是application格式的，可以直接编译成apk； 其他工程都是库工程，可以直接编译成aar或者jar包。 编译aar可以直接使用as默认的编译就可以完成；

在给游戏层接入时， 只需要提供U8SDK3模块对应的aar即可。 可以执行如下命令编译出aar：

./gradlew :U8SDK3:build

默认聚合SDK框架里是没有包含任何渠道SDK的，母包在调用登录、支付等接口时，也不会有任何反应。 所以为了让母包能直接测试登录、支付等流程， 我们加了一个母包测试渠道模块， 提供了可供母包测试的登录UI和支付UI，这块内容在U8SDKSimpleSDK模块中。

我们也编译一下：

./gradlew :U8SDKSimpleSDK:build

编译后，可以将U8SDK3和U8SDKSimpleSDK对应build目录下的aar文件， 复制到U8SDKDemo/libs下；

发布框架

按上面步骤编译好框架和目标测试模块后， 将U8SDKDemo给到研发即可。 在给到之前，我们还需要核对一下母包测试参数。

打开 U8SDKDemo/src/main/assets/u8_developer_config.properties， 检查如下参数：

U8_APPID=1
U8_APPKEY=4ac634252fd24a89b2fb272e0f21fbed
U8_Channel=2
U8SERVER_URL=http://www.6xsdk.com:8080/server

1、 U8_APPID： U8Server管理后台-》游戏管理中，创建游戏之后，生成的appID参数
2、 U8_APPKEY: U8Server管理后台-》游戏管理中，创建游戏之后，生成的appKey参数
3、 U8_Channel: U8Server管理后台-》渠道管理中，创建一个渠道，渠道商选择U8测试平台，然后将后台配置的渠道号配置在这里
4、 U8SERVER_URL: 配置为U8Server部署之后对应的访问地址

WARNING

如果你不知道如何获取这些参数， 可以参考获取参数文档。