Sau khi bật tính năng thanh toán và tạo khoá API, bạn có thể thiết lập dự án Xcode mà bạn dùng để phát triển ứng dụng.
Mỗi bản phát hành đều có ghi chú phát hành.
Bước 1: Cài đặt phần mềm cần thiết
Để tạo một dự án bằng Places SDK cho iOS, bạn cần có:
- Xcode phiên bản 26.0 trở lên
Bước 2: Tạo dự án Xcode và cài đặt SDK Địa điểm cho 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 hiện có của SDK Địa điểm cho iOS.
Để thêm SDK vào một dự án mới hoặc dự án hiện có, hãy làm theo các bước sau:
-
Mở
projecthoặcworkspaceXcode, sau đó chuyển đến File > Add Package Dependencies (Tệp > Thêm phần phụ thuộc của gói). - Nhập https://github.com/googlemaps/ios-places-sdk làm URL, nhấn phím Enter để lấy gói rồi nhấp vào "Add Package" (Thêm gói).
-
Để cài đặt một
versioncụ 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à 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". - Trong cửa sổ Chọn sản phẩm trong gói, hãy xác minh rằng
GooglePlaces,GooglePlacesSwifthoặ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 từ URL GitHub không dùng nữa
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. - Để 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 Frameworks, Libraries, and Embedded Content (Khung, thư viện và nội dung được nhúng), bạn sẽ thấy các gói đã cài đặt. Bạn cũng có thể xem phần Package Dependencies (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:
-
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 từ URL GitHub không dùng nữa
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. - Để xác minh quá trình cài đặt, hãy chuyển đến phần Package Dependencies (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.
Để xoá SDK Địa điểm cho iOS hiện có được cài đặt theo cách thủ công, hãy làm theo các bước sau:
-
Trong phần cài đặt cấu hình dự án Xcode, hãy tìm Frameworks, Libraries, and Embedded Content (Khung, Thư viện và Nội dung nhúng). Sử dụng dấu trừ (-) để xoá các khung sau:
GooglePlaces.xcframeworkGooglePlacesSwift.xcframework
-
Trong thư mục cấp cao nhất của dự án Xcode, hãy xoá gói
GooglePlaces.
Cài đặt theo cách thủ công
Hướng dẫn này trình bày cách thêm XCFrameworks chứa SDK Địa điểm cho iOS và SDK Địa điểm Swift cho iOS vào dự án của bạn theo cách thủ công, đồng thời định cấu hình chế độ cài đặt bản dựng trong Xcode. XCFramework là một gói nhị phân mà bạn có thể sử dụng trên nhiều nền tảng, bao gồm cả những máy dùng Apple silicon. Bạn có thể chọn thêm SDK Địa điểm cho iOS, SDK Địa điểm Swift cho iOS hoặc cả hai.
- Tải các tệp tài nguyên và tệp nhị phân SDK sau đây xuống:
- Nếu bạn đang cài đặt SDK Địa điểm Swift cho iOS, hãy cài đặt các tệp sau:
- Giải nén các tệp để truy cập vào XCFramework và tài nguyên.
- Chạy Xcode rồi mở một dự án hiện có hoặc tạo một dự án mới. Nếu bạn mới làm quen với việc phát triển ứng dụng iOS, hãy tạo một dự án mới và chọn mẫu Ứng dụng iOS.
- Xoá mọi gói Maps khỏi các bản phát hành trước đó khỏi dự án của bạn.
-
Mở thẻ Chung. Kéo XCFramework sau vào dự án của bạn
trong phần Frameworks, Libraries, and Embedded Content (Khung, thư viện và nội dung nhúng). Hãy nhớ chọn Do Not Embed (Không nhúng):
GooglePlaces.xcframework
GooglePlacesSwift.xcframework
-
Sao chép
GooglePlaces.bundletừ GooglePlacesResources bạn đã tải xuống vào thư mục cấp cao nhất của dự án Xcode. Hãy nhớ chọn Sao chép các mục vào thư mục của nhóm đích khi được nhắc.
Nếu bạn đang cài đặt SDK Địa điểm Swift, hãy sao chépGooglePlacesSwift.bundletừ GooglePlacesSwiftResources mà bạn đã tải xuống vào thư mục cấp cao nhất của dự án Xcode. Hãy nhớ chọn Sao chép các mục vào thư mục của nhóm đích khi được nhắc. - Chọn dự án của bạn trong Project Navigator (Trình điều hướng dự án) rồi chọn mục tiêu của ứng dụng.
-
Mở thẻ Tạo giai đoạn. Trong phần Link Binary with
Libraries (Liên kết tệp nhị phân với thư viện), hãy thêm các khung và thư viện sau:
CoreGraphics.frameworkCoreLocation.frameworklibc++.tbdlibz.tbdQuartzCore.frameworkUIKit.framework
-
Chọn dự án của bạn thay vì một mục tiêu cụ thể, rồi mở thẻ Build Settings (Cài đặt bản dựng). Trong phần Linking - General -> Other Linker Flags (Liên kết – Chung –> Cờ trình liên kết khác), hãy thêm
-ObjCvào "Debug" (Gỡ lỗi) và "Release" (Phát hành). Nếu bạn không thấy các chế độ cài đặt này, hãy thay đổi bộ lọc trong thanh Build Settings (Cài đặt bản dựng) từ Basic (Cơ bản) thành All (Tất cả).
Bước 3: Thêm khoá API vào ứng dụng
Trong các ví dụ sau, hãy thay thế YOUR_API_KEY bằng khoá API của bạn.
Thêm khoá API vào AppDelegate.swift như sau:
- Thêm câu lệnh nhập sau:
import GooglePlacesSwift
- Thêm đoạn mã sau vào phương thức
application(_:didFinishLaunchingWithOptions:), thay thế YOUR_API_KEY bằng khoá API của bạn:PlacesClient.provideAPIKey("YOUR_API_KEY")
Swift
Thêm khoá API vào AppDelegate.swift như sau:
- Thêm câu lệnh nhập sau:
import GooglePlaces
- Thêm đoạn mã sau vào phương thức
application(_:didFinishLaunchingWithOptions:), thay thế YOUR_API_KEY bằng khoá API của bạn:GMSPlacesClient.provideAPIKey("YOUR_API_KEY")
Objective-C
Thêm khoá API vào AppDelegate.m như sau:
- Thêm câu lệnh nhập sau:
@import GooglePlaces;
- Thêm đoạn mã sau vào phương thức
application:didFinishLaunchingWithOptions:, thay thế YOUR_API_KEY bằng khoá API của bạn:[GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];
Bước 4 (không bắt buộc): Kiểm tra tệp kê khai quyền riêng tư của Apple
Apple yêu cầu cung cấp thông tin chi tiết về quyền riêng tư của ứng dụng đối với các ứng dụng trên cửa hàng ứng dụng. Hãy truy cập trang Thông tin về quyền riêng tư trên Apple App Store để biết thông tin cập nhật và thông tin khác.
Tệp kê khai về quyền riêng tư của Apple có trong gói tài nguyên cho SDK. Để xác minh rằng Tệp kê khai về quyền riêng tư đã được đưa vào và để kiểm tra nội dung của tệp này, hãy tạo một kho lưu trữ cho ứng dụng của bạn và tạo báo cáo về quyền riêng tư từ kho lưu trữ đó.
Các bước tiếp theo
- Bắt đầu viết mã. Bạn nên bắt đầu bằng cách triển khai một ứng dụng khởi đầu để lấy địa điểm hiện tại của người dùng.
- Sau khi định cấu hình dự án, bạn có thể khám phá ứng dụng mẫu.
- Sử dụng tính năng Kiểm tra ứng dụng để bảo mật khoá API.