Bắt đầu

Bằng cách tích hợp SDK điều hướng cho Android, ứng dụng của bạn có thể vượt ra ngoài việc liên kết với một chế độ xem bản đồ bên ngoài. Với tính năng đi theo chỉ dẫn của Google Maps, ứng dụng của bạn có thể cung cấp tính năng truy xuất động và báo cáo dữ liệu một lần về hành trình của người lái xe.

Hướng dẫn này cho bạn biết một dự án Android Studio, cách tích hợp SDK điều hướng và chạy ứng dụng minh hoạ được cung cấp cùng với SDK.

SDK điều hướng là một thư viện tĩnh (.aar) cho phép bạn kiểm soát giao diện và âm thanh khi điều hướng trong ứng dụng. Để biết thông tin chi tiết về thư viện, hãy mở Tài liệu tham khảo về SDK điều hướng (Javadoc) trong một cửa sổ riêng.

Chuẩn bị

Để bắt đầu sử dụng SDK điều hướng cho Android, hãy đảm bảo bạn có các mục sau:

  • Người đại diện của Nền tảng Google Maps để có quyền truy cập vào các thông tin sau:

    • Khoá API được cấp phép để sử dụng với SDK điều hướng. Bạn cần cung cấp mã dự án bên dưới tên dự án trong trang tổng quan chính của Google Cloud Console.

    • Tệp zip chứa:

      • Tệp thư viện tĩnh .aar trong thư mục libs/ chứa SDK điều hướng dưới dạng gói aar.
      • Tệp văn bản liên quan đến việc cấp phép và đường liên kết đến Điều khoản sử dụng và thoả thuận.
      • Ứng dụng minh hoạ để nhập dưới dạng dự án mới trong Android Studio. Các tệp của ứng dụng để tạo ứng dụng minh hoạ trong Android Studio bằng Gradle và Maven.

  • Android Studio, môi trường phát triển được đề xuất để tạo ứng dụng bằng SDK điều hướng. Tài liệu này dành cho những người đã làm quen với các khái niệm về lập trình hướng đối tượng và phát triển Android. Bạn cũng phải làm quen với Google Maps từ góc nhìn của người dùng.

Tải SDK, ứng dụng minh hoạ và tài liệu

Sau khi tải xuống và giải nén tệp SDK, bạn có thể kiểm tra và chạy ứng dụng minh hoạ.

Ứng dụng minh hoạ cung cấp một bản dựng triển khai lớp NavigationFragment và một biến thể triển khai lớp NavigationView. Biến thể NavigationFragment chạy theo mặc định và hiển thị một đường dẫn điều hướng như trong hình sau.

  1. Bằng cách sử dụng trình quản lý tệp bạn yêu thích, hãy chuyển đến thư mục có tệp SDK.

  2. Sao chép thư viện SDK điều hướng vào thư mục app/libs của dự án demo:

    Ví dụ: bạn có thể chạy cp libs/*.aar demo/app/libs trong thiết bị đầu cuối Linux.

  3. Trong Android Studio, hãy nhập ứng dụng minh hoạ và cho phép Gradle chạy.

  4. Mở AndroidManifest.xml của ứng dụng rồi cập nhật giá trị của thuộc tính 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. Nhấp vào bản dựng rồi kiểm tra thông tin chi tiết về phương thức triển khai SDK.

    • Trong lớp java, hãy ghi lại mã triển khai.

    • Trong tệp xml bố cục, hãy ghi chú thiết kế bố cục và văn bản.

    • Trong tệp build.gradle, hãy ghi chú SDK trong phần phụ thuộc.

Chạy ứng dụng

  1. Kết nối thiết bị Android với máy tính hoặc dùng một trình mô phỏng.

    • Thiết bị Android Hãy tham khảo instructions để bật các tuỳ chọn cho nhà phát triển trên thiết bị Android và định cấu hình hệ thống để phát hiện thiết bị.
    • Trình mô phỏng Sử dụng Trình quản lý thiết bị Android ảo (AVD) để định cấu hình thiết bị ảo. Khi chọn một trình mô phỏng, hãy nhớ chọn một hình ảnh chứa các API của Google.

  2. Trong Android Studio, hãy nhấp vào tuỳ chọn trình đơn Run (Chạy) (hoặc biểu tượng nút phát); sau đó chọn mục tiêu triển khai.

  3. Trong ứng dụng Navigation Demo (Bản minh hoạ điều hướng), hãy chọn Set Destination (Đặt đích đến), sau đó làm theo lời nhắc để chọn một vị trí và bắt đầu quy trình chỉ đường được mô phỏng.

Tạo biến thể khung hiển thị

Ứng dụng minh hoạ bao gồm một biến thể của Khung hiển thị.

  1. Trong Android Studio, hãy mở ứng dụng minh hoạ và nhấp vào thẻ Build Variants (Biến thể bản dựng) của cửa sổ Build (Bản dựng).

  2. Trong cửa sổ Build Variants (Biến thể bản dựng), hãy chọn viewDebug và thay đổi danh sách tệp.

  3. Kiểm tra thông tin triển khai SDK cho lớp NavigationView.

    • Trong NavViewActivity.java, hãy ghi lại mã triển khai.

    • Trong Activity_Nav_View.xml, hãy chú ý đến thiết kế bố cục và văn bản.

  4. Tạo và chạy ứng dụng. Tên ứng dụng sẽ thay đổi để cho biết phiên bản nào được tạo. Nếu không, chỉ có đối tượng kết xuất là khác.

Bước tiếp theo

Tích hợp SDK điều hướng cho Android vào ứng dụng của riêng bạn.