SDK Bản đồ dành cho phiên bản iOS

Trình quản lý gói Swift

Bạn có thể cài đặt SDK Bản đồ cho iOS thông qua Trình quản lý gói Swift. Để thêm SDK, hãy đảm bảo bạn đã xoá mọi phần phụ thuộc hiện có của SDK Bản đồ dành cho iOS.

Để thêm SDK vào một dự án mới hoặc hiện có, hãy làm theo các bước sau:

1. Mở project hoặc workspace Xcode, sau đó chuyển đến File (Tệp) > Add Package Dependencies (Thêm phần phụ thuộc gói).
2. Nhập https://github.com/googlemaps/ios-maps-sdk làm URL, nhấn Enter để lấy gói và nhấp vào "Thêm gói".
3. Để cài đặt một version cụ thể, hãy đặt trường Dependency Rule (Quy tắc phần phụ thuộc) thành một trong các tuỳ chọn dựa trên phiên bản. Đối với các dự án mới, bạn nên chỉ định phiên bản mới nhất và sử dụng tuỳ chọn "Phiên bản chính xác". Sau khi hoàn tất, hãy nhấp vào "Thêm gói".

Để cập nhật package cho một dự án hiện có, hãy làm theo các bước sau:

1. Nếu đang nâng cấp từ phiên bản thấp hơn 9.0.0, bạn phải xoá các phần phụ thuộc sau: GoogleMapsBase, GoogleMapsCore và GoogleMapsM4B sau khi nâng cấp. Không xoá phần phụ thuộc cho GoogleMaps. Để biết thêm thông tin, hãy xem Ghi chú phát hành phiên bản 9.0.0.

   Trong phần cài đặt cấu hình dự án Xcode, hãy tìm Khung, Thư viện và Nội dung nhúng. Sử dụng dấu trừ(-) để xoá khung sau:

   • GoogleMapsBase (Chỉ dành cho các bản nâng cấp từ phiên bản cũ hơn 9.0.0)
   • GoogleMapsCore (Chỉ dành cho các bản nâng cấp từ phiên bản cũ hơn 9.0.0)
   • GoogleMapsM4B (Chỉ dành cho các bản nâng cấp từ phiên bản cũ hơn 9.0.0)
2. Trong Xcode, hãy chuyển đến "File > Packages > Update To Latest Package Versions" (Tệp > Gói > Cập nhật lên phiên bản gói mới nhất).
3. Để xác minh quá trình cài đặt, hãy chuyển đến phần Package Dependencies (Phần phụ thuộc gói) của Project Navigator (Trình điều hướng dự án) để xác minh gói và phiên bản của gói.

Để xoá các phần phụ thuộc hiện có của SDK Bản đồ dành cho iOS được thêm bằng CocoaPods, hãy làm theo các bước sau:

1. Đóng không gian làm việc Xcode. Mở dòng lệnh và thực thi lệnh sau:

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. Xoá Podfile, Podfile.resolved và Xcode workspace nếu bạn không sử dụng các tệp này cho bất kỳ mục đích nào khác ngoài CocoaPods.

CocoaPods

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ể lặp lại và không thể dự đoán. SDK Bản đồ dành cho iOS 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 bao gồm các thay đổi có thể gây lỗi.

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

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

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '9.2.0'
end