Trang này được dịch bởi Cloud Translation API.

SDK Địa điểm dành cho các phiên bản Android

Chọn nền tảng: Android iOS JavaScript

Nhóm Nền tảng Google Maps thường xuyên cập nhật SDK để bổ sung các tính năng mới, bản sửa lỗi và điểm cải thiện hiệu suất. Trang này cung cấp hướng dẫn về cách quản lý các phần phụ thuộc trên SDK dành cho thiết bị di động.

Bạn muốn liên kết với phiên bản nào?

Đối với các ứng dụng thiết yếu, hãy liên kết đến bản phát hành mới nhất (X.*) của phiên bản lớn mà bạn đang dùng (X.*) rồi nâng cấp lên phiên bản lớn mới hằng năm.

Khi phát hành các phiên bản mới của ứng dụng trong suốt cả năm, bạn có thể bắt đầu sử dụng các phiên bản dấu chấm mới hơn của SDK Địa điểm dành cho Android. Thao tác này sẽ không yêu cầu cập nhật trong ứng dụng của bạn vì các phiên bản dấu chấm mới có khả năng tương thích ngược.

Lợi ích:
- Nếu bạn phát hiện vấn đề trong SDK Địa điểm dành cho Android, thì các bản sửa lỗi sẽ được cung cấp theo cách có khả năng tương thích ngược trong vòng 12 tháng kể từ lần đầu phát hành phiên bản lớn, theo Chính sách hỗ trợ thiết bị di động. Bạn sẽ không cần phải nâng cấp khẩn cấp lên một phiên bản SDK incompatible để hưởng lợi từ các bản sửa lỗi.
- Bạn có thể dễ dàng áp dụng các điểm cải tiến và tính năng mới nhất khi ứng dụng của bạn được xây dựng trên phiên bản mới nhất.
- Các bản cập nhật gia tăng hằng năm lên phiên bản lớn mới nhất của SDK có thể khiến bạn tốn ít công sức hơn để thích ứng, viết lại và kiểm thử ứng dụng thay vì phải xử lý các thay đổi không tương thích ngược được đưa ra trong nhiều bản phát hành phiên bản chính.
Đối với các ứng dụng không quan trọng, hãy liên kết đến một phiên bản đã sửa lỗi bất kỳ. Khi nhận được thông báo về việc ngừng sử dụng phiên bản đã sửa lỗi đó, bạn sẽ có 12 tháng để cung cấp mã ứng dụng đã cập nhật cho người dùng.

Lợi ích:
- Công việc bảo trì ít thường xuyên hơn.
- Các phiên bản mới của ứng dụng sẽ tiếp tục hỗ trợ thiết bị của người dùng chạy hệ điều hành di động cũ trong thời gian dài (cho đến khi bạn cần nâng cấp lên phiên bản SDK mới).

Chủ sở hữu dự án có địa chỉ email được giám sát sẽ nhận được thông báo chủ động về những thay đổi ảnh hưởng đến từng dự án của họ. Nắm bắt thông tin về các bản cập nhật chính, việc ngừng sử dụng và những thay đổi khác.

Cài đặt

Trong tệp build.gradle ở cấp ứng dụng, hãy luôn chỉ định một phiên bản thay vì phạm vi tiền tố (+) hoặc latest vì những phiên bản này có thể dẫn đến các bản dựng không dự đoán được và không thể lặp lại. SDK Địa điểm dành cho Android tuân thủ cách tạo phiên bản ngữ nghĩa và các bản phát hành phiên bản chính mới có thể bao gồm các thay đổi có thể gây lỗi. Cấp độ API tối thiểu được hỗ trợ là 21.

dependencies {
    // If updating kotlin-bom version number above, also edit project-level build.gradle definition of $kotlin_version variable
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
    implementation 'com.google.android.libraries.places:places:3.3.0'
}

Bảo trì và nâng cấp

Android Studio sẽ tự động kiểm tra các phiên bản mới hơn hiện có và đưa ra cảnh báo khi có phiên bản mới hơn của phần phụ thuộc. Để giảm thiểu món nợ kỹ thuật, hãy cập nhật lên phiên bản mới nhất càng sớm càng tốt. Nếu bạn đang cập nhật lên một phiên bản lớn mới, hãy kiểm tra ghi chú phát hành để biết các thay đổi không tương thích ngược và cách cập nhật mã.

Ngoài việc thăm dò ý kiến cho các phiên bản mới hơn, chủ sở hữu dự án Google Cloud còn nhận được email về những thay đổi không tương thích ngược có thể ảnh hưởng đến dự án của họ. Để nhận thông báo chủ động về những thay đổi không có khả năng tương thích ngược, hãy chỉ định vai trò chủ sở hữu bằng một địa chỉ email được giám sát cho từng dự án của bạn.

Nếu bạn đang nâng cấp từ SDK Địa điểm dành cho Android phiên bản 3.2.0 trở xuống

Bạn không cần phải di chuyển khi chuyển sang SDK mới. Bạn chỉ phải:

Bật API Địa điểm (Mới) trên khoá API dùng trong ứng dụng. Để biết thêm thông tin, hãy xem phần Sử dụng khoá API.
Trong mục dependencies của tệp build.gradle cấp mô-đun, hãy cập nhật phần phụ thuộc places rồi thêm phần phụ thuộc kotlin-bom:
```
  dependencies {
      implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
      implementation 'com.google.android.libraries.places:places:3.3.0'
  }
```
Để biết thêm thông tin về phần phụ thuộc kotlin-bom, hãy xem bài viết Cách sử dụng phiên bản kotlin-stdlib mới nhất trong các phần phụ thuộc bắc cầu.
Hãy cập nhật ứng dụng hiện tại để gọi phương thức Places.initializeWithNewPlacesApiEnabled() mới để khởi chạy ứng dụng. Để biết thêm thông tin, hãy xem bài viết Khởi chạy ứng dụng Places API.

Các ứng dụng hiện có của bạn sẽ tiếp tục hoạt động không thay đổi, nhưng bạn hiện có thể tận dụng tất cả tính năng mới của SDK.