# Unity集成管理工具

Mint Mediation Unity集成管理工具基于Google External Dependency Manager ，它将使您能够直接从Unity开发平台下载最新版本的Mint Mediation SDK和中介适配器。

# 管理SDK版本

导入Unity package之后，您将可以在Unity菜单栏中查看MintMediation子菜单。

点击 Integration Manager 打开集成管理工具：

安装或更新Mint Mediation SDK或中介适配器

打开集成管理工具：MintMediation > Integration Manager
选择 “Install” or “Update“。未安装的广告SDK与Mint Adapter将显示为 “Install”，已安装的广告SDK与Mint Adapter将显示为 “Update”。

如果您已经是最新版本的Mint Mediation SDK或中介适配器，则按钮将更改为 “Updated”，并且将被禁用。

WARNING

在集成Mint Mediation SDK时，集成工具面板中的MintMediation为核心SDK，必须安装。Network下的均为Adapter，可以根据需要进行安装。比如您的应用需要集成Admob广告，那么您需要点击MintMediation和Admob右侧的install按钮进行安装，点击后会同时安装Admob SDK与Mint Admob Adapter。

# 针对Android的额外配置

使用Mint Mediation集成管理工具更改后需确保运行“Android Resolve”

手动运行: Assets →External Dependency Manager → Android Resolver → Resolve

如果提示 “Resolver not enabled. Android platform must be selected”，请确保您已经选择了Android平台： File → Build Settings → Android → Switch Platform

如果您启用 “Auto-Resolution”，则将在关闭Integration Manager窗口时执行所有更新。

更新成功后会弹窗提示“Resolution Succeeded“。

使用Gradle

如果您的项目使用gradle请按以下步骤设置Android Resolver

打开Android Resolver 设置面板: Assets → External Dependency Manager → Android Resolver → Settings
勾选 “Patch mainTemplate.gradle”
点击 “OK” 保存修改

打开 Edit → Project Settings → Player 选中 Android 选项卡，展开 Publishing Settings, 勾选 "Custom Gradle Properties Template"

如果您使用Unity2020及以后的版本，在生成的 /Assets/Plugins/Android/gradleTemplate.properties 文件中添加以下内容：

android.enableDexingArtifactTransform=false

如果您使用Unity2022版本，您还需要进行以下配置：

打开Edit → Project Settings → Player 选中 Android 选项卡，展开 Publishing Settings, 勾选 "Custom Gradle Settings Template"

更新 AndroidManifest.xml 文件

如果您的项目不含AndroidManifest.xml文件，请按照以下步骤生成 AndroidManifest.xml 文件，如果项目中已经存在AndroidManifest.xml文件，请跳过此步骤。

如需生成自定义AndroidManifest.xml文件，打开 Edit → Project Settings → Player 选中 Android 选项卡，展开 Publishing Settings, 勾选 "Custom Main Manifest Template"

在生成的 /Assets/Plugins/Android/AndroidManifest.xml 文件中添加以下内容：

添加mint sdk所需权限，添加以下内容到 <application> 标签外

    ...
    xmlns:tools="http://schemas.android.com/tools">
    

    <!-- 添加以下权限 -->
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <!-- 添加权限结束 -->

    <application>
    ...

如果您的Android应用将target API设定到Android 12(31)或更高的版本，推荐您添加AD_ID权限：

    ...
    xmlns:tools="http://schemas.android.com/tools">
    

    <!-- 添加以下权限 -->
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <!-- Target API 31级以上推荐添加 -->
    <uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
    <!-- 添加权限结束 -->

    <application>
    ...

了解更多关于AD_ID权限的信息，请参考Google Play官方文档 (opens new window)

如果您使用admob广告，请务必添加admob app id到 <application> 标签内

    ...
    <application>
        ...
        <!-- 添加以下内容 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="您的admob app id" />
        <!-- 添加内容结束 -->
    ...

# iOS

确保已安装CocoaPods: Assets →External Dependency Manager → iOS Resolver → Install CocoaPods