Integrate

0. 最新 ADX Unity SDK 版本

Version 2.8.0

Release Date : 2025/10/01

从 2025 年 4 月 24 日起，上传到 App Store Connect 的应用必须使用 Xcode 16 或更高版本进行构建。 https://developer.apple.com/kr/news/

1) 下载 ADX Unity SDK。

2) 选择 Assets > Import Package > Custom Package，然后将下载的 ADXUnityPackage.unitypackage 文件找到并添加，或 ADXUnityPackage.unitypackage双击以运行。

当以新 Package 更新时，在导入 ADXUnityPackage 之前，请先删除以下所有文件夹和文件后再继续。

3) 选择所有文件并导入。

4) Unity Play Services Resolver如果已包含，请在 ADXUnityPackage 中排除 ExternalDependencyManager 后再导入即可。

在 Assets/Plugins/Android 目录下打开 mainTemplate.gradle 文件，并在 android 部分中添加 compileOptions。

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

关于 Play Services Resolver，请执行以下内容。
- 选择 Assets > External Dependency Manager > Android Resolver > Settings，然后 Use Jetifier 勾选后执行 Force Resolver。

为通过 Jetifier 支持 AndroidX 相关的旧版兼容，务必进行此设置。

选择 Assets > External Dependency Manager > iOS Resolver > Settings > Add use_frameworks! to Podfile并确认已勾选。
选择 Assets > External Dependency Manager > iOS Resolver > Settings > Link frameworks statically并确认已勾选。(当使用 Unity 引擎 2019.4 及以上时)

在 Unity 编辑器中构建后，请在 Xcode 中打开 *.xcworkspace (Unity-iPhone.xcworkspace) 扩展名文件。

在 Unity 编辑器中构建为 iOS 时，因为使用 CocoaPods，所以应打开带有 "xcworkspace" 扩展名的文件，而不是 "xcodeproj" 扩展名。
"xcworkspace" 扩展名文件需要在 Xcode 中打开。

在 Unity 2019.3 及以上版本中，请将 Unity-iPhone 和 UnityFramework 的 Enable Bitcode 都修改为 No。

在 XCode > 构建目标 (UnityFramework) 选择 > Build Settings > Other Linker Flags 中，如果使用 "-all-load" 或 "-force_load" 标志进行构建，可能会发生符号重复 (Symbol Duplicate)。在这种情况下请改为使用 "-ObjC" 标志。
<Build Settings - Other Linker Flags>
请确认以下构建目标中是否已添加 "$(inherited)"，如果未添加，可能会发生无法找到相关库的构建错误，因此请务必添加： Xcode > 构建目标 (Unity-iPhone) > Build Settings > Other Linker Flag Xcode > 构建目标 (UnityFramework) > Build Settings > Framework Search Paths
<Build Settings - Other Linker Flags>
<Build Settings - Framework Search Paths>
如果出现类似 "Cannot use '@try' with Objective-C exceptions disabled" 的构建错误，请将以下设置值从 'No' 更改为 'Yes'。 - Xcode > 构建目标 (Unity-Framework) 选择 > Enable Objective-C Exceptions