开始使用

通过集成 Navigation SDK for Android，您的应用不仅可以链接到外部地图视图，借助 Google 地图导航，您的应用可以提供关于驾驶员行程数据的动态检索和一次性报告。

本指南将向您介绍 Android Studio 项目、如何集成 Navigation SDK，以及如何运行 SDK 随附的演示版应用。

Navigation SDK 是一个静态库 (.aar)，可让您控制应用中导航的外观和音频。如需详细了解该库，请在单独的窗口中打开 Navigation SDK 参考文档 (Javadoc)。

准备工作

如需开始使用 Navigation SDK for Android，请务必具备以下几项：

  • Google Maps Platform 代表，申请以下服务：

    • 已配置用于 Navigation SDK 的 API 密钥。您需要提供 projectID，您可以在 Google Cloud 控制台主信息中心内的项目名称下找到该 ID。

    • 此 ZIP 文件包含：

      • 静态库文件 .aar（位于 libs/ 目录中，包含 Navigation SDK 作为 aar 软件包）。
      • 用于许可及指向使用条款和协议的链接的文本文件。
      • 一个演示版应用，用于在 Android Studio 中作为新项目导入。用于使用 Gradle 和 Maven 在 Android Studio 中构建演示版应用的应用文件。

  • Android Studio，它是使用 Navigation SDK 构建应用的推荐开发环境。本文档适用于熟悉 Android 开发和面向对象编程概念的人员。此外，您还应该从用户的角度熟悉 Google 地图。

获取 SDK、演示版应用和文档

下载并解压缩 SDK 文件后，您可以检查并运行演示版应用。

该演示版应用提供了一个实现 NavigationFragment 类的 build 和一个实现 NavigationView 类的变体。NavigationFragment 变体默认运行，并显示下图所示的导航路径。

  1. 使用您喜爱的文件管理器，转到 SDK 文件所在的目录。

  2. 将 Navigation SDK 库复制到 demo 项目的 app/libs 目录中：

    例如，您可以在 Linux 终端中运行 cp libs/*.aar demo/app/libs。

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

  4. 打开应用的 AndroidManifest.xml 并更新 API_KEY 属性的值：

    <?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.navigationapidemo" >

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/_AppTheme" >

        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="YOUR_API_KEY"/>
    </application>
</manifest>

  5. 点击 build 并检查 SDK 实现详情。

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

    • 在布局 XML 中，请注意布局设计和文本。

    • 在 build.gradle 文件中，记下依赖项中的 SDK。

运行应用

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

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

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

  3. 在 Navigation Demo 应用中，选择 Set Destination，然后按照提示选择一个位置并启动模拟导航。

构建 View 变体

演示版应用包含 View 变体。

  1. 在 Android Studio 中，打开演示版应用，然后点击“Build”窗口中的“Build Variants”标签页。

  2. 在 Build Variants 窗口中，选择 viewDebug，文件列表会随之更改。

  3. 检查 NavigationView 类的 SDK 实现详情。

    • 在 NavViewActivity.java 中，记下实现代码。

    • 在 Activity_Nav_View.xml 中，请注意布局设计和文本。

  4. 构建并运行应用。应用名称会更改，以指明构建哪个版本。否则，只有呈现对象是不同的。

后续步骤

将 Navigation SDK for Android 集成到您自己的应用中。