Dùng thử bản trình diễn

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

Chuẩn bị

Để bắt đầu sử dụng SDK Điều hướng, hãy nhớ có các mục sau.

Tài liệu này dành cho những người đã quen thuộc với việc phát triển Android và các khái niệm lập trình hướng đối tượng. Bạn cũng cần phải hiểu rõ Google Maps từ góc độ người dùng.

Tải ứng dụng minh hoạ

Google cung cấp hai ứng dụng để giúp bạn hiểu được những gì mà SDK chỉ đường cung cấp ngoài các API Google Maps, tuỳ thuộc vào mức độ kinh nghiệm của bạn. Các nhà phát triển quen thuộc với API Google Maps có thể tập trung vào bản minh hoạ GoogleNavigation. Các nhà phát triển mới làm quen với cả hai dự án này sẽ thấy cả hai ứng dụng đều hữu ích.

Kể từ Navigation SDK cho Android phiên bản 4.1, bạn có thể tải cả hai ứng dụng minh hoạ sau đây xuống từ GitHub.

  • Bản minh hoạ GoogleNavigation: Giới thiệu việc tích hợp các hành vi và thành phần hiển thị API liên quan đến trải nghiệm của người dùng trong một phiên điều hướng có hướng dẫn.

  • Bản minh hoạ GoogleMap: giới thiệu các hành vi riêng lẻ của giao diện GoogleMap để tuỳ chỉnh giao diện và cách trình bày bản đồ.

Bản minh hoạ GoogleNavigation

Bạn có thể xem bản minh hoạ GoogleNavigation mới nhất trên GitHub.

Tòa nhà

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

  2. Mở local.defaults.properties và cập nhật giá trị của thuộc tính MAPS_API_KEY:

      MAPS_API_KEY=YOUR_API_KEY

  3. Nhấp vào build (xây dựng) rồi kiểm tra thông tin chi tiết về việc triển khai SDK.

    • Trong lớp Java, hãy lưu ý mã triển khai.

    • Trong tệp XML bố cục, hãy lưu ý đến thiết kế bố cục và văn bản.

    • Trong tệp build.gradle, hãy lưu ý SDK trong phần phụ thuộc.

Hãy xem tài liệu về Trình bổ trợ Gradle cho khoá bí mật để biết thêm thông tin về cách thêm khoá API vào tệp kê khai.

Đang chạy

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

    • Thiết bị Android – Hãy tham khảo hướng dẫn để bật 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ị ảo Android (AVD) để định cấu hình thiết bị ảo. Khi chọn trình mô phỏng, hãy đảm bảo bạn chọn một hình ảnh có chứa 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ột mục tiêu triển khai.

Khi được tạo và khởi chạy, ứng dụng sẽ hiển thị cho người dùng một trang đích có danh sách các tuỳ chọn.

Những người mới sử dụng NavSDK có thể sẽ thấy hai tuỳ chọn này hữu ích nhất.

Cách 1: NavViewActivity giới thiệu các hành vi bằng cách sử dụng NavigationView cùng với Navigator.

Cách 2: Cách thứ hai, có tiêu đề NavFragmentActivity, giới thiệu các hành vi sử dụng SupportNavigationFragment cùng với Navigator.

Khi nhấp vào một trong các lựa chọn này, bạn sẽ thấy:

  • giao diện người dùng điều hướng
  • nút "Set Destination" (Đặt đích đến) trong trình đơn của ứng dụng
  • một lớp phủ mà bạn có thể tương tác để gọi linh động các phương thức trên API
  • trình đơn mục bổ sung có nhiều tuỳ chọn hơn

Để bắt đầu, hãy nhấp vào Set Destination (Đặt đích đến) rồi chọn một địa chỉ. Sau đó, ứng dụng sẽ mô phỏng một chuyến đi từ vị trí hiện tại của bạn đến địa chỉ đó. Sử dụng lớp phủ bảng điều khiển để xem điều gì xảy ra khi bạn gọi một API. Ví dụ: bạn có thể nhấp vào View Methods (Xem phương thức) để thử buộc SDK chuyển sang chế độ ban đêm và xem giao diện của chế độ này.

Tuỳ chọn SwappingMapAndNavActivity

SwappingMapAndNavActivity giới thiệu các mẫu phổ biến sau:

  • hiển thị MapView
  • hoán đổi sang NavigationView khi bắt đầu điều hướng
  • quay lại MapView khi quá trình điều hướng kết thúc

Bản minh hoạ GoogleMap

Bạn có thể xem bản minh hoạ GoogleNavigation mới nhất trên GitHub.

Tòa nhà

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

  2. Mở local.defaults.properties và cập nhật giá trị của thuộc tính MAPS_API_KEY:

      MAPS_API_KEY=YOUR_API_KEY

  3. Nhấp vào build (xây dựng) rồi kiểm tra thông tin chi tiết về việc triển khai SDK.

    • Trong lớp Java, hãy lưu ý mã triển khai.

    • Trong tệp XML bố cục, hãy lưu ý đến thiết kế bố cục và văn bản.

    • Trong tệp build.gradle, hãy lưu ý SDK trong phần phụ thuộc.

Hãy xem trình bổ trợ gradle secrets để biết thêm thông tin về cách thêm khoá API vào Tệp kê khai.

Đang chạy

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

    • Thiết bị Android Hãy tham khảo hướng dẫn để bật 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 trình mô phỏng, hãy đảm bảo bạn chọn một hình ảnh có chứa 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ột mục tiêu triển khai.

Khi được tạo và khởi chạy, ứng dụng sẽ hiển thị cho người dùng một trang đích chứa danh sách các bản minh hoạ.

Người dùng các bản minh hoạ SDK Google Maps sẽ quen thuộc với mẫu trình bày này và cấu trúc tương ứng của mã nguồn. Điều này là do bản minh hoạ GoogleMap được thiết kế tương tự như ứng dụng minh hoạ API Maps. Điểm khác biệt chính là bản minh hoạ SDK Điều hướng cho phép người dùng chọn lớp thành phần hiển thị mà họ muốn chạy thử bản minh hoạ: NavigationView hoặc MapView (nếu có).

Nhìn chung, Google khuyến khích những người sử dụng sử dụng NavigationView. Bản minh hoạ này giúp bạn linh hoạt thử các hành vi này trên cả hai phiên bản trong ứng dụng minh hoạ của chúng tôi và chọn bất kỳ hành vi nào phù hợp với bạn. Ví dụ: bạn vẫn có thể cần sử dụng MapView trong trường hợp đang sử dụng thư viện của bên thứ ba dự kiến sẽ tương tác với lớp đó.