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 có xoá mọi SDK Maps hiện có cho các phần phụ thuộc iOS.

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

1. Mở Xcode project hoặc workspace của bạn, sau đó chuyển đến Tệp > Thêm phần phụ thuộc của 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 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à bằng cách sử dụng "Phiên bản chính xác" . Sau khi hoàn tất, hãy nhấp vào "Add Package" (Thêm gói).
4. Từ cửa sổ Choose Package Products (Chọn sản phẩm gói), xác minh GoogleMaps (đối với các phiên bản cũ hơn 9.0.0, hãy xác minh GoogleMaps, GoogleMapsBase và GoogleMapsCore) sẽ được thêm vào mục tiêu main mà bạn chỉ định. Sau khi hoàn tất, hãy nhấp vào "Add Package" (Thêm gói).
5. Để xác minh chế độ cài đặt của bạn, hãy chuyển đến ngăn General của mục tiêu. Trong phần Khung, Thư viện và Nội dung nhúng, bạn sẽ thấy các gói đã cài đặt. Bạn cũng có thể xem phần "Phần phụ thuộc của 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.

Để 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ừ một phiên bản cũ hơn 9.0.0,bạn phải gỡ bỏ 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 của 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 của bạn, hãy tìm Khung, Thư viện và Nội dung được nhúng. Sử dụng dấu trừ(-) để xoá khung sau:

   • GoogleMapsBase (Chỉ dành cho bản nâng cấp từ các phiên bản cũ hơn 9.0.0)
   • GoogleMapsCore (Chỉ dành cho bản nâng cấp từ các phiên bản cũ hơn 9.0.0)
   • GoogleMapsM4B (Chỉ dành cho bản nâng cấp từ các phiên bản cũ hơn 9.0.0)
2. Từ Xcode, hãy chuyển đến "Tệp > Gói hàng > Hãy cập nhật lên phiên bản gói mới nhất".
3. Để xác minh việc cài đặt của bạn, 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.

Cách xoá SDK Maps hiện có cho các phần phụ thuộc iOS đã được thêm bằng cách sử dụng CocoaPods, hãy làm theo các bước sau:

1. Đóng không gian làm việc Xcode của bạn. Mở terminal 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 chúng cho bất kỳ mục đích nào khác không phải là 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 này có thể dẫn đến các bản dựng khó dự đoán và không thể lặp lại. Chiến lược phát hành đĩa đơn SDK bản đồ dành cho iOS tuân thủ phiên bản ngữ nghĩa, và các bản phát hành phiên bản lớn mới bao gồm cả những 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', '8.4.0'
end