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

Bằng cách tích hợp SDK Điều hướng cho Android, ứng dụng của bạn có thể không 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 động và báo cáo dữ liệu đơn lẻ về hành trình của người lái xe.

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

SDK điều hướng là một thư viện tĩnh cho phép bạn kiểm soát giao diện và âm thanh để điều hướng trong ứng dụng. Để biết thông tin chi tiết về thư viện này, 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ị

Lưu ý quan trọng: Kể từ phiên bản 3.0 của SDK Điều hướng cho Android, bạn có thể tải phiên bản mới nhất của SDK Điều hướng cho Android từ kho lưu trữ Maven của chúng tôi. Đây là phương thức ưu tiên để tải SDK. Để biết thêm thông tin, hãy xem phần Thiết lập dự án.

Lưu ý: Quyền truy cập vào SDK điều hướng được kiểm soát thông qua một nhóm không gian làm việc. Để biết thêm thông tin, hãy xem phần Nhận quyền truy cập.

Để bắt đầu sử dụng SDK điều hướng, hãy đảm bảo 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 projectID (mã dự án) bên dưới tên dự án trên trang tổng quan chính của Google Cloud Console.
  • Cấu phần phần mềm SDK. Hãy đảm bảo rằng dự án của bạn được định cấu hình để sử dụng Maven cho SDK điều hướng.
  • Đối với các dự án sử dụng phiên bản 4.99.0 trở xuống. Nếu không thể sử dụng Maven, bạn có thể tải cấu phần phần mềm đã nén xuống từ Google Drive dùng chung. Tệp thư viện tĩnh là tệp .aar trong thư mục libs/ chứa SDK Điều hướng dưới dạng gói AAR.
  • Một hoặc nhiều ứng dụng minh hoạ.

• 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 đã quen với khái niệm phát triển Android và lập trình hướng đối tượng. Bạn cũng nên quen thuộc với Google Maps từ quan điểm của người dùng.

Tải ứng dụng minh hoạ

Google cung cấp 2 ứng dụng để giúp bạn nắm được những tính năng mà SDK Điều hướng cung cấp ngoài API Google Maps, tuỳ thuộc vào mức độ trải 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. Những nhà phát triển chưa quen thuộc với cả hai dự án này sẽ thấy cả hai ứng dụng đều hữu ích.

Kể từ SDK Điều hướng dành cho Android phiên bản 4.1, các ứng dụng minh hoạ sau đây đều có trong Google Drive dùng chung để tải xuống.

• Bản minh hoạ GoogleNavigation: Trình bày sự tích hợp các hành vi và chế độ xem API liên quan đến trải nghiệm của người dùng trong phiên chỉ đường có hướng dẫn.

• Bản minh hoạ của GoogleMap: trình bày từng hành vi của giao diện GoogleMap để tuỳ chỉnh cảm quan và cách trình bày bản đồ.

Lưu ý khi sử dụng Maven

Các ứng dụng minh hoạ được định cấu hình để tải cấu phần phần mềm SDK xuống từ kho lưu trữ Maven từ xa bằng cách sử dụng trình bổ trợ Artifact Registry trong Gradle. Hãy nhớ làm theo hướng dẫn cấu hình dự án để có quyền truy cập vào SDK.

Lưu ý: Đối với các phiên bản 4.99.0 trở xuống, nếu vẫn muốn sử dụng gói AAR thô trong dự án của mình, bạn có thể thêm gói đó vào dự án trong thư mục libs. Sau đó, bạn cần xoá mọi tệp tham chiếu đến trình bổ trợ artifactregistry và kho lưu trữ từ xa tương ứng, đồng thời khai báo phần phụ thuộc AAR sau đây trong build.gradle cấp ứng dụng: api(name: 'google_navigation', ext: 'aar')

Bản minh hoạ GoogleNavigation

Bản minh hoạ GoogleNavigation mới nhất có sẵn tại thư mục gốc của Google Drive dùng chung. Các phiên bản trước của ứng dụng tồn tại trong thư mục "Lưu trữ". Đối với các phiên bản trước 4.1, ứng dụng này sẽ được đóng gói cùng với AAR trong cùng một tệp zip.

Tòa nhà

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

   Lưu ý: Ứng dụng không tải được bản đồ cho đến khi bạn cập nhật local.defaults.properties bằng khoá API đã cấp phép.

