安装 Maps SDK for Android v.3.1.0 Beta 版

本指南将向您介绍如何安装 Maps SDK for Android v.3.1.0 Beta 版。准备好后，请了解如何使用这一新功能。

安装 Maps SDK for Android v3.1.0 Beta 版

按照下面的步骤操作，手动将 v3.1.0 Beta 版 Maps SDK for Android 客户端库添加到您的 Android Studio 项目中。

  1. 下载地点静态库（如果您不使用地点，可以跳过此步骤）：

  2. 将 AAR 文件复制到 Android Studio 项目的 app/libs 文件夹中。

    3. 您可以通过 Google 的 Maven 代码库获取 Maps SDK for Android 库。要将 SDK 添加到您的应用中，请执行以下操作：

  3. 确保顶级 build.gradle 文件的 buildscript.repositories 部分中列出了 Google 的 Maven 代码库：

    buildscript {
    repositories {
        google()
        // ...
    }
}

  4. 在应用级 build.gradle 文件的 dependencies 部分中，添加 Maps SDK for Android，也可视需要添加地点静态库及其需要的依赖项：

    dependencies {
  implementation 'com.google.android.libraries.maps:maps:3.1.0-beta'

  // If you are using Places, add all of the dependencies below
  implementation name:'places-maps-sdk-3.1.0-beta', ext:'aar'
  implementation 'com.google.android.gms:play-services-gcm:17.0.0'
  implementation 'com.google.auto.value:auto-value-annotations:1.6.2'
}

  5. 在应用级 build.gradle 文件的 dependencies 部分中，移除先前版本的实现行（大致如下）：

    6. implementation 'com.google.android.gms:play-services-maps:17.0.0'

    如果您使用的是 Google Maps Platform 高级计划，则要移除的实现行如以下某行所示：

    implementation(name:'google-maps-sdk-m4b', ext:'aar')
implementation project(':googlemapssdkm4b_lib')
  6. 同步您的 Gradle 项目。

  7. 转换现有配置。

    • 如果您现有的应用通过 Google Play 服务使用 Maps SDK for Android，请将对 com.google.android.gms.maps 软件包的所有引用均替换为 com.google.android.libraries.maps 软件包（在 Android Studio 中，依次点击 Edit > Replace in Path... 实现此操作）。
    • 如果您现有的应用使用 Google Maps Platform 高级计划，请将对 com.google.android.m4b.maps 软件包的所有引用均替换为 com.google.android.libraries.maps 软件包。此外，请从对 XML 布局属性的所有引用中移除 m4b_ 前缀。例如：m4b_mapType 应变成 mapType，m4b_cameraZoom 应变成 cameraZoom。

  8. 更新 ProGuard 规则，以在发布 build 中启用代码缩减和混淆功能时，让 Maps SDK for Android 中的类保持不变。 

    -keep,allowoptimization class com.google.android.libraries.maps.** { *; }

导入与 Beta 版兼容的实用程序库

如果您使用的是 Google Maps Android API 实用程序库，则还需要更新项目依赖项，将现有版本替换为与 Beta 版兼容的版本，具体操作如下：

  1. 在 build.gradle 文件中导入与 Beta 版兼容的实用程序库：
    implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
  2. 从 build.gradle 中移除以下内容，以便移除与 Beta 版不兼容的实用程序库：
    implementation 'com.google.maps.android:android-maps-utils:1.3.1'

运行示例应用

GitHub 上的 Google Samples 代码库包含相关示例应用，可演示如何使用 v3.1.0 Beta 版 Maps SDK for Android。