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

Nhóm Nền tảng Google Maps thường xuyên cập nhật SDK bằng các tính năng mới, bản sửa lỗi và cải tiế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.

Liên kết đến 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 của phiên bản lớn phiên bản mà bạn đang sử dụng (X.*) và nâng cấp hằng năm lên phiên bản lớn mới.

  Khi bạn 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, các bản sửa lỗi sẽ được cung cấp trong một tương thích ngược trong vòng 12 tháng kể từ khi phát hành phiên bản lớn đầu tiên, theo mỗi Hỗ trợ thiết bị di động . Bạn sẽ không cần phải khẩn trương nâng cấp lên phiên bản SDK không tương thích để 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 tính năng và cải tiến mới nhất khi ứng dụng đã được xây dựng trên đó phiên bản mới nhất.
  • Việc cập nhật tăng dần hằng năm cho phiên bản chính mới nhất của SDK có thể giúp bạn tiết kiệm công sức thích ứng, viết lại và kiểm thử ứng dụng hơn so với việc 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 bất kỳ phiên bản đã sửa lỗi nào. Khi nhận được thông báo ngừng sử dụng cho 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:

  • Giảm tần suất bảo trì.
  • Các phiên bản mới của ứng dụng tiếp tục hỗ trợ người dùng thiết bị chạy hệ điều hành thiết bị di động cũ hơn hệ thống lâu hơn (cho đến khi bạn cần phải nâng cấp lên một 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ọ. Luôn cập nhật về các bản cập nhật lớn, tính năng ngừng hoạt động và các thay đổi khác.

Cài đặt

Trong tệp build.gradle.kts hoặc build.gradle cấp ứng dụng, hãy luôn chỉ định phiên bản thay vì phạm vi tiền tố (+) hoặc latest vì các phạm vi này có thể dẫn đến các bản dựng không thể dự đoán và không thể lặp lại. SDK Địa điểm dành cho Android tuân thủ quy trình 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à 23.

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 tự động kiểm tra để tìm những phiên bản mới hơn và đưa ra cảnh báo khi một có phiên bản mới hơn của phần phụ thuộc. Để giảm thiểu 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 chính 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 về các phiên bản mới hơn, chủ sở hữu dự án trên Google Cloud sẽ 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ề các thay đổi khô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 theo dõi cho mỗi dự án.

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

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

1. Bật Places API (New) (API Địa điểm (Mới)) trên khoá API dùng trong ứng dụng của bạn. Để biết thêm thông tin, hãy xem bài viết Sử dụng khoá API.

2. Trong phần dependencies ở cấp mô-đun Tệp build.gradle, cập nhật phần phụ thuộc places và 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.5.0'
     }

   Để biết thêm thông tin về phần phụ thuộc kotlin-bom, hãy xem nội dung 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.

3. Cập nhật ứng dụng hiện có để gọi hàm mới Places.initializeWithNewPlacesApiEnabled() để khởi chạy ứng dụng của bạn. Để biết thêm thông tin, hãy xem 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 có thể dùng tận dụng tất cả các tính năng mới của SDK.