CocosCreator接入-Android平台配置

IMPORTANT

在完成Cocos层API调用之后， 如果要出Android平台的apk包，还需要根据本文档做一些额外的配置

准备工作

CocosCreator中接入好api后，我们可以编译发布，导出Android Studio工程了。我们可以从SDKDemo中，将一些原生平台的资源文件拷贝到游戏工程：

1、SDKDemo/native/engine/android/app/libs： SDK的依赖库文件，拷贝到游戏工程导出的AS工程对应目录下；
1、SDKDemo/native/engine/android/app/assets: SDK的依赖库文件，拷贝到游戏工程导出的AS工程对应目录下；
2、SDKDemo/native/engine/android/app/src/com/cocos/game/U8SDKForCocos.java和GameApplication.java： 拷贝到游戏工程导出的AS工程对应目录下，该文件处理原生平台和cocos层的交互；
3、SDKDemo/native/engine/android/app/src/com/cocos/game/AppActivity.java： 拷贝到游戏工程导出的AS工程对应目录下，该文件中调用UGSDKForCocos封装好的api，以及在Activity对应生命周期中调用SDK的生命周期函数。

如果AS工程中，原先没有加assets和libs的位置，可以打开app模块的build.gradle，增加下面的位置指定：

sourceSets.main {
    java.srcDirs "../src", "src", "libs"
    res.srcDirs "../res", 'res', "${RES_PATH}/proj/res"
    jniLibs.srcDirs "../libs", 'libs'
    manifest.srcFile "AndroidManifest.xml"
    assets.srcDirs "${RES_PATH}/data", "../assets", "assets"
    jniLibs {
        // Vulkan validation layer
        // srcDir "${android.ndkDirectory}/sources/third_party/vulkan/src/build-android/jniLibs"
    }
}

配置参数

打开AS工程/native/engine/android/app/assets/u8_developer_config.properties文件，修改里面的参数配置：

U8_APPID=1
U8_APPKEY=855237c757b7420bb932110efa41263b
U8_Channel=5109
U8SERVER_URL=https://uniapi.u8sdk.com

按说明修改u8_developer_config.properties中的参数。 如果你不知道如何获取这些参数，请参考文档： 获取参数。

参数说明：

参数名称	参数类型	参数说明
U8_APPID	string	U8SDK后台该游戏对应的AppID参数
U8_APPKEY	string	U8SDK后台该游戏对应的AppKey参数
U8_Channel	string	U8SDK后台->渠道配置中创建一个【U8测试平台】，设置的对应的渠道号

启动类配置

打开AS工程/native/engine/android/app/AndroidManifest.xml， 默认启动Activity是：com.cocos.game.AppActivity。

<activity android:name="com.cocos.game.AppActivity" android:screenOrientation="sensorLandscape" android:configChanges="orientation|keyboardHidden|screenSize|screenLayout|smallestScreenSize" android:theme="@android:style/Theme.NoTitleBar.Fullscreen" android:launchMode="singleTop" android:exported="true">
    <intent-filter>
    <action android:name="android.intent.action.MAIN"/>
    <category android:name="android.intent.category.LAUNCHER"/>
    </intent-filter>
</activity>

该类是Android原生层和Cocos层API交互的桥梁，如果游戏要调整启动类（比如增加隐私弹窗Activity），可以在这里进行调整。

Application配置

打开AS工程/native/engine/android/app/AndroidManifest.xml， 将application配置为：com.cocos.game.GameApplication。

<application android:name="com.cocos.game.GameApplication" android:usesCleartextTraffic="true">
    ...
</application>

如果游戏有自己的Application， 那可以按Android接入文档中实现Application模块的说明进行调整：Android接入配置

其他配置

如果要开启广告SDK的详细日志，可以在application节点内加入如下配置：

<meta-data android:name="vlog.enable" android:value="true" />
<meta-data android:name="vlog.level" android:value="debug" />
<meta-data android:name="vlog.local" android:value="true" />

导出APK

上述操作之后，我们就可以导出APK了。 在Android Studio菜单-》Build-》Generate Signed Bundle/APK中进行导出。

WARNING

需注意：国内渠道目前要求TargetSdkVersion为30。