Thiết lập dự án Xcode

Trình quản lý gói Swift

Bạn có thể cài đặt SDK bản đồ dành 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 bản đồ dành 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:

1. Mở project hoặc workspace Xcode, sau đó chuyển đến File > Add Package Dependencies (Tệp > Thêm phần phụ thuộc của gói).
2. Nhập https://github.com/googlemaps/ios-maps-sdk làm URL, nhấn Enter để kéo gói vào và nhấp vào "Add Package" (Thêm gói).
3. Để 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".
4. Trong cửa sổ Chọn sản phẩm trong gói, hãy xác minh rằng GoogleMaps (đối với các phiên bản trước 9.0.0, hãy xác minh rằng GoogleMaps, GoogleMapsBase và GoogleMapsCore sẽ được thêm vào mục tiêu main mà bạn chỉ định. Sau khi hoàn tất, hãy nhấp vào "Thêm gói".
5. Để 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) trong "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:

1. Nếu đang nâng cấp từ phiên bản cũ hơn 9.0.0, bạn phải xoá các phần phụ thuộc sau: GoogleMapsBase, GoogleMapsCore và GoogleMapsM4B sau khi nâng cấp. Đừng xoá phần phụ thuộc cho GoogleMaps. Để biết thêm thông tin, hãy xem Ghi chú phát hành phiên bản 9.0.0.

   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:

   • GoogleMapsBase (Chỉ dành cho các bản nâng cấp từ phiên bản trước 9.0.0)
   • GoogleMapsCore (Chỉ dành cho các bản nâng cấp từ phiên bản trước 9.0.0)
   • GoogleMapsM4B (Chỉ dành cho các bản nâng cấp từ phiên bản trước 9.0.0)
2. 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).
3. Để 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á các phần phụ thuộc SDK bản đồ dành cho iOS hiện có đã được thêm bằng CocoaPods, hãy làm theo các bước sau:

1. Đóng không gian làm việc Xcode. Mở cửa sổ dòng lệnh rồi thực thi lệnh sau:

   sudo gem install cocoapods-deintegrate cocoapods-clean
   pod deintegrate
   pod cache clean --all

2. Xoá Podfile, Podfile.resolved và Xcode workspace nếu bạn không sử dụng chúng cho mục đích nào khác ngoài CocoaPods.

1. 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
   • GoogleMapsBase (Chỉ dành cho các bản cài đặt trước phiên bản 9.2.0)
   • GoogleMapsCore (Chỉ dành cho các bản cài đặt trước phiên bản 9.2.0)
   • GoogleMapsM4B (Chỉ dành cho các bản cài đặt trước phiên bản 9.0.0)
2. 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 mô tả cách thêm XCFramework chứa SDK bản đồ dành cho iOS vào dự án của bạn theo cách thủ công và cách đị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 sử dụng trên nhiều nền tảng, bao gồm cả những máy dùng Apple silicon.

1. Tải các tệp nhị phân và tệp tài nguyên SDK sau đây xuống:
   • GoogleMaps
   • GoogleMapsResources
2. Giải nén các tệp để truy cập vào XCFramework và tài nguyên.
3. 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:
   1. Tạo một dự án mới.
   2. Chọn mẫu iOS > App (iOS > Ứng dụng).
   3. Trên màn hình các lựa chọn cho dự án:
      1. Nhập Tên dự án.
      2. 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.
      3. Đặt Giao diện của dự án thành Bảng phân cảnh.
      4. Đặt Ngôn ngữ thành Swift hoặc Objective-C.
4. Mở thẻ Chung. Kéo các 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 được nhúng). Nhớ chọn Không nhúng:
   • GoogleMaps.xcframework
5. Sao chép 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. Nhớ chọn Sao chép các mục vào thư mục của nhóm đích khi được nhắc.
6. 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.
7. Mở thẻ Build Phases (Giai đoạn xây dựng) cho mục tiêu của ứng dụng. 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
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • MetricKit.framework
   • OpenGLES.framework (Chỉ khi bạn đang sử dụng OpenGL)
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. 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 Linking – General –> Other Linker Flags (Liên kết – Chung –> Cờ trình liên kết khác), hãy thêm -ObjC và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ả).

9. Để cài đặt Places SDK cho iOS XCFramework, hãy xem phần Bắt đầu sử dụng Places SDK cho iOS.

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. Thêm nội dung sau vào phương thức application(_:didFinishLaunchingWithOptions:) bằng khoá API của bạn:

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. Nếu bạn cũng đang sử dụng Places API, hãy thêm lại khoá của bạn như minh hoạ ở đây:

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

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. Thêm nội dung sau vào phương thức application:didFinishLaunchingWithOptions: bằng khoá API của bạn:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. Nếu bạn cũng đang sử dụng Places API, hãy thêm lại khoá của bạn như minh hoạ ở đây:

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];