2. Mở local.defaults.properties rồi 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 bản dựng và kiểm tra thông tin chi tiết về quá trình triển khai SDK.

   • Trong lớp Java, hãy lưu ý đến 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 ý đến SDK trong các phần phụ thuộc.

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

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 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 của bạn để phát hiện thiết bị.
   • Trình mô phỏngmdash;Sử dụng Trình quản lý thiết bị ảo Android (AVD) để định cấu hình một thiết bị ảo. Khi chọn một trình mô phỏng, hãy nhớ chọn một hình ảnh có 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ộ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 lựa chọn.

Các tuỳ chọn NavViewActivity và NavFragmentActivity

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

Tuỳ chọn 1: NavViewActivity hiển thị các hành vi bằng cách sử dụng NavigationView cùng với Navigator.

Tuỳ chọn 2: Tuỳ chọn thứ hai có tiêu đề NavFragmentActivity, hiển thị các hành vi bằng cách sử dụng SupportNavigationFragment cùng với Navigator.

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

• giao diện người dùng điều hướng
• nút "Đặt điểm đế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 các phương thức một cách linh động trên API
• một trình đơn mục bổ sung có nhiều tuỳ chọn hơn

Để bắt đầu, hãy nhấp vào Đặt điểm đến và chọn một địa chỉ. Sau đó, ứng dụng sẽ mô phỏng 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ì sẽ xảy ra khi bạn gọi API. Ví dụ: bạn có thể nhấp vào View Methods (Phương thức xem) để thử buộc SDK chuyển sang chế độ ban đêm để xem giao diện của SDK đó.

Tuỳ chọn SwappingMapAndNavActivity

Lưu ý: Lựa chọn này hỗ trợ bạn chuyển đổi từ phiên bản 1 sang phiên bản 4. Nếu có thể, bạn chỉ nên sử dụng NavigationView. Tuy nhiên, hãy lấy ví dụ này làm ví dụ về cách sử dụng kết hợp cả hai.

SwappingMapAndNavActivity cho thấy các mẫu phổ biến sau đây:

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

Bản minh hoạ GoogleMap

Lưu ý: Bạn không dùng được ứng dụng này trên các phiên bản SDK trước phiên bản 4.1.

Bản minh hoạ GoogleNavigation mới nhất hiện đã có tại thư mục gốc của Google Drive dùng chung. Các phiên bản trước của ứng dụng tồn tại trong thư mục "Lưu trữ".

Tòa nhà

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

   Lưu ý: Ứng dụng sẽ không tải được bản đồ cho đến khi bạn cập nhật local.defaults.properties bằng khoá API được cấp phép.

2. Mở local.defaults.properties rồi 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 bản dựng và kiểm tra thông tin chi tiết về quá trình triển khai SDK.

   • Trong lớp Java, hãy lưu ý đến 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 ý đến SDK trong các phần phụ thuộc.

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

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 instructions để 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 một trình mô phỏng, hãy nhớ chọn một hình ảnh có 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ộ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 bản minh hoạ.

Mẫu trình bày này và cấu trúc tương ứng của mã nguồn nên quen thuộc với người dùng bản minh hoạ SDK Google Maps. Đ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 khung hiển thị mà họ muốn chạy thử bản minh hoạ trên: NavigationView hoặc MapView (nếu có).

Google thường khuyến khích người sử dụng sử dụng NavigationView. Bản minh hoạ này cho phép bạn linh hoạt thử những hành vi này trên cả hai phiên bản trong ứng dụng minh hoạ và chọn cách phù hợp với mình. Ví dụ: bạn vẫn cần phải sử dụng MapView trong trường hợp bạn đang sử dụng thư viện bên thứ ba có khả năng tương tác với lớp đó.

Lưu ý quan trọng: Các lớp MapView, MapFragment và SupportMapFragment yêu cầu thiết bị phải cài đặt ứng dụng Dịch vụ Google Play. Nếu bạn khởi động một trình mô phỏng mới hoặc đặt lại một thiết bị rất cũ về trạng thái ban đầu, thì hình ảnh Android có thể đã được cài đặt sẵn Dịch vụ Google Play đã rất lỗi thời. Trong những trường hợp như vậy, bạn sẽ phải đợi ứng dụng tự động lấy phiên bản mới hơn hoặc cập nhật Dịch vụ Play theo cách thủ công thông qua Cửa hàng Google Play.