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 đối với SDK bản đồ dành cho iOS.

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

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

  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ộ 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.)
  2. 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.
  3. 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.
  4. 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.
  5. 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").
  6. 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

  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ộ 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ý.)
  2. 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.
  3. 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
  4. Chạy pod install.
  5. Đó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

  1. Tải xuống kho lưu trữ mã mẫu từ GitHub và giải nén tệp lưu trữ.
  2. 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
  3. Chạy lệnh sau:
    pod install
  4. Đó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

  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
  2. 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ặc 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 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:

  1. Thêm câu lệnh nhập sau:
    import GoogleMaps
  2. 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:

  1. Thêm câu lệnh nhập sau:
    @import GoogleMaps;
  2. 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.