Trang này mô tả cách thiết lập thư viện tiện ích đối với SDK bản đồ dành cho iOS.
Để dùng thử các tiện ích này, bạn có thể:
- Cài đặt thư viện tiện ích vào dự án Xcode hiện có. Thêm các tiện ích này vào dự án của riêng bạn.
- Cài đặt và chạy ứng dụng minh hoạ. Ứng dụng minh hoạ là một dự án độc lập chứa tất cả mã cần thiết để dùng thử các phần mềm tiện ích.
Thêm SDK bản đồ cho Thư viện tiện ích iOS vào dự án Xcode
Hãy thực hiện theo các bước sau để thêm thư viện tiện ích vào không gian làm việc Xcode của bạn:
Sử dụng Trình quản lý gói Swift
- 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ộ của bạn. (Nếu bạn mới phát triển iOS, hãy tạo dự án mới và chọn Ứng dụng iOS mẫu. Trên Xcode 11.7 trở xuống, hãy tạo một Ứng dụng chế độ xem duy nhất.)
- Thêm SDK Maps dành cho iOS làm phần phụ thuộc. Xem Cài đặt SDK để biết các lựa chọn.
- Trong dự án Xcode của bạn, hãy chuyển đến Tệp -> Gói Swift -> Thêm phần phụ thuộc gói.
- Trong cửa sổ hiện ra, hãy nhập URL kho lưu trữ Thư viện tiện ích iOS
https://github.com/googlemaps/google-maps-ios-utils
rồi chọn Tiếp theo. - Tại thời điểm này, bạn có thể được nhắc xác thực với tài khoản GitHub của mình. Làm theo để tạo một GitHub mã truy cập cá nhân để tiếp tục quy trình.
- Trong cửa sổ tiếp theo, hãy chọn tuỳ chọn Version (Phiên bản), chọn Up to Next Major Version (Lên đến phiên bản lớn tiếp theo) từ danh sách thả xuống rồi nhập phiên bản mới nhất của SDK Maps dành cho Thư viện tiện ích iOS (ví dụ: "6.0.0").
- Nhấp vào trình đơn thả xuống bên cạnh Add to Project (Thêm vào dự án), chọn dự án của bạn rồi chọn Add Package (Thêm gói).
Sử dụng CocoaPods
- 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ộ của bạn. (Nếu bạn mới bắt đầu phát triển iOS, hãy tạo một Một Xem đơn đăng ký.)
- Nếu bạn chưa có tệp nhóm cho dự án của mình, hãy tạo một tệp
có tên
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 tệp nhóm của dự án và thêm phần phụ thuộc vào
Google-Maps-iOS-Utils
nhóm. Dưới đây là một trong đó bao gồm các phần phụ thuộc cần thiết cho SDK Bản đồ dành cho iOS và thư viện tiện ích:source 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do use_frameworks! pod 'GoogleMaps', '9.0.0' pod 'Google-Maps-iOS-Utils', '6.0.0' # x-release-please-version end
- Chạy
pod install
. - Đóng Xcode rồi mở (nhấp đúp)
.xcworkspace
để chạy Xcode. Kể từ thời điểm này trở đi, bạn phải dùng tệp.xcworkspace
để mở dự án.
Lưu ý: Tiện ích phân cụm điểm đánh dấu phụ thuộc vào
nhưng bạn có thể sử dụng bốn cây mà không cần phân cụm điểm đánh dấu. Nếu bạn muốn
tiện ích quadtree, bạn có thể thay đổi
pod 'Google-Maps-iOS-Utils'
thành
'Google-Maps-iOS-Utils/QuadTree'
trong tệp nhóm của bạn.
Thêm khoá API vào ứng dụng của bạn
Xem Thiết lập dự án Xcode để biết hướng dẫn về cách tạo khóa API và thêm khóa đó vào dự án Xcode của bạn.Tạo và chạy dự án
Sau khi bạn thêm khoá API, hãy tạo và chạy dự án.
Sử dụng tiện ích trong ứng dụng của bạn
Hãy xem tài liệu về mỗi tiện ích để biết thêm thông tin về cách sử dụng tiện ích đó trong ứng dụng của bạn:
Cài đặt và chạy ứng dụng minh hoạ
Thư viện tiện ích bao gồm một ứng dụng minh hoạ mà bạn có thể cài đặt, sau đó dùng thử từng tiện ích.
Cài đặt ứng dụng minh hoạ bằng cách sử dụng một trong hai phương pháp sau:Sử dụng tệp trên GitHub
- Tải xuống kho lưu trữ mã mẫu từ GitHub và giải nén tệp lưu trữ.
- Mở cửa sổ dòng lệnh, chuyển đến thư mục mà bạn đã mở rộng các tệp mẫu, và
xem chi tiết thư mục mẫu thích hợp cho ngôn ngữ bạn muốn sử dụng:
- Đối với Swift, hãy chạy
cd google-maps-ios-utils-master/samples/SwiftDemoApp
- Đối với Target-C, hãy chạy
cd google-maps-ios-utils-master/samples/ObjCDemoApp
- Đối với Swift, hãy chạy
- Chạy lệnh sau:
pod install
- Đóng Xcode rồi mở (nhấp đúp)
.xcworkspace
để chạy Xcode. Kể từ thời điểm này trở đi, bạn phải dùng tệp.xcworkspace
để mở dự án.
Sử dụng CocoaPods v1.6.1
- Mở cửa sổ dòng lệnh và cài đặt phiên bản 1.6.1:
sudo gem install cocoapods -v1.6.1
- Tìm nạp các tệp Google Maps bằng Cocoapods:
pod try Google-Maps-iOS-Utils
Chọn Swift hoặc Object-C khi được nhắc. CocoaPods cập nhật kho lưu trữ thông số kỹ thuật của bạn, sau đó mở bản minh hoạ trong một dự án Xcode tạm thời có tên là
SwiftDemoApp.xcodeproj
hoặcObjCDemoApp.xcodeproj
.
Thêm khoá API vào ứng dụng minh hoạ
Trong phần Lấy khoá API, bạn sẽ tạo khoá API cho ứng dụng của bạn. Bây giờ, hãy thêm khoá đó vào dự án Xcode cho ứng dụng minh hoạ.Swift
Thêm khoá API vào AppDelegate.swift
của bạn như sau:
- Thêm câu lệnh nhập sau:
import GoogleMaps
- Chỉnh sửa dòng sau để thêm khoá API vào giữa dấu ngoặc kép:
// Change this key to a valid key registered with the demo app bundle id. let mapsAPIKey = ""
Objective-C
Thêm khoá API vào AppDelegate.m
của bạn như sau:
- Thêm câu lệnh nhập sau:
@import GoogleMaps;
- Chỉnh sửa dòng sau để thêm khoá API vào giữa dấu ngoặc kép:
// Change this key to a valid key registered with the demo app bundle id. static NSString *const kMapsAPIKey = @"";
Tạo bản dựng và chạy ứng dụng minh hoạ
Sau khi bạn thêm khoá API, hãy tạo và chạy dự án:
- Nếu đang chạy phiên bản Swift của bản minh hoạ, bạn có thể chọn tiện ích nào để xem trong ứng dụng.
- Nếu đang chạy phiên bản minh hoạ GOAL-C, bạn sẽ thấy bản minh hoạ của tiện ích phân cụm điểm đánh dấu. Sau đó, bạn có thể chỉnh sửa phiên bản Target-C của bản minh hoạ để dùng thử từng tiện ích. Hãy xem phần Thêm tiện ích vào ứng dụng bên dưới để biết thêm thông tin.