Unity Mediation安装Admob/IronSource适配器依赖冲突及崩溃问题咨询

核心问题定位 #

这类问题基本都是依赖重复引用、版本不匹配、配置冲突导致的，Unity Ads作为内置适配器不存在额外传递依赖，所以可以正常运行，第三方适配器（Admob、IronSource）会拉取对应平台的原生SDK，很容易和项目内现有插件产生冲突，按以下步骤逐一排查即可：

• 先统一依赖解析环境
  1. 打开Window > Package Manager，找到External Dependency Manager（原Play Services Resolver），升级到和当前Unity Mediation核心包匹配的正式版，过旧的Resolver版本无法正确识别适配器的传递依赖规则，是弹出冲突警告的最常见原因。
  2. 打开Assets > External Dependency Manager > Android Resolver > Settings（iOS平台选对应iOS Resolver设置项），勾选以下配置：
     • Enable Auto-Resolution
     • Enable Resolution On Build
     • Patch mainTemplate.gradle（Android平台）
     • Use Jetifier（Android平台）
  3. 执行对应平台的Force Resolve强制重新拉取、对齐所有依赖，等待解析完成后查看控制台输出的冲突日志，定位具体是哪几个库的版本存在重复引用、版本不兼容问题。
• 修复Admob适配器安装后启动崩溃问题
  1. 先清理冗余SDK：如果之前手动导入过独立版Google Mobile Ads（Admob）插件、其他渠道下载的Admob相关包，先完全删除Assets/GoogleMobileAds目录、Plugins目录下手动放入的Admob相关aar/framework文件，Mediation的Admob适配器会自动拉取对应版本的原生SDK，手动导入的SDK会导致类重复冲突直接崩溃。
  2. 修复AndroidManifest合并冲突：打开Player Settings > Publishing Settings，勾选Custom Main Manifest、Custom Main Gradle Template后重新触发构建，查看控制台的manifest merge报错，重点修复Android 12+要求的android:exported属性缺失、provider节点重复、权限声明冲突的问题，这类配置错误会直接导致App启动闪退。
  3. 强制统一依赖版本：如果Force Resolve后依然存在Google Play服务相关库的版本冲突，打开项目的mainTemplate.gradle文件，在android配置块同级加入强制版本规则，所有和Admob相关的依赖版本统一对齐到当前Mediation Admob适配器要求的版本，示例代码：

  configurations.all {
      resolutionStrategy {
          // 版本号替换为当前Admob适配器官方要求的对应版本
          force 'com.google.android.gms:play-services-ads:22.6.0'
          force 'com.google.android.gms:play-services-basement:18.2.0'
      }
  }
  

• IronSource适配器冲突处理注意点
  1. 同样需要先删除项目内手动导入的独立版IronSource SDK，避免类重复。
  2. IronSource适配器默认会拉取多个支持的广告子网络依赖，如果不需要部分子网络，可以在适配器的Dependencies.xml文件中注释掉对应子网络的依赖项，减少冲突概率。
  3. iOS平台如果出现启动崩溃，检查Xcode项目的Other Linker Flags配置，删除重复添加的链接参数，避免重复链接类库报错。
• 最终验证步骤
  1. 所有依赖解析完成后，确认Mediation配置窗口的冲突警告完全消失，不要带警告直接打包。
  2. 编写简单的初始化测试脚本，在Editor Play模式下调用UnityMediation.InitializeAsync传入对应广告单元ID，确认控制台无初始化报错、所有适配器加载成功后，再打真机包测试。

注意：Unity Mediation核心包和各第三方适配器的版本必须严格对应，禁止跨大版本混搭适配器（比如核心包为0.x版本时搭配1.x版本的Admob适配器），这类版本不匹配问题无法被依赖解析工具识别，会直接导致运行时类找不到、方法签名不匹配的崩溃。

内容的提问来源于stack exchange，提问作者lermand7