您可以使用以下两种方法之一修改 AndroidManifest：

方法 1：Unity 自定义清单

1. 导航至 File > Build Settings > Player Settings > Publishing Settings 。
2. 在 Publishing Settings 部分下启用 "Custom Main Manifest" 。
3. Unity 会在 Assets/Plugins/Android/AndroidManifest.xml 处生成一个默认的 AndroidManifest.xml 文件。
4. 编辑此文件以添加所需的权限和配置。

来源： Unity Android Manifest 文档

方法 2：Android Studio

1. 使用 File > Build Settings > Export Project 从 Unity 导出您的项目。
2. 在 Android Studio 中打开导出的项目。
3. 直接在 Android Studio 中编辑 AndroidManifest.xml 文件。

方法 1：Unity 自定义模板

1. 导航至 File > Build Settings > Player Settings > Publishing Settings 。
2. 在 Publishing Settings 部分下启用 "Custom Gradle Template" 。
3. Unity 会在 Assets/Plugins/Android/mainTemplate.gradle 处生成一个 mainTemplate.gradle 文件。
4. 将您的自定义 Gradle 配置添加到此文件中。

来源： Unity Gradle Overview 文档

方法 2：Android Studio

1. 从 Unity 导出您的项目。
2. 在 Android Studio 中打开项目。
3. 直接编辑应用的 build.gradle 文件。

在 Unity 中构建 Android 应用时，您可能会遇到由多个 SDK 引入相同的传递依赖项而导致的 "Duplicate class"（重复类）错误。这种情况通常在同时使用 AppLovin SDK 和 Singular SDK 时，因 Android Vending Licensing 库而发生。

Duplicate class com.android.vending.licensing.ILicensingService found in modules
applovin-sdk-13.5.0.aar -> jetified-applovin-sdk-13.5.0-runtime (com.applovin:applovin-sdk:13.5.0)
and singular_sdk-12.11.0.aar -> jetified-singular_sdk-12.11.0-runtime (com.singular.sdk:singular_sdk:12.11.0)

解决方案 1：使用 External Dependency Manager (EDM4U)

如果您的项目使用 External Dependency Manager for Unity （推荐），请向您的 Dependencies XML 文件添加排除规则。

1. 在您的 Unity 项目中找到 *Dependencies.xml 文件（通常位于 Assets/Editor 或类似位置）。
2. 向其中一个 SDK 依赖项添加排除规则：

<dependencies>
  <androidPackages>
    <androidPackage spec="com.applovin:applovin-sdk:13.5.0">
      <androidSdkPackageIds>
        <exclude group="com.android.vending" module="licensing"/>
      </androidSdkPackageIds>
    </androidPackage>
    <androidPackage spec="com.singular.sdk:singular_sdk:12.11.0" />
  </androidPackages>
</dependencies>

解决方案 2：使用自定义 Gradle 模板

如果您未使用 EDM4U，请直接在您的 Gradle 配置文件中应用排除规则。

1. 导航至 File > Build Settings > Player Settings > Publishing Settings 。
2. 启用 "Custom Main Gradle Template" 或 "Custom Launcher Gradle Template" 。
3. 打开 Assets/Plugins/Android/mainTemplate.gradle （或 launcherTemplate.gradle ）。
4. 将排除规则添加到您的 dependencies 块中：

dependencies {
    implementation('com.applovin:applovin-sdk:13.5.0') {
        exclude group: 'com.android.vending', module: 'licensing'
    }
    implementation 'com.singular.sdk:singular_sdk:12.11.0'
}

替代方案： 通过在 dependencies 块之后添加以下内容来应用全局排除：

configurations.all {
    exclude group: 'com.android.vending', module: 'licensing'
}

验证解决结果

1. 应用排除规则后，通过删除 Library/Bee 和 Temp 文件夹来清理您的项目。
2. 在 Unity 中重新构建您的 Android 项目。
3. 确认构建输出中不再出现重复类错误。

如果您的项目使用 ProGuard 进行代码混淆，请将以下 keep 规则添加到您的 proguard-unity.txt 文件中，以防止 Singular SDK 被剥离：

-keep class com.singular.sdk.** { *; }
-keep public class com.android.installreferrer.** { *; }
-keep public class com.singular.unitybridge.** { *; }

在为 iOS 构建 Unity 项目之后、在 Xcode 中构建之前，请更新您的 CocoaPods 依赖项，以确保您拥有最新的 SDK 版本。

cd /path/to/your/ios/project
pod repo update
pod update

在测试您的集成时，记录 IDFV (Identifier for Vendor)，以便快速将您的测试设备添加到 Singular SDK Console 中。

添加 IDFV 日志记录

1. 在从 Unity 构建后打开您的 Xcode 项目。
2. 导航至 Classes > UnityAppController.mm 。
3. 找到 applicationDidBecomeActive 方法。
4. 添加以下代码以记录 IDFV：

