体验演示版

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

准备工作

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

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

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

获取演示版应用

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

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

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

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

GoogleNavigation 演示

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

建筑物

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

  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 按钮图标），然后选择部署目标。

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

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

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

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

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

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

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

SwappingMapAndNavActivity 选项

SwappingMapAndNavActivity 展示了以下常见模式：

GoogleMap 演示

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

建筑物

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

  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。