Maps SDK for Android 实用程序设置

本页面介绍如何设置 Maps SDK for Android 实用程序库，以及如何运行库中包含的演示版应用。

前提条件和说明

Maps SDK for Android 实用程序库支持 Android API 级别 15 及更高级别。您在设置项目 build 目标时，请务必使用最新的 Android API 级别。

GitHub 上提供了相关参考文档。

第 1 步：安装 Maps SDK for Android 实用程序库

将以下依赖项添加到应用的 build.gradle 文件：

dependencies {


    // Utility Library for Maps SDK for Android
    // You do not need to add a separate dependency for the Maps SDK for Android
    // since this library builds in the compatible version of the Maps SDK.
    implementation 'com.google.maps.android:android-maps-utils:3.8.0'
}

使用库中的某个实用程序，例如标记聚类、热图或其他实用程序。

第 2 步：（可选）安装 Maps SDK for Android 实用程序的 KTX 库

Maps SDK for Android 实用程序库附带了相应的 Kotlin 扩展程序 (KTX) 库。此库提供 Kotlin 语言功能（例如扩展函数、命名参数和默认参数），使您能够编写简洁而规范的 Kotlin 代码。如果您不使用 Kotlin 进行开发，则可以跳过此步骤。

要使用此库，除了 android-maps-utils 依赖项之外，还应将以下依赖项添加到应用的 build.gradle 文件中：

dependencies {

    // KTX for the Maps SDK for Android Utility Library
    implementation 'com.google.maps.android:maps-utils-ktx:5.1.1'
}

如需详细了解此库，请访问 Maps KTX GitHub 页面。

第 3 步：查看 Maps SDK for Android 实用程序库的源代码

由于该实用程序库是开源的，因此您可以将 android-maps-utils 库下载到计算机上，以便对其进行自定义、查看演示版应用，或者单纯了解该库的工作原理。您可以通过克隆代码库（建议采用此方式以便接收自动更新）或下载 zip 文件来实现上述目的。如果您想自定义该库，则应复刻该代码库。

该代码库中包含：

• 一个演示版应用，位于 demo 目录中。
• 实用程序库，位于 library 目录中。
• 各类包含许可、贡献者和自述文件信息的文件。
• Gradle build 配置，以用于 Android Studio。

运行实用程序演示版应用

实用程序库的 GitHub 代码库自带一个演示版应用，其中包含每个实用程序的实现代码示例。请按以下步骤在您的 Android 设备上运行演示版应用。

1. 采用上述任一方式下载代码库。
2. 在 Android Studio 中，依次选择 File -> New -> Import Project。
3. 浏览到在您克隆实用程序库时创建的 android-maps-utils 目录，并选中（双击）它。现在，Android Studio 将构建该项目。
4. 如果您使用的是 Android 设备而非模拟器，请务必启用开发者模式。然后将 Android 设备与计算机相连。

5. 向 local.properties 添加一行代码，如下所示：

   MAPS_API_KEY=YOUR_API_KEY

   其中 YOUR_API_KEY 是您按照使用 API 密钥一文中的说明获取的 API 密钥。

6. 构建并运行演示版应用。

此应用应在 Android 设备上打开，显示实用程序列表，包括聚类、polyutil、热图等。您还可以在应用列表中找到该应用，它在列表中的名称是 Maps Utils Demo。