Thiết lập và minh hoạ

Chọn nền tảng: Android iOS

Trang này mô tả cách thiết lập thư viện tiện ích cho SDK bản đồ dành cho iOS.

Để dùng thử các tiện ích này, bạn có thể:

Thêm Thư viện tiện ích SDK bản đồ dành cho iOS vào một dự án Xcode

Làm theo các bước sau để thêm thư viện tiện ích vào không gian làm việc Xcode:

Sử dụng Trình quản lý gói Swift

  1. 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, hãy tạo một dự án mới rồi chọn mẫu Ứng dụng iOS. Trên Xcode 11.7 trở xuống, hãy tạo một Ứng dụng có một khung hiển thị.)
  2. Thêm SDK bản đồ dành cho iOS làm phần phụ thuộc. Hãy xem phần Cài đặt SDK để biết các lựa chọn.
  3. Trong dự án Xcode, hãy chuyển đến File (Tệp) -> Swift Packages (Gói Swift) -> Add Package Dependency (Thêm phần phụ thuộc của gói).
  4. Trong cửa sổ xuất hiện, hãy nhập URL kho lưu trữ Thư viện tiện ích SDK bản đồ dành cho 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 bằng tài khoản GitHub của mình. Làm theo hướng dẫn để tạo mã truy cập cá nhân GitHub nhằm tiếp tục quy trình.
  5. Trong cửa sổ tiếp theo, hãy chọn nút chọn Version (Phiên bản), chọn Up to Next Major Version (Lên đến phiên bản chính tiếp theo) trong danh sách thả xuống, rồi nhập phiên bản mới nhất của Thư viện tiện ích Maps SDK cho iOS (ví dụ: "6.0.0").
  6. Nhấp vào trình đơn thả xuống bên cạnh Thêm vào dự án, chọn dự án của bạn rồi chọn Thêm gói.

Thêm khoá API vào ứng dụng

Hãy xem phần Thiết lập dự án Xcode để biết hướng dẫn về cách tạo khoá API và thêm khoá đó vào dự án Xcode.

Tạo bản dựng và chạy dự án

Sau khi thêm khoá API, hãy tạo và chạy dự án.

Sử dụng một tiện ích trong ứng dụng của bạn

Hãy xem tài liệu về từng 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 có một ứng dụng minh hoạ mà bạn có thể cài đặt rồi dùng thử từng tiện ích.

Cài đặt ứng dụng minh hoạ:

Sử dụng tệp trên GitHub

  1. Tải tệp lưu trữ mã mẫu xuống từ GitHub rồi giải nén tệp lưu trữ đó. Ngoài ra, hãy sao chép kho lưu trữ vào một thư mục cục bộ: 
    git clone https://github.com/googlemaps/google-maps-ios-utils.git
  2. Mở cửa sổ dòng lệnh, chuyển đến thư mục nơi bạn mở rộng các tệp mẫu và đi sâu vào thư mục mẫu thích hợp cho ngôn ngữ mà bạn muốn sử dụng:

    Swift

    cd google-maps-ios-utils/samples/SwiftDemoApp
open SwiftDemoApp.xcodeproj

    Objective-C

    cd google-maps-ios-utils/samples/ObjCDemoApp
open ObjCDemoApp.xcodeproj

Thêm khoá API vào ứng dụng minh hoạ

Trong phần Lấy khoá API, bạn sẽ tạo một khoá API cho ứng dụng của mình. Giờ đây, 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:

  1. Thêm câu lệnh nhập sau: 
    import GoogleMaps
  2. Chỉnh sửa dòng sau để thêm khoá API của bạn 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:

  1. Thêm câu lệnh nhập sau: 
    @import GoogleMaps;
  2. Chỉnh sửa dòng sau để thêm khoá API của bạn 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 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 để xem trong ứng dụng.
  • Nếu đang chạy phiên bản Objective-C của bản minh hoạ, bạn sẽ thấy bản minh hoạ của tiện ích nhóm điểm đánh dấu. Sau đó, bạn có thể chỉnh sửa phiên bản Objective-C của bản minh hoạ để 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.