体验演示版

通过集成 Navigation SDK for Android，您的应用不仅可以关联到外部地图视图，借助 Google 地图导航，您的应用可以动态检索用户历程数据，并提供一目了然的报告。本指南介绍了如何运行 GitHub 上提供的 Navigation SDK 演示版应用。

准备工作

如需开始使用 Navigation SDK，请务必拥有以下内容。

• 预配用于与 Navigation SDK 搭配使用的 API 密钥。 如需详细了解如何创建和限制密钥，请参阅使用 API 密钥。
• SDK 工件。确保您的项目已配置为 Navigation SDK 使用 Maven。
• 一个或多个演示版应用。
• Android Studio，使用 Navigation SDK 构建应用的推荐开发环境。

本文档适用于熟悉 Android 开发和面向对象编程概念的人员。此外，您还应从用户的角度熟悉 Google 地图。

注意： 如果您的应用已在使用 Maps SDK，则 Navigation SDK 会取代 Maps SDK 来处理地图图层和导航地图项。您不能在同一应用中使用 Navigation SDK 和 Maps SDK。

获取演示版应用

Google 提供了两个应用，可帮助您根据自己的经验水平，了解 Navigation SDK 在 Google Maps API 之上提供的功能。熟悉 Google Maps API 的开发者可以重点关注 GoogleNavigation 演示。对这两个项目都很陌生的开发者会发现这两个应用都很有用。

从 Navigation SDK for Android v4.1 开始，您可以在 GitHub 上下载以下两个演示版应用。

• GoogleNavigation 演示：展示了 API 行为和视图的集成，以及这些集成与引导式导航会话中的用户体验相关联。

• GoogleMap 演示：展示 GoogleMap 界面的各项行为，以自定义地图的外观和呈现方式。

GoogleNavigation 演示

最新的 GoogleNavigation 演示版可在 GitHub 上找到。

建筑物

1. 在 Android Studio 中，导入演示版应用并允许 Gradle 运行。

   注意 ：在您使用预配的 API 密钥更新 local.defaults.properties 之前，应用将无法加载地图。

2. 打开 local.defaults.properties 并更新 MAPS_API_KEY 属性的值：

     MAPS_API_KEY=YOUR_API_KEY
   

3. 点击构建，然后检查 SDK 实现详情。

   • 在 Java 类中，记下实现代码。

   • 在布局 XML 中，记下布局设计和文本。

   • 在 build.gradle 文件中，请注意依赖项中的 SDK。

如需详细了解如何将 API 密钥添加到清单，请参阅 Secrets Gradle 插件文档。

正在运行

1. 将 Android 设备连接到计算机或使用模拟器。

   • Android 设备 - 请参阅说明，在 Android 设备上启用开发者选项，并配置您的系统以检测设备。
   • 模拟器 - 使用 Android 虚拟设备 (AVD) 管理器配置虚拟设备。选择模拟器时，请务必选择一个包含 Google API 的映像。

2. 在 Android Studio 中，点击 Run 菜单选项（或 play 按钮图标），然后选择部署目标。

构建并启动后，应用会向用户显示包含选项列表的着陆页。

NavViewActivity 和 NavFragmentActivity 选项

刚开始使用 NavSDK 的开发者可能会发现这两个选项最实用。

方法 1：NavViewActivity 结合使用 NavigationView 和 Navigator 来展示行为。

方法 2：第二个选项名为 NavFragmentActivity，用于展示使用 SupportNavigationFragment 和 Navigator 的行为。

注意 ：在大多数情况下，我们建议使用 SupportNavigationFragment（NavigationView 的封装容器），而不是直接与 NavigationView 交互。如需了解详情，请参阅导航地图互动最佳实践 。

点击其中一个选项后，您会看到以下内容：

• 导航界面
• 应用菜单中的“设置目的地”按钮
• 可与之互动的叠加层，用于动态调用 API 的方法
• 包含更多选项的菜单

首先，点击设置目的地，然后选择一个地址。然后，应用会模拟从您当前位置到该地址的路线。使用控制面板叠加层查看调用 API 时会发生什么情况。例如，您可以点击查看方法，尝试强制将 SDK 切换到夜间模式，以查看其外观。

SwappingMapAndNavActivity 选项

注意 ：此选项可帮助您从 v1 过渡到 v4。我们建议您尽可能仅使用 NavigationView，但提供了此示例，以便您了解如何将这两者搭配使用。

SwappingMapAndNavActivity 展示了以下常见模式：

• 显示 MapView
• 在导航开始时切换到 NavigationView
• 导航结束时返回 MapView

GoogleMap 演示

最新的 GoogleNavigation 演示版可在 GitHub 上找到。

注意： 如需详细了解如何与应用中的 GoogleMap 对象互动，请参阅 GoogleMap 互动最佳实践。

建筑物

1. 在 Android Studio 中，导入演示版应用并允许 Gradle 运行。

   注意 ：在您使用预配的 API 密钥更新 local.defaults.properties 之前，应用将无法加载地图。

2. 打开 local.defaults.properties 并更新 MAPS_API_KEY 属性的值：

     MAPS_API_KEY=YOUR_API_KEY
   

3. 点击构建，然后检查 SDK 实现详情。

   • 在 Java 类中，记下实现代码。

   • 在布局 XML 中，记下布局设计和文本。

   • 在 build.gradle 文件中，请注意依赖项中的 SDK。

如需详细了解如何将 API 密钥添加到清单，请参阅 Secrets Gradle 插件。

正在运行

1. 将 Android 设备连接到计算机或使用模拟器。

   • Android 设备：请参阅说明，在 Android 设备上启用开发者选项，并配置您的系统以检测设备。
   • 模拟器：使用 Android 虚拟设备 (AVD) 管理器配置虚拟设备。选择模拟器时，请务必选择一个包含 Google API 的映像。

2. 在 Android Studio 中，点击 Run 菜单选项（或 play 按钮图标），然后选择部署目标。

构建并启动后，应用会向用户显示包含演示列表的着陆页。

Google Maps SDK 演示版的用户应该熟悉这种呈现模式和相应的源代码结构。这是因为 GoogleMap 演示版的设计与 Maps API 演示版应用类似。主要区别在于，Navigation SDK 演示版允许用户选择要在哪个视图类上测试运行演示版：NavigationView 或 MapView（如果适用）。

Google 通常建议采用者使用 NavigationView。借助此演示，您可以灵活地在演示应用的两个版本中试用这些行为，然后选择最适合您的行为。例如，在您使用预期与该类交互的第三方库的情况下，可能仍需要使用 MapView。

重要提示： MapView、MapFragment 和 SupportMapFragment 类要求设备安装 Google Play 服务应用。如果您启动全新模拟器，或将旧款设备恢复出厂设置，Android 映像可能预安装了过时的 Google Play 服务。在这种情况下，您必须等待系统自动拉取较新版本，或通过 Google Play 商店手动更新 Play 服务。