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

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ằng các tính năng mới, bản sửa lỗi và 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.

  • Đối với các ứng dụng quan trọng, hãy liên kết đến bản phát hành dấu chấm mới nhất của phiên bản chính bạn đang sử dụng (X.*) và nâng cấp hằng năm lên phiên bản chính mới.

    Khi bạn phát hành 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 chấm mới hơn của SDK Địa điểm dành cho iOS. Thao tác này sẽ không yêu cầu ứng dụng cập nhật vì các phiên bản dấu chấm mới 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 iOS, các bản sửa lỗi sẽ được cung cấp theo cách tương thích ngược trong vòng 12 tháng sau khi phiên bản chính phát hành ban đầu, theo Chính sách hỗ trợ thiết bị di động. Bạn không cần phải nhanh chó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.
    • Những điểm cải tiến và tính năng mới nhất đều dễ áp dụng khi ứng dụng của bạn được xây dựng dựa trên phiên bản mới nhất.
    • Các bản cập nhật tăng dần hằng năm cho phiên bản lớn mới nhất của SDK có thể đòi hỏi ít công sức hơn để thích ứng, viết lại và thử nghiệm ứng dụng, thay vì phải xử lý các thay đổi không tương thích ngược 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 cố định bất kỳ. Khi nhận được thông báo về việc ngừng hỗ trợ phiên bản đã khắc phục này, bạn sẽ có 12 tháng để cung cấp mã ứng dụng đã cập nhật cho người dùng của mình.

    Lợi ích:

    • Ít công việc bảo trì hơn.
    • Các phiên bản mới của ứng dụng liên tục hỗ trợ các thiết bị của người dùng chạy các hệ điều hành cũ hơn trên thiết bị di động (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ọ. Cập nhật thông tin về các nội dung cập nhật chính, ngừng sử dụng và các thay đổi khác.

Cài đặt

Luôn chỉ định số phiên bản trong các phần phụ thuộc thay vì sử dụng toán tử lạc quan (~>) vì điều đó có thể dẫn đến các bản dựng không thể đoán trước và không thể lặp lại. SDK Địa điểm dành cho iOS 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 bao gồm các thay đổi có thể gây lỗi.

Sử dụng CocoaPods

Ví dụ về phần phụ thuộc Podfile bằng cú pháp Podfile:

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '13.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '7.3.0'
end

Sử dụng Carthage

Ví dụ về phần phụ thuộc Cartfile sử dụng cú pháp Cartfile:

binary "https://dl.google.com/geosdk/GooglePlaces.json" == 6.2.1

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

Để xây dựng bằng các điểm cải tiến mới nhất, hãy thường xuyên kiểm tra phiên bản mới hơn và cập nhật thông số kỹ thuật phiên bản. 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ã của bạn.

Sử dụng chim cốc giá

  1. Mở cửa sổ dòng lệnh rồi chuyển đến thư mục chứa Podfile:

    cd <path-to-project>
  2. Chạy pod outdated để xem liệu có phiên bản mới hơn của SDK Địa điểm dành cho iOS hay không.
  3. Nếu tìm thấy phiên bản SDK mới hơn, hãy cập nhật Podfile của bạn bằng phiên bản mới này. Xem phần Chỉ định phiên bản nhóm để tìm hiểu cách đặt một phiên bản cụ thể trong Podfile.
  4. Chạy pod update.
  5. Thực hiện mọi thay đổi cần thiết do việc nâng cấp. Hãy xem Ghi chú phát hành để biết danh sách thay đổi trong mỗi bản phát hành.
  6. Dọn dẹp và tạo lại dự án bằng cách chọn Sản phẩm > Dọn sạch, sau đó chọn Sản phẩm > Bản dựng

Sử dụng Carthage

  1. Mở cửa sổ dòng lệnh rồi chuyển đến thư mục chứa Podfile:

    cd <path-to-project>
  2. Chạy carthage outdated để xem liệu có phiên bản mới hơn của SDK Địa điểm dành cho iOS hay không.
  3. Nếu tìm thấy phiên bản SDK mới hơn, hãy cập nhật Cartfile của bạn bằng phiên bản mới này. Hãy xem bài viết Yêu cầu đối với phiên bản để tìm hiểu cách đặt một phiên bản cụ thể trong Cartfile.
  4. Chạy carthage update.
  5. Thực hiện mọi thay đổi cần thiết do việc nâng cấp. Hãy xem Ghi chú phát hành để biết danh sách thay đổi trong mỗi bản phát hành.
  6. Dọn dẹp và tạo lại dự án bằng cách chọn Sản phẩm > Dọn sạch, sau đó chọn Sản phẩm > Bản dựng

Thủ công

Lấy đường liên kết đến các tệp nguồn mới nhất tại phần Cài đặt SDK.

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 thông báo về những thay đổi không tương thích ngược có thể ảnh hưởng đến dự án của họ. Để chủ động nhận thông báo 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 giám sát cho từng dự án của bạn.