本指南适用于将抢先体验版 Google 移动广告 Android SDK 集成到其 Android 应用中的发布商。抢先体验版使用户有机会利用新的 Google 移动广告 SDK 功能,而无需等待下一版本的 Google Play 服务,并具有以下优势:
抢先体验功能在 Google Play 服务 APK 中推出后,它们会自动开始使用 Google Play 服务 APK 中较新的 Google 移动广告 SDK 实现。
已经过全面测试,所满足的发布标准与 Google Maven 制品库或 SDK 管理器中提供的公开 build 相同。
它们是 Google 移动广告 SDK 的完整版本,比精简版 SDK 大,但不受精简版 SDK 的限制。
它们可以在全球使用,而不仅仅是在通过 Google Play 分发的应用中使用。
请按照本页中的步骤设置一个具有抢先体验 Google 移动广告 SDK 的本地 Maven 制品库,并将其作为依赖项引用到您的 Android 应用中。
前提条件
- 使用 Android Studio 3.0 或更高版本
- 以 Android API 级别 16 或更高级别为目标平台
- 客户经理提供的 Google 移动广告 SDK 抢先体验 ZIP 文件
配置自定义 Maven 制品库
下载 Google 移动广告 SDK 抢先体验版本的 ZIP 文件。在项目的顶级目录中创建一个 gma_sdk_repo
文件夹,并将 ZIP 文件的全部内容放置在该文件夹中。您的目录结构应类似于 <project_root_dir>/gma_sdk_repo/com/google/...
。
打开应用的项目级 build.gradle
文件。
allprojects {
repositories {
maven {
url "${project.rootDir}/gma_sdk_repo"
}
google()
jcenter()
}
}
将粗体代码行添加到 allprojects/repositories
部分。此命令会指示 Gradle 在您解析依赖项时刚刚创建的 gma_sdk_repo
文件夹中查找 Maven 制品库。
添加 build 依赖项
如需在项目中使用 Google 移动广告 SDK 的抢先体验 build,您还需要在应用级 build.gradle
文件中将其作为依赖项引用:打开应用级 build.gradle
文件,并将代码段中的粗体代码行添加到 dependencies
部分。
dependencies {
implementation 'com.google.android.gms:play-services-ads:x.y.z'
}
...
依赖项版本(在前面的代码段中由 x.y.z 显示)可通过在抢先体验 Google 移动广告 Android SDK zip 文件未归档内容中的 com/google/android/gms/play-services-ads/
目录下找到显示的最新版本。
解决 Firebase 冲突
如果您将 Firebase 库与移动广告 SDK 结合使用,则可在项目中同时包含 com.google.android.gms:play-services-measurement-api
和 com.google.android.gms:play-services-measurement-sdk-api
依赖项。这两个依赖项的版本必须匹配,但您可能会发现您的移动广告 SDK 抢先体验 build 和当前版本的 Firebase 为这两个依赖项提取了不同的版本。
如需解决此问题,您可以在应用的 build.gradle
文件中将依赖项强制解析为特定版本的 play-services-measurement-sdk-api
库,如下所示:
android {
...
configurations.all {
resolutionStrategy {
force 'com.google.android.gms:play-services-measurement-sdk-api:x.y.z'
}
}
}
...
版本 x.y.z
取决于您的 Firebase 版本。以下是最新 Firebase 版本的正确版本:
firebase-core 版本
|
play-services-measurement-sdk-api 版本
|
---|---|
16.0.7
|
16.3.0
|
16.0.6
|
16.0.4
|
16.0.5
|
16.0.3
|
16.0.4
|
16.0.2
|
如需查找其他 Firebase 版本的正确版本,请为您的应用运行 gradle androidDependencies
,并使用输出的 com.google.android.gms:play-services-measurement-api
依赖项的版本。
现在,您的 Android 应用已准备好使用 Google 移动广告 Android SDK 的抢先体验 build。