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.
Ghi chú phát hành có sẵn cho từng bản phát hành.
Bước 1: Cài đặt phần mềm bắt buộc
Để tạo một dự án bằng Navigation SDK cho iOS, bạn phải tải xuống và cài đặt:
- Xcode phiên bản 16.0 trở lên
Bước 2: Tạo dự án Xcode và cài đặt Navigation SDK
Trình quản lý gói Swift
Bạn có thể cài đặt Navigation SDK 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 Navigation SDK.
Để 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ở
project
hoặcworkspace
Xcode, 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-navigation-sdk làm URL, nhấn Enter để kéo gói vào, rồi nhấp vào "Add Package" (Thêm gói).
-
Để cài đặt một
version
cụ thể, hãy đặt trường Quy tắc về phần phụ thuộc thành một trong các lựa 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 lựa 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:
- Để xác minh quá trình cài đặt, hãy chuyển đến phần Package Dependencies (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.
-
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 được nhúng). Sử dụng dấu trừ(-) để xoá khung sau:
GoogleMaps.xcframework
GoogleNavigation.xcframework
-
Xoá gói
GoogleMaps
khỏi thư mục cấp cao nhất của dự án Xcode.
Cài đặt theo cách thủ công
Hướng dẫn này trình bày cách thêm thủ công XCFramework chứa Navigation SDK cho iOS và Maps SDK cho iOS vào dự án của bạn, đồ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 chipset M1
Hãy làm theo các bước sau để cài đặt XCFramework cho Navigation SDK cho iOS và Maps SDK cho iOS:
- Tải các tệp nhị phân SDK và tệp tài nguyên sau đây xuống:
- Khởi chạy Xcode và mở một dự án hiện có hoặc tạo một dự án mới. Nếu bạn mới sử dụng iOS, hãy tạo một dự án mới và chọn mẫu Ứng dụng iOS.
- Xoá tất cả các tham chiếu hiện có đến Maps, Navigation và Places khỏi dự án.
- Kéo các XCFramework sau vào dự án của bạn trong Frameworks, Libraries, and Embedded Content (Khung, Thư viện và Nội dung được nhúng) để cài đặt cả SDK Maps và SDK Điều hướng (khi được nhắc, hãy chọn Sao chép các mục nếu cần):
GoogleMaps.xcframework
GoogleNavigation.xcframework
- Kéo
GoogleMaps.bundle
từ GoogleMapsResources mà bạn đã tải xuống vào thư mục cấp cao nhất của dự án Xcode. Khi được nhắc, hãy đảm bảo bạn chọn Sao chép các mục nếu cần. - Kéo
GoogleNavigation.bundle
từ GoogleNavigationResources mà bạn đã tải xuống vào thư mục cấp cao nhất của dự án Xcode. Khi được nhắc, hãy đảm bảo bạn đã chọn Sao chép các mục vào thư mục của nhóm đích. - Chọn dự án của bạn trong Project Navigator (Trình điều hướng dự án) rồi chọn đích đến của ứng dụng.
- Mở thẻ Build Phases (Giai đoạn tạo) và trong 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:
Accelerate.framework
AudioToolbox.framework
AVFoundation.framework
Contacts.framework
CoreData.framework
CoreGraphics.framework
CoreImage.framework
CoreLocation.framework
CoreTelephony.framework
CoreText.framework
GLKit.framework
ImageIO.framework
libc++.tbd
libxml2.tbd
libz.tbd
Metal.framework
OpenGLES.framework
QuartzCore.framework
Security.framework
SystemConfiguration.framework
UIKit.framework
UserNotifications.framework
WebKit.framework
- Trong mục tiêu của ứng dụng, hãy chọn thẻ Capabilities (Tính năng), bật Background Modes (Chế độ nền) và bật các chế độ sau:
- Âm thanh, AirPlay và chế độ Hình trong hình
- Thông tin cập nhật về vị trí
- Chọn dự án của bạn thay vì một mục tiêu cụ thể và mở thẻ Build Settings (Cài đặt bản dựng). Trong phần Cờ trình liên kết khác, hãy thêm
‑ObjC
cho cả gỡ lỗi và 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ả). - Mở
Info.plist
rồi thêm các cặp khoá-giá trị sau:- Khoá:
NSLocationWhenInUseUsageDescription
(Quyền riêng tư – Nội dung mô tả về việc sử dụng vị trí khi đang sử dụng)
Giá trị: "Ứng dụng này cần có quyền sử dụng vị trí của bạn để chỉ đường từng chặng." - Khoá:
NSLocationAlwaysAndWhenInUseUsageDescription
(Quyền riêng tư – Luôn cho phép và Khi đang sử dụng – Nội dung mô tả về việc sử dụng thông tin vị trí)
Giá trị: "Ứng dụng này cần có quyền sử dụng thông tin vị trí của bạn để chỉ đường từng chặng."
- Khoá:
CocoaPods
Navigation SDK cho iOS có sẵn dưới dạng một pod CocoaPods. CocoaPods là một trình quản lý phần phụ thuộc nguồn mở cho các dự án Cocoa Swift và Objective-C.
Nếu bạn chưa có công cụ CocoaPods, hãy cài đặt công cụ này trên macOS bằng cách chạy lệnh sau từ thiết bị đầu cuối. Để biết thông tin chi tiết, hãy xem Hướng dẫn Bắt đầu sử dụng CocoaPods.
sudo gem install cocoapods
Tạo một Podfile
cho Navigation SDK cho iOS và dùng Podfile
đó để cài đặt API và các phần phụ thuộc của API:
- Nếu bạn chưa có dự án Xcode, hãy tạo một dự án ngay bây giờ và lưu vào máy cục bộ. Nếu bạn mới bắt đầu phát triển cho iOS:
- Tạo một dự án mới.
- Chọn mẫu iOS > App (iOS > Ứng dụng).
- Trên màn hình các lựa chọn cho dự án:
- Nhập Tên dự án.
- Ghi lại giá trị của trường Bundle identifier (Mã nhận dạng gói). Bạn có thể sử dụng giá trị đó để hạn chế khoá API của mình bên dưới.
- Đặt Giao diện của dự án thành Storyboard.
- Đặt Ngôn ngữ thành Swift hoặc Objective-C.
- Tạo một tệp có tên là
Podfile
trong thư mục dự án của bạn. Tệp này xác định các phần phụ thuộc của dự án. - Chỉnh sửa
Podfile
và thêm các phần phụ thuộc cùng với phiên bản của chúng. Sau đây là một ví dụ bao gồm phần phụ thuộc mà bạn cần cho Navigation SDK cho iOS: # Cocoapods install reference # Hãy nhớ thường xuyên chạysource 'https://github.com/CocoaPods/Specs.git' platform :ios, '16.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleNavigation', '10.1.0' end
pod outdated
để phát hiện các phiên bản mới hơn. Nếu cần, hãy nâng cấp lên phiên bản mới nhất. - Lưu
Podfile
. Mở cửa sổ dòng lệnh rồi chuyển đến thư mục chứa
Podfile
:cd <path-to-project>
Chạy lệnh
pod install
. Thao tác này sẽ cài đặt các API được chỉ định trongPodfile
, cùng với mọi phần phụ thuộc.pod install
Đóng Xcode, rồi mở (nhấp đúp) tệp
.xcworkspace
của dự án để chạy Xcode. Từ thời điểm này trở đi, bạn phải sử dụng tệp.xcworkspace
để mở dự án.
Để cập nhật API cho một dự án hiện có, hãy làm theo các bước sau:
- Mở một cửa sổ dòng lệnh rồi chuyển đến thư mục dự án chứa
Podfile
. - Chạy lệnh
pod update
. Thao tác này sẽ cập nhật tất cả các API được chỉ định trongPodfile
lên phiên bản mới nhất.
Bước 3: Thêm khoá API vào dự án
Các ví dụ sau đây cho thấy cách thêm khoá API vào dự án của bạn trong Xcode:
Swift
Thêm khoá API vào AppDelegate.swift
của bạn như sau:
- Thêm các câu lệnh nhập sau:
import GoogleMaps import GoogleNavigation
- Thêm nội dung sau vào phương thức
application(_:didFinishLaunchingWithOptions:)
:GMSServices.provideAPIKey("YOUR_API_KEY")
Objective-C
Thêm khoá API vào AppDelegate.m
của bạn như sau:
- Thêm các câu lệnh nhập sau:
@import GoogleMaps; @import GoogleNavigation;
- Thêm nội dung sau vào phương thức
application:didFinishLaunchingWithOptions:
:[GMSServices provideAPIKey:@"YOUR_API_KEY"];
Bước 4 (không bắt buộc): Kiểm tra tệp Tuyên bố về 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ư trong ứng dụng cho các ứng dụng trên App Store. Hãy truy cập vào trang Thông tin chi tiết 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 Tuyên bố 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 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ữ ứng dụng rồi tạo báo cáo về quyền riêng tư từ kho lưu trữ đó.
Nếu bạn là khách hàng của Dịch vụ di chuyển
Nếu bạn là khách hàng của Dịch vụ di chuyển, hãy tìm hiểu về việc thanh toán trong tài liệu về Dịch vụ di chuyển. Để biết thêm thông tin về cách ghi lại giao dịch, hãy xem phần Thiết lập thông tin thanh toán. Để tìm hiểu cách thêm mã giao dịch vào việc triển khai Navigation SDK, hãy xem phần Liên kết việc sử dụng dịch vụ với các giao dịch Mobility.
Bước tiếp theo
Giờ đây, khi đã có khoá API và dự án Xcode, bạn có thể tạo và chạy ứng dụng. Navigation SDK cho iOS cung cấp các hướng dẫn có thể giúp bạn bắt đầu. Để biết thêm thông tin, hãy xem: