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

หลังจากเปิดใช้การเรียกเก็บเงินและสร้างคีย์ API แล้ว คุณก็พร้อมที่จะตั้งค่าโปรเจ็กต์ Xcode ที่ใช้พัฒนาแอป

บันทึกประจำรุ่นมี ให้ใช้งานสำหรับการเผยแพร่แต่ละครั้ง

ขั้นตอนที่ 1: ติดตั้งซอฟต์แวร์ที่จำเป็น

หากต้องการสร้างโปรเจ็กต์โดยใช้ Navigation SDK สำหรับ iOS คุณต้องดาวน์โหลดและติดตั้งรายการต่อไปนี้

  • Xcode เวอร์ชัน 26.0 ขึ้นไป

ขั้นตอนที่ 2: สร้างโปรเจ็กต์ Xcode และติดตั้ง Navigation SDK

Swift Package Manager

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

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

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

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

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

หากต้องการนำ Navigation SDK สำหรับ iOS ที่ติดตั้งด้วยตนเองออก ให้ทำตามขั้นตอนต่อไปนี้:
  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 ต่อไปนี้
  2. เปิด Xcode แล้วเปิดโปรเจ็กต์ที่มีอยู่หรือสร้างโปรเจ็กต์ใหม่ หากคุณเพิ่งเริ่มใช้ iOS ให้สร้างโปรเจ็กต์ใหม่และเลือก เทมเพลตแอป iOS
  3. นำข้อมูลอ้างอิง Maps, Navigation และ Places ทั้งหมดที่มีอยู่ออกจากโปรเจ็กต์
  4. ลาก XCFrameworks ต่อไปนี้ลงในโปรเจ็กต์ในส่วน เฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง เพื่อติดตั้งทั้ง Maps และ Navigation SDKs (เมื่อได้รับข้อความแจ้ง ให้เลือก คัดลอกรายการหากจำเป็น):
    • 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 หากไม่เห็นการตั้งค่าเหล่านี้ ให้เปลี่ยนตัวกรองใน Build Settings แถบจาก Basic เป็น All
  11. เปิด Info.plist แล้วเพิ่มคู่คีย์-ค่าต่อไปนี้
    • คีย์: NSLocationWhenInUseUsageDescription (ความเป็นส่วนตัว - คำอธิบายการใช้ตำแหน่งขณะใช้งาน)
      ค่า: "แอปนี้ต้องได้รับสิทธิ์ในการใช้ตำแหน่งของคุณสำหรับการนำทางแบบเลี้ยวต่อเลี้ยว"
    • คีย์: NSLocationAlwaysAndWhenInUseUsageDescription (ความเป็นส่วนตัว - คำอธิบายการใช้ตำแหน่งตลอดเวลาและขณะใช้งาน)
      ค่า: "แอปนี้ต้องได้รับสิทธิ์ในการใช้ตำแหน่งของคุณสำหรับการนำทางแบบเลี้ยวต่อเลี้ยว"

ขั้นตอนที่ 3: เพิ่มคีย์ API ลงในโปรเจ็กต์

ตัวอย่างต่อไปนี้แสดงวิธีเพิ่มคีย์ API ลงในโปรเจ็กต์ใน Xcode

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"];

ขั้นตอนที่ 4 (ไม่บังคับ): ตรวจสอบไฟล์ Privacy Manifest ของ Apple

Apple กำหนดให้แอปใน App Store ต้องระบุรายละเอียดความเป็นส่วนตัวของแอป โปรดไปที่หน้าข้อมูลความเป็นส่วนตัวของ Apple App Store เพื่อดูข้อมูลอัปเดตและข้อมูลเพิ่มเติม

ไฟล์ Privacy Manifest ของ Apple รวมอยู่ในแพ็กเกจทรัพยากรสำหรับ SDK หากต้องการยืนยันว่าได้รวมไฟล์ Privacy Manifest แล้วและตรวจสอบเนื้อหาของไฟล์ ให้สร้างไฟล์เก็บถาวรของแอปและ สร้างรายงานความเป็นส่วนตัว จากไฟล์เก็บถาวร

หากคุณเป็นลูกค้าของ Mobility Services

หากคุณเป็นลูกค้าของ Mobility Services โปรดดูข้อมูลเกี่ยวกับการเรียกเก็บเงินในเอกสารประกอบของ Mobility ดูข้อมูลเพิ่มเติมเกี่ยวกับการบันทึก ธุรกรรมได้ที่ หัวข้อตั้งค่าการเรียกเก็บเงิน หากต้องการดูวิธีเพิ่มรหัสธุรกรรมลงในการติดตั้งใช้งาน Navigation SDK โปรดดูหัวข้อ เชื่อมโยงการใช้งานบริการกับธุรกรรม Mobility

ขั้นตอนถัดไป

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