通过集成 Navigation SDK for Android，您的应用不仅仅是链接到外部地图视图。借助 Google 地图导航，您的应用可以提供关于用户历程数据的动态检索和单一视图报告。本指南介绍了如何运行 Navigation SDK 演示版应用（可在 GitHub 上获取）。
准备工作
如需开始使用 Navigation SDK，请确保具备以下各项。
有权访问以下内容的 Google Maps Platform 代表：
- 为与 Navigation SDK 搭配使用而预配的 API 密钥。您需要提供项目 ID，您可以在 Google Cloud Console 主信息中心的项目名称下找到该 ID。
- SDK 工件。确保您的项目已配置为使用 Maven 作为 Navigation SDK。
- 对于使用 v4.99.0 及更低版本的项目。如果您无法使用 Maven，可以从共享的 Google 云端硬盘下载压缩的工件。该静态库文件是
libs/目录中的 .aar，其中包含 Navigation SDK 作为 AAR 软件包。 - 一个或多个演示版应用。
- Android Studio：使用 Navigation SDK 构建应用的推荐开发环境。
本文档面向熟悉 Android 开发和面向对象编程概念的人员。此外，您还应该从用户的角度熟悉 Google 地图。
下载演示版应用
Google 提供了两个应用，可帮助您了解 Navigation SDK 在 Google Maps API 的基础上提供了哪些功能，具体取决于您的经验水平。熟悉 Google Maps API 的开发者可以将注意力集中在 GoogleNavigation 演示上。刚接触这两个项目的开发者会发现这两个应用都很有用。
从 Navigation SDK for Android v4.1 开始，您可以在 GitHub 上下载以下演示版应用。
GoogleNavigation 演示：展示在引导式导航会话中与用户的体验集成的 API 行为和视图。
GoogleMap 演示：展示了
GoogleMap界面的各种行为，用于自定义地图的外观和呈现方式。
关于使用 Maven 的注意事项
演示版应用配置为使用 Gradle 中的 Artifact Registry 插件从远程 Maven 制品库下载 SDK 工件。请务必按照项目配置说明操作，以获取对该 SDK 的访问权限。
GoogleNavigation 演示
GitHub 上提供了最新的 GoogleNavigation 演示。
构建
在 Android Studio 中，导入演示版应用并允许 Gradle 运行。
打开
local.defaults.properties并更新MAPS_API_KEY属性的值：MAPS_API_KEY=YOUR_API_KEY点击 build 并检查 SDK 实现详情。
在 Java 类中，记下实现代码。
在布局 XML 中，请注意布局设计和文本。
在
build.gradle文件中，记下依赖项中的 SDK。
如需详细了解如何将 API 密钥添加到清单中，请参阅 Secrets Gradle 插件文档。
正在运行
将 Android 设备连接到您的计算机或使用模拟器。
- Android 设备 - 请参阅相关instructions，在您的 Android 设备上启用开发者选项，并配置您的系统，使之检测该设备。
- Emulatormdash; 使用 Android 虚拟设备 (AVD) 管理器配置虚拟设备。选择模拟器时，请务必选择一个包含 Google API 的映像。
在 Android Studio 中，点击 Run 菜单选项（或 Play 按钮图标），然后选择部署目标。
构建和启动时，应用会向用户显示一个包含选项列表的着陆页。
NavViewActivity 和 NavFragmentActivity 选项
NavSDK 的新采用者可能会发现这两个选项最有用。
选项 1：NavViewActivity 展示了将 NavigationView 与 Navigator 结合使用的行为。
选项 2：第二个选项名为 NavFragmentActivity，展示了使用 SupportNavigationFragment 和 Navigator 的行为。
点击其中某个选项后，您将看到以下内容：
- 导航界面
- 应用菜单中的“Set Destination”按钮
- 一个叠加层，您可以与之互动，从而动态调用 API 上的方法
- 包含更多选项的菜单
首先，请点击设置目的地，然后选择一个地址。然后，该应用会模拟从您当前所在位置到该地址的行程。您可以通过控制台叠加层查看调用 API 时会发生什么情况。例如，您可以点击 View Methods，尝试将 SDK 强制进入夜间模式，以查看具体效果。
SwappingMapAndNavActivity 选项
SwappingMapAndNavActivity 展示了以下常见模式：
- 显示
MapView - 在导航开始时切换到
NavigationView - 在导航结束时返回
MapView
GoogleMap 演示
GitHub 上提供了最新的 GoogleNavigation 演示。
构建
在 Android Studio 中，导入演示版应用并允许 Gradle 运行。
打开
local.defaults.properties并更新MAPS_API_KEY属性的值：MAPS_API_KEY=YOUR_API_KEY点击 build 并检查 SDK 实现详情。
在 Java 类中，记下实现代码。
在布局 XML 中，请注意布局设计和文本。
在
build.gradle文件中，记下依赖项中的 SDK。
如需详细了解如何将 API 密钥添加到清单中，请参阅 Secrets Gradle 插件。
正在运行
将 Android 设备连接到您的计算机或使用模拟器。
- Android 设备：请参阅相关instructions，在您的 Android 设备上启用开发者选项并配置您的系统，使之检测该设备。
- 模拟器：使用 Android 虚拟设备 (AVD) 管理器配置虚拟设备。选择模拟器时，请务必选择一个包含 Google API 的映像。
在 Android Studio 中，点击 Run 菜单选项（或 Play 按钮图标），然后选择部署目标。
构建和启动后，应用会向用户显示包含演示列表的着陆页。
Google Maps SDK 演示版用户应熟悉此呈现模式和源代码的相应结构。这是因为 GoogleMap 演示版在设计上与 Maps API 演示版应用类似。主要区别在于：Navigation SDK 演示版允许用户选择要在哪个视图类上测试演示版：NavigationView 或 MapView（如果适用）。
Google 通常鼓励采用者使用 NavigationView。此演示模式让您可以灵活地在我们的演示版应用的两个版本中试用这些行为，并选择适合您的任何一种。例如，如果您使用的第三方库预计会与该类进行交互，那么可能仍需要使用 MapView。