体验演示版

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

准备工作

如需开始使用 Navigation SDK，请确保具备以下各项。

• 预配用于与 Navigation SDK 搭配使用的 API 密钥。 如需详细了解如何创建和限制密钥，请参阅使用 API 密钥。
• SDK 工件。确保您的项目已配置为将 Maven 用于 Navigation SDK。
• 一个或多个演示版应用。
• 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. 点击 build 并检查 SDK 实现详情。

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

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

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

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

正在运行

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

   • Android 设备 - 请参阅相关说明，在您的 Android 设备上启用开发者选项，并配置您的系统，使之检测该设备。
   • Emulatormdash; 使用 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 演示

GitHub 上提供了最新的 GoogleNavigation 演示。

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

建筑物

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

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

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

     MAPS_API_KEY=YOUR_API_KEY
   

3. 点击 build 并检查 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 服务。