Unity接入-Android平台配置

WARNING

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

依赖配置

将Unity编译设置中，当前的平台切换到Android平台。之后在发布设置中，勾选自定义main gradle template。勾选后，会在Assets/Plugins/Android/下面，生成mainTemplate.gradle文件。

打开Assets/Plugins/Android/mainTemaplate.gradle，在dependencies添加如下基础依赖库：

java

// Google登录
implementation "androidx.credentials:credentials:1.5.0"
implementation "androidx.credentials:credentials-play-services-auth:1.5.0"
implementation "com.google.android.libraries.identity.googleid:googleid:1.1.1"

// google ad id
implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'

// Google支付
implementation 'com.android.billingclient:billing:7.0.0'
implementation 'com.android.installreferrer:installreferrer:2.2'

// Facebook登录
implementation 'com.facebook.android:facebook-login:14.1.1'

// LINE登录
implementation 'com.linecorp.linesdk:linesdk:5.8.0'

注意：底层上报依赖第三方数据SDK插件，如果开启了对应的插件SDK，还需要添加插件SDK相关的依赖库，可以参考： Android插件配置。

配置参数

打开Assets/Plugin/Android/libs/ug-sdk-release.aar中，assets/ug_dev.properties文件：

props

# SDK appID
ug.appid=1

# SDK appKey
ug.appkey=11111111111111111

# 游戏横竖屏 1:竖屏:2:横屏
ug.orientation=1

# SDK Server URL
ug.server.url=http://ugapi.bytesdk.com

配置项说明：

参数名称	参数类型	参数说明
ug.appid	String	当前游戏的appID参数，如果还没有该参数，请参考：获取参数
ug.appkey	String	当前游戏的appKey参数，如果还没有该参数，请参考：获取参数
ug.orientation	String	游戏横竖屏，1：竖屏； 2：横屏
ug.server.url	String	SDK服务端URL地址

启动类配置

打开Assets/Plugins/Android/AndroidManifest.xml，默认启动Activity是：com.ug.sdk.bridge.unity.UGUnityActivity，该Activity继承了com.unity3d.player.UnityPlayerActivity。

xml

<activity
    android:name="com.ug.sdk.bridge.unity.UGUnityActivity"
    android:screenOrientation="landscape"
    android:launchMode="singleTask"
    android:configChanges="orientation|keyboardHidden|screenSize"
    android:exported="true">

    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>

    <meta-data android:name="unityplayer.UnityActivity" android:value="true" />
    <meta-data android:name="unityplayer.ForwardNativeEventsToDalvik" android:value="false" />

</activity>

该类是Android原生层和Unity层API交互的桥梁，对应源码在UGSDK工程/ug-unity-bridge模块，如果游戏有自己的API需要扩展，可以在这里添加供Unity层调用的接口。

修改代码完成后执行 ./gradlew :ug-unity-bridge:generateJar 进行编译，编译成功后，会在其build/libs下生成ug-unity-bridge.jar，将其替换到Unity工程Assets/Plugins/Android/libs目录下。

Application配置

打开Assets/Plugins/Android/AndroidManifest.xml，默认配置的Application是：com.ug.sdk.app.UGApplication。

xml

<application android:name="com.ug.sdk.app.UGApplication" android:usesCleartextTraffic="true">
    ...
</application>

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

导出APK

上述配置完成后，即可导出apk或AS工程，在导出配置中，需要注意包名、版本信息的配置， Target API Level请选35（Android 15.0）

Unity导出APK

Unity接入-Android平台配置 ​

依赖配置 ​

配置参数 ​

启动类配置 ​