安装 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 添加到您的应用中,请执行以下操作:

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

    buildscript {
        repositories {
            google()
            // ...
        }
    }
  5. 应用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'
    }
  6. 在应用级 build.gradle 文件的 dependencies 部分中,移除先前版本的实现行(大致如下):

  7. 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')
    
  8. 同步您的 Gradle 项目。
  9. 转换现有配置。

    • 如果您现有的应用通过 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 应变成 mapTypem4b_cameraZoom 应变成 cameraZoom

导入与 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。