本指南将向您介绍如何安装 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 项目中。
-
下载地点静态库(如果您不使用地点,可以跳过此步骤):
- places-maps-sdk-3.1.0-beta.aar(可选,只能与 Maps v 3.1.0 Beta 版一起使用)
- 将 AAR 文件复制到 Android Studio 项目的
app/libs
文件夹中。 -
确保顶级
build.gradle
文件的buildscript.repositories
部分中列出了 Google 的 Maven 代码库:buildscript { repositories { google() // ... } }
-
在应用级
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' }
在应用级
build.gradle
文件的dependencies
部分中,移除先前版本的实现行(大致如下):- 同步您的 Gradle 项目。
转换现有配置。
- 如果您现有的应用通过 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
。
- 如果您现有的应用通过 Google Play 服务使用 Maps SDK for Android,请将对
-
更新 ProGuard 规则,以在发布 build 中启用代码缩减和混淆功能时,让 Maps SDK for Android 中的类保持不变。
-keep,allowoptimization class com.google.android.libraries.maps.** { *; }
您可以通过 Google 的 Maven 代码库获取 Maps SDK for Android 库。要将 SDK 添加到您的应用中,请执行以下操作:
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')
导入与 Beta 版兼容的实用程序库
如果您使用的是 Google Maps Android API 实用程序库,则还需要更新项目依赖项,将现有版本替换为与 Beta 版兼容的版本,具体操作如下:
- 在
build.gradle
文件中导入与 Beta 版兼容的实用程序库:implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
- 从
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。
- Maps SDK for Android 示例应用
- Places SDK for Android 示例应用(仅可与 Maps v3.1.0 Beta 版一起使用)