Maps SDK for Android 实用程序设置

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

前提条件和说明

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

GitHub 上提供了相关参考文档

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

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

dependencies {
    implementation 'com.google.maps.android:android-maps-utils:2.2.3'
}

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

第 2 步:(可选)安装 Maps SDK for Android 实用程序 KTX 库

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

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

dependencies {
    implementation 'com.google.maps.android:maps-utils-ktx:3.2.0'
}

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

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

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

代码库包括:

  • 一个演示版应用,位于 demo 目录中。
  • 实用程序库,位于 library 目录中。
  • Maps SDK v3 Beta 版中的实用程序库,位于 library-v3 目录中。
  • 各类包含许可、贡献者和自述文件信息的文件。
  • Gradle 构建配置,可与 Android Studio 搭配使用。

运行实用程序演示版应用

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

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

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