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

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

Bạn có thể cài đặt SDK Địa điểm 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 SDK Địa điểm hiện có 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-places-sdk làm URL, nhấn phím 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".
4. Trong cửa sổ Choose Package Products (Chọn sản phẩm trong gói), hãy xác minh rằng GooglePlaces, GooglePlacesSwift hoặc cả hai sẽ được thêm vào mục tiêu chính mà bạn chỉ định. Sau khi hoàn tất, hãy nhấp vào Thêm gói.

   Nếu bạn đang cập nhật Google Places Swift

   Lưu ý quan trọng: URL GitHub để truy cập vào Google Places Swift đã thay đổi kể từ phiên bản 0.3.0. Nếu bạn đang cập nhật một phiên bản GooglePlacesSwift được truy cập thông qua URL cũ, https://github.com/googlemaps/ios-places-swift-sdk, hãy xoá phiên bản đó khỏi phần phần phụ thuộc gói của Xcode.

5. Để xác minh quá trình cài đặt, hãy chuyển đến ngăn General (Chung) 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 mục 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. Xcode hiển thị phiên bản GitHub khớp với phiên bản GooglePlaces (ví dụ: 9.2.0) nhưng không khớp với phiên bản GooglePlacesSwift (ví dụ: 0.3.0).

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

1. 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).

   Nếu bạn đang cập nhật Google Places Swift

   Lưu ý quan trọng: URL GitHub để truy cập vào Google Places Swift đã thay đổi kể từ phiên bản 0.3.0. Nếu bạn đang cập nhật một phiên bản GooglePlacesSwift được truy cập thông qua URL cũ, https://github.com/googlemaps/ios-places-swift-sdk, hãy xoá phiên bản đó khỏi phần phần phụ thuộc gói của Xcode.

2. Để 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.

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 Địa điểm dành cho iOS tuân thủ tính năng 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á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 'GooglePlaces', '9.2.0'
  pod 'GooglePlacesSwift', '0.3.0'
end