要设置和配置 Google Cloud 控制台,以便将使用方 SDK 用于 Android 设备,请按以下步骤操作。
如需详细了解每个步骤,请参阅以下部分。
设置您的开发项目
如果您没有 Google Cloud 控制台开发项目和 移动项目,则需要先设置一个。有关详情,请参阅 在 Fleet Engine 指南中创建项目。
在为使用方 SDK 选择开发项目时,请选择 您用于 Fleet Engine 的 Google Cloud 控制台项目和 API 密钥。
将消费者 SDK 添加到您的应用
消费者 SDK 可通过专用 Maven 制品库获取。仓库 包括 SDK 的项目对象模型 (.pom) 文件和 Javadocs。要将 使用方 SDK 添加到您的应用中,请按以下步骤操作:
按照说明设置您的环境以访问托管 Maven 制品库, 本指南的第 2 步。
将使用方 SDK 和 Maps SDK 依赖项添加到您的 Gradle 或 Maven 配置。
在以下示例中,将
VERSION_NUMBER
替换为所需的 消费者 SDK 版本:Gradle
将以下内容添加到
build.gradle
中:dependencies { ... implementation 'com.google.android.libraries.mapsplatform.transportation:transportation-consumer:VERSION_NUMBER' implementation "com.google.android.gms:play-services-maps:VERSION_NUMBER" }
Maven
将以下内容添加到
pom.xml
中:<dependencies> ... <dependency> <groupId>com.google.android.libraries.mapsplatform.transportation</groupId> <artifactId>transportation-consumer</artifactId> <version>VERSION_NUMBER</version> </dependency> <dependency> <groupId>com.google.android.gms</groupId> <artifactId>play-services-maps</artifactId> <version>18.1.0</version> </dependency> </dependencies>
向您的应用添加 API 密钥
将消费者 SDK 添加到应用后,请添加 API 密钥。您必须使用 您在设置开发项目时获取的项目 API 密钥。对于 如需了解详情,请参阅本指南第 3 步中的设置开发项目。
本部分介绍了如何存储 API 密钥,以提高其安全性 由您的应用引用如需详细了解 API 密钥安全最佳实践 请参阅有关 API 安全性最佳实践的 Google Maps Platform 文章。
如需简化此任务,请参阅 GitHub 文档 Secrets Gradle 适用于 Android 的插件。
如需安装此插件并存储您的 API 密钥,请执行以下操作:
打开根级
build.gradle
文件,并将以下代码添加到buildscript
下的dependencies
元素。Groovy
buildscript { dependencies { // ... classpath "com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0" } }
Kotlin
buildscript { dependencies { // ... classpath("com.google.android.libraries.mapsplatform.secrets-gradle-plugin:secrets-gradle-plugin:2.0.0") } }
打开应用级
build.gradle
文件,并将以下代码添加到plugins
元素。Groovy
id 'com.google.android.libraries.mapsplatform.secrets-gradle-plugin'
Kotlin
id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
如果您使用 Android Studio,请将项目与 Gradle 同步。有关详情,请参阅 Android 文档中的将项目与 Gradle 同步。
在项目级目录中打开
local.properties
,然后添加 。将YOUR_API_KEY
替换为您的 API 密钥。MAPS_API_KEY=YOUR_API_KEY
在
AndroidManifest.xml
文件中,转到com.google.android.geo.API_KEY
并按如下所示更新android:value
属性:
<meta-data
android:name="com.google.android.geo.API_KEY"
android:value="${MAPS_API_KEY}" />
以下示例展示了示例应用的完整清单:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.consumerapidemo">
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/_AppTheme">
<meta-data
android:name="com.google.android.geo.API_KEY"
android:value="${MAPS_API_KEY}" />
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>
在您的应用中添加必要的提供方说明
如果您在应用中使用消费者 SDK,则必须添加提供方说明文本和 开源许可。最好 将提供方说明作为独立菜单项或关于 。
您可以在“third_party_licenses.txt”中找到许可信息文件 已取消归档的 AAR 文件。
如需了解如何操作,请参阅 https://developers.google.com/android/guides/opensource 包含开源声明。