สร้างโปรเจ็กต์ Xcode

Swift Package Manager

คุณติดตั้ง Navigation SDK ได้ผ่าน Swift Package Manager หากต้องการเพิ่ม SDK ให้ตรวจสอบว่าคุณได้นำทรัพยากร Dependency ของ Navigation SDK ที่มีอยู่ออกแล้ว

หากต้องการเพิ่ม SDK ลงในโปรเจ็กต์ใหม่หรือโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้

1. เปิด Xcode project หรือ workspace แล้วไปที่ไฟล์ > เพิ่มทรัพยากร Dependency ของแพ็กเกจ
2. ป้อน https://github.com/googlemaps/ios-navigation-sdk เป็น URL แล้วกด Enter เพื่อดึงแพ็กเกจเข้ามา แล้วคลิก "Add Package"
3. หากต้องการติดตั้ง version ที่เฉพาะเจาะจง ให้ตั้งค่าช่องกฎการขึ้นต่อกันเป็นตัวเลือกตามเวอร์ชันตัวเลือกใดตัวเลือกหนึ่ง สําหรับโปรเจ็กต์ใหม่ เราขอแนะนําให้ระบุเวอร์ชันล่าสุดและใช้ตัวเลือก "เวอร์ชันที่แน่นอน" เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ"
4. จากหน้าต่างเลือกผลิตภัณฑ์แพ็กเกจ ให้ยืนยันว่าระบบจะเพิ่ม GoogleNavigation ลงในเป้าหมาย main ที่กำหนด เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ"
5. หากต้องการยืนยันการติดตั้ง ให้ไปที่แผงทั่วไปของเป้าหมาย ใน Frameworks, Libraries, and Embedded Content คุณควรเห็นแพ็กเกจที่ติดตั้งไว้ นอกจากนี้ คุณยังดูส่วน "Package Dependencies" ของ "Project Navigator" เพื่อยืนยันแพ็กเกจและเวอร์ชันได้ด้วย

หากต้องการอัปเดต package สำหรับโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้

1. จาก Xcode ให้ไปที่ไฟล์ > แพ็กเกจ > อัปเดตเป็นเวอร์ชันแพ็กเกจล่าสุด
2. หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนทรัพยากร Dependency ของแพ็กเกจในเครื่องมือนำทางโปรเจ็กต์เพื่อยืนยันแพ็กเกจและเวอร์ชัน

1. จากการตั้งค่าการกำหนดค่าโปรเจ็กต์ Xcode ให้ค้นหาเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง ใช้เครื่องหมายลบ(-) เพื่อนำเฟรมเวิร์กต่อไปนี้ออก
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
2. นำแพ็กเกจ GoogleMaps ออกจากไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Xcode

การติดตั้งด้วยตนเอง

คู่มือนี้แสดงวิธีเพิ่ม XCFrameworks ที่มี Navigation SDK สำหรับ iOS และ Maps SDK สำหรับ iOS ลงในโปรเจ็กต์ด้วยตนเอง และกำหนดการตั้งค่าบิลด์ใน Xcode XCFramework เป็นแพ็กเกจไบนารีที่คุณใช้ได้ในหลายแพลตฟอร์ม รวมถึงเครื่องที่ใช้ชิปเซ็ต M1

ทำตามขั้นตอนต่อไปนี้เพื่อติดตั้ง XCFrameworks สำหรับ Navigation SDK สำหรับ iOS และ Maps SDK สำหรับ iOS

1. ดาวน์โหลดไบนารีและไฟล์ทรัพยากรของ SDK ต่อไปนี้
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
2. เปิด Xcode แล้วเปิดโปรเจ็กต์ที่มีอยู่หรือสร้างโปรเจ็กต์ใหม่ หากคุณเพิ่งเริ่มใช้ iOS ให้สร้างโปรเจ็กต์ใหม่และเลือกเทมเพลตแอป iOS
3. นำการอ้างอิง Maps, Navigation และ Places ที่มีอยู่ทั้งหมดออกจากโปรเจ็กต์
4. ลาก XCFrameworks ต่อไปนี้ลงในโปรเจ็กต์ในส่วนเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝังเพื่อติดตั้งทั้ง Maps SDK และ Navigation SDK (เมื่อได้รับข้อความแจ้ง ให้เลือกคัดลอกรายการหากจำเป็น)
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. ลาก GoogleMaps.bundle จาก GoogleMapsResources ที่คุณดาวน์โหลดไปยังไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Xcode เมื่อได้รับข้อความแจ้ง ให้ตรวจสอบว่าได้เลือกคัดลอกรายการหากจำเป็นแล้ว
6. ลาก GoogleNavigation.bundle จาก GoogleNavigationResources ที่ดาวน์โหลดมาไปยังไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Xcode เมื่อได้รับข้อความแจ้ง ให้ตรวจสอบว่าได้เลือกคัดลอกรายการไปยังโฟลเดอร์ของกลุ่มปลายทางแล้ว
7. เลือกโปรเจ็กต์จากแถบนำทางของโปรเจ็กต์ แล้วเลือกเป้าหมายของแอปพลิเคชัน
8. เปิดแท็บ Build Phases และภายใน Link Binary with Libraries ให้เพิ่มเฟรมเวิร์กและไลบรารีต่อไปนี้
   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CarPlay.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
   • MapKit.framework
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • UserNotifications.framework
   • WebKit.framework
9. ในเป้าหมายของแอปพลิเคชัน ให้เลือกแท็บ Capabilities เปิด Background Modes และเปิดใช้โหมดต่อไปนี้
   • เสียง, AirPlay และการแสดงภาพซ้อนภาพ
   • การอัปเดตตำแหน่ง
10. เลือกโปรเจ็กต์แทนเป้าหมายที่เฉพาะเจาะจง แล้วเปิดแท็บ Build Settings ในส่วน Other Linker Flags ให้เพิ่ม ‑ObjC สำหรับทั้ง debug และ release หากไม่เห็นการตั้งค่าเหล่านี้ ให้เปลี่ยนตัวกรองในแถบการตั้งค่าบิลด์จากพื้นฐานเป็นทั้งหมด
11. เปิด Info.plist และเพิ่มคู่คีย์-ค่าต่อไปนี้
    • คีย์: NSLocationWhenInUseUsageDescription (Privacy - Location When In Use Usage Description)
      ค่า: "แอปนี้ต้องได้รับสิทธิ์ใช้ตำแหน่งของคุณสำหรับการนำทางแบบเลี้ยวต่อเลี้ยว"
    • คีย์: NSLocationAlwaysAndWhenInUseUsageDescription (Privacy - Location Always and When In Use Usage Description)
      ค่า: "แอปนี้ต้องได้รับสิทธิ์ใช้ตำแหน่งของคุณสำหรับการนำทางแบบเลี้ยวต่อเลี้ยว"

Swift

เพิ่มคีย์ API ลงใน AppDelegate.swift ดังนี้

1. เพิ่มคำสั่งนำเข้าต่อไปนี้

   import GoogleMaps
   import GoogleNavigation

2. เพิ่มโค้ดต่อไปนี้ในเมธอด application(_:didFinishLaunchingWithOptions:)

   GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

เพิ่มคีย์ API ลงใน AppDelegate.m ดังนี้

1. เพิ่มคำสั่งนำเข้าต่อไปนี้

   @import GoogleMaps;
   @import GoogleNavigation;

2. เพิ่มโค้ดต่อไปนี้ในเมธอด application:didFinishLaunchingWithOptions:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];