// Log IDFV for testing
NSLog(@"Singular === IDFV: %@", [[[UIDevice currentDevice] identifierForVendor] UUIDString]);

5. 在 Xcode 中构建并运行您的应用。
6. 检查 Xcode 控制台日志以获取 IDFV 输出。
7. 复制 IDFV 并将其作为测试设备添加到 Singular SDK Console 中。

通过在您的 Xcode 项目中配置 Associated Domains，启用用于深度链接的 Universal Links。

深度链接设置步骤

1. 添加 Associated Domain： 在 Xcode 中，导航至您应用目标的 Signing & Capabilities 选项卡。
2. 启用功能： 点击 [+] Capability 并添加 "Associated Domains" 。
3. 添加域名： 以以下格式添加您的 Singular 追踪域名： applinks:yourdomain.sng.link
4. 配置 Team ID： 在 Singular 仪表板中，导航至您应用的设置并添加您的 Apple Team ID。这样 Singular 即可生成并托管 Universal Links 所需的 Apple App Site Association (AASA) 文件。

如果您正在使用其他注册 UnityAppController 的 SDK（例如 Firebase、Adjust 或 AppsFlyer），则可能会遇到导致 Singular 无法正常初始化的冲突。在 Unity 中，同一时间只能有一个类注册为 UnityAppController。

要解决此冲突：

1. 打开 您 Xcode 项目中的 SingularSwizzledAppController.m 文件。
2. 取消注释此文件中的所有代码。
3. 打开 SingularAppDelegate.m 并验证以下行未被注释掉：

   IMPL_APP_CONTROLLER_SUBCLASS(SingularAppDelegate)

这样 Singular 即可通过方法 swizzling 而非子类化 UnityAppController 的方式，与其他 SDK 协同工作。

将预制件添加到场景

1. 在 Project 面板中，导航至 Packages > Singular > SingularSDK > Prefabs 。
2. 将 SingularSDKObject 预制件拖入您的 Hierarchy 面板中。
3. 现在该预制件已可在 Inspector 中进行配置。

手动创建 GameObject

1. 在 Hierarchy 面板中，右键单击并选择 Create Empty 。
2. 将该 GameObject 命名为 SingularSDKObject （必须使用此确切名称）。
3. 在选中该 GameObject 的情况下，导航至 Inspector 面板。
4. 点击 Add Component 。
5. 搜索 "Singular" 并选择 Singular SDK 脚本组件。

• Initialize On Awake： 默认启用。当 GameObject 唤醒时，SDK 会自动初始化。如果您需要为隐私同意或其他要求而延迟初始化，请禁用此选项。
• SKAN Enabled： 默认启用（仅限 iOS）。在托管模式 (Managed Mode) 下启用 SKAdNetwork 归因，Singular 会根据您配置的转化模型自动更新转化值。
• Wait For Tracking Authorization： 设置为 0（禁用）。如果您的应用显示 iOS App Tracking Transparency (ATT) 提示，请将其设置为 300 秒。这会将 SDK 会话延迟到用户响应 ATT 提示之后，确保在授予同意时能够捕获 IDFA。如果不使用 ATT，请保持为 0。
• Enable Logging： 默认启用。输出 SDK 调试日志，以帮助集成和故障排除。在生产版本中应禁用此选项。它与 Log Level 设置（见下文）配合使用。
• Log Level： 默认设置为 3 (Info)。控制日志记录的详细程度。数字越小，日志越详细：
  C#

  // Based on Android Logger log levels
  public enum LogLevel {
     Verbose = 2,  // Most verbose
     Debug   = 3,
     Info    = 4,  // Default
     Warn    = 5,
     Error   = 6,
     Assert  = 7   // Least verbose
  }

  注意： 详细日志主要在 Android 上可用。

• DDL Timeout Sec： 设置为 0（使用 60 秒的默认值）。决定 SDK 等待服务器返回延迟深度链接数据的时长。如果在此超时后仍未找到延迟深度链接，服务器将停止搜索。
• Session Timeout Sec： 设置为 0（使用 60 秒的默认值）。定义应用在后台运行多长时间后，SDK 会在返回前台时创建新会话。
• Shortlink Resolve Timeout： 设置为 0（使用 10 秒的默认值）。等待短链接解析的最长时间。通过防止在短链接无法解析时长时间等待，保护用户体验。

如果您需要支持旧版 Meta Install Referrer 归因方法，请将您的 Facebook App ID 添加到 SingularSDKObject 配置中。

配置步骤

1. 在您的场景层级中选择 SingularSDKObject 。
2. 在 Inspector 面板中，找到 "Facebook App ID" 字段。
3. 输入您的 Facebook App ID（可在您的 Facebook Developer Console 中找到）。

其他资源：

• 什么是 Meta Install Referrer？
• 在哪里找到您的 Facebook App ID

升级流程

在通过 Unity Package Manager 安装 SDK 之前，请按顺序完成以下步骤：