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

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

1. จาก Xcode ให้ไปที่ File > Packages > Update To Latest Package Versions
2. หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนการขึ้นต่อกันของแพ็กเกจในProject Navigator เพื่อยืนยันแพ็กเกจและเวอร์ชัน

สำคัญ: บางครั้งอาจแก้ปัญหาเกี่ยวกับอาร์ติแฟกต์ไม่ได้หรืออาจเกิดข้อผิดพลาด ในกรณีนี้ ให้เลือก "ไฟล์ > แพ็กเกจ > รีเซ็ตแคชแพ็กเกจ"

หากต้องการนำ Navigation SDK สำหรับ iOS ที่ติดตั้งด้วยตนเองออก ให้ทำตามขั้นตอนต่อไปนี้

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

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

คู่มือนี้แสดงวิธีเพิ่ม 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, การนำทาง และ Places ที่มีอยู่ทั้งหมดออกจากโปรเจ็กต์
   สำคัญ: Places SDK สำหรับ iOS ไม่ได้รวมอยู่ใน Navigation SDK สำหรับ iOS และต้องติดตั้งแยกต่างหาก ซึ่งเป็นจริงตั้งแต่เวอร์ชัน 5.0 ของ Places SDK สำหรับ iOS Google ขอแนะนำให้คุณดาวน์โหลดและ ติดตั้ง Places SDK สำหรับ iOS และ Navigation SDK สำหรับ iOS เวอร์ชันเดียวกัน ดู ติดตั้ง Places SDK สำหรับ iOS
4. ลาก XCFramework ต่อไปนี้ลงในโปรเจ็กต์ของคุณในส่วน Frameworks, Libraries, and Embedded Content เพื่อติดตั้งทั้ง Maps และ Navigation SDK (เมื่อได้รับข้อความแจ้ง ให้เลือกคัดลอกรายการหากจำเป็น)
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. ลาก GoogleMaps.bundle จาก GoogleMapsResources ที่คุณดาวน์โหลด ไปยังไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Xcode เมื่อได้รับข้อความแจ้ง ให้ตรวจสอบว่าได้เลือกคัดลอกรายการหากจำเป็นแล้ว
6. ลาก GoogleNavigation.bundle จาก GoogleNavigationResources ที่คุณดาวน์โหลด ไปยังไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Xcode เมื่อมีข้อความแจ้ง ให้ตรวจสอบว่าได้เลือกคัดลอกรายการไปยังโฟลเดอร์ของกลุ่มปลายทางแล้ว
7. เลือกโปรเจ็กต์จากแถบนำทางของโปรเจ็กต์ แล้วเลือกเป้าหมายของแอปพลิเคชัน
8. เปิดแท็บขั้นตอนการสร้าง และภายใน ลิงก์ไบนารีกับไลบรารี ให้เพิ่มเฟรมเวิร์กและไลบรารีต่อไปนี้
   • 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. ในเป้าหมายของแอปพลิเคชัน ให้เลือกแท็บความสามารถ เปิดโหมดเบื้องหลัง แล้วเปิดใช้โหมดต่อไปนี้
   • เสียง, AirPlay และการแสดงภาพซ้อนภาพ
   • การอัปเดตตำแหน่ง
10. เลือกโปรเจ็กต์แทนที่จะเลือกเป้าหมายที่เฉพาะเจาะจง แล้วเปิดแท็บสร้าง การตั้งค่า ในส่วนแฟล็ก Linker อื่นๆ ให้เพิ่ม ‑ObjC สำหรับทั้ง debug และ release หากไม่เห็นการตั้งค่าเหล่านี้ ให้เปลี่ยนตัวกรองในแถบการตั้งค่าบิลด์จากพื้นฐานเป็นทั้งหมด
    สำคัญ: SDK มีสัญลักษณ์ Swift หากสร้างโปรเจ็กต์ Objective-C อย่างเดียว คุณต้องสร้างไฟล์ .swift ที่ว่างเปล่าในโปรเจ็กต์ด้วย หรือเพิ่มรายการต่อไปนี้ลงในส่วนแฟล็ก Linker อื่นๆ ของโปรเจ็กต์ Xcode

    -L$(DEVELOPER_DIR)/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift/$(PLATFORM_NAME)

11. เปิด Info.plist แล้วเพิ่มคู่คีย์-ค่าต่อไปนี้
    • คีย์: NSLocationWhenInUseUsageDescription (Privacy - Location When In Use Usage Description)
      ค่า: "แอปนี้ต้องได้รับสิทธิ์ในการใช้ตำแหน่งของคุณสำหรับการนำทางแบบเลี้ยวต่อเลี้ยว"
    • คีย์: NSLocationAlwaysAndWhenInUseUsageDescription (Privacy - Location Always and When In Use Usage Description)
      ค่า: "แอปนี้ต้องได้รับสิทธิ์ในการใช้ตำแหน่งของคุณสำหรับการนำทางแบบเลี้ยวต่อเลี้ยว"

ขั้นตอนที่ 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 เพื่อดูข้อมูลอัปเดตและข้อมูลเพิ่มเติม

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

หากคุณเป็นลูกค้าบริการการเดินทาง

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

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

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

• บทแนะนำ
  • นำทางตามเส้นทาง
  • ฟังเหตุการณ์การนำทาง
• ใช้ App Check เพื่อรักษาคีย์ API ให้ปลอดภัย
• ตัวอย่างโค้ดและ Codelab