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

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 เป็นตัวเลือกใดตัวเลือกหนึ่งตามเวอร์ชัน สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ระบุเวอร์ชันล่าสุดและ ใช้ตัวเลือก "เวอร์ชันที่แน่นอน" เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ"

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

1. หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนทรัพยากร 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 และ 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 (ความเป็นส่วนตัว - คำอธิบายการใช้งานตำแหน่งเสมอและขณะใช้งาน)
      ค่า: "แอปนี้ต้องได้รับสิทธิ์ในการใช้ตำแหน่งของคุณสำหรับการนำทางแบบเลี้ยวต่อเลี้ยว"

CocoaPods

Navigation SDK สำหรับ iOS พร้อมให้บริการเป็น CocoaPods Pod CocoaPods เป็นเครื่องมือจัดการทรัพยากร Dependency แบบโอเพนซอร์สสำหรับโปรเจ็กต์ Cocoa ของ Swift และ Objective-C

หากยังไม่มีเครื่องมือ CocoaPods ให้ติดตั้งใน macOS โดย เรียกใช้คำสั่งต่อไปนี้จากเทอร์มินัล ดูรายละเอียดได้ที่ CocoaPods คู่มือเริ่มต้นใช้งาน

sudo gem install cocoapods

สร้าง Podfile สำหรับ Navigation SDK สำหรับ iOS แล้วใช้ เพื่อติดตั้ง API และทรัพยากร Dependency ของ API ดังนี้

1. หากยังไม่มีโปรเจ็กต์ Xcode ให้สร้างโปรเจ็กต์ตอนนี้และบันทึกลงใน เครื่องของคุณ หากเพิ่งเริ่มพัฒนาแอป iOS ให้ทำดังนี้
   1. สร้างโปรเจ็กต์ใหม่
   2. เลือกเทมเพลต iOS > แอป
   3. ในหน้าจอตัวเลือกโปรเจ็กต์ ให้ทำดังนี้
      1. ป้อนชื่อโปรเจ็กต์
      2. บันทึกค่าของช่องรหัสชุดซอฟต์แวร์ คุณสามารถใช้ค่านั้นเพื่อจำกัดคีย์ API ด้านล่างได้
      3. ตั้งค่าอินเทอร์เฟซ ของโปรเจ็กต์เป็น Storyboard
      4. ตั้งค่าภาษา เป็น Swift หรือ Objective-C
2. สร้างไฟล์ชื่อ Podfile ในไดเรกทอรีโปรเจ็กต์ ไฟล์นี้จะกำหนดทรัพยากร Dependency ของโปรเจ็กต์
3. แก้ไข Podfile แล้วเพิ่มทรัพยากร Dependency พร้อมกับ เวอร์ชัน ตัวอย่างต่อไปนี้แสดงทรัพยากร Dependency ที่คุณต้องใช้สำหรับ Navigation SDK สำหรับ iOS: # Cocoapods install reference #

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '16.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GoogleNavigation', '10.14.0'
   end
           

   อย่าลืมเรียกใช้ pod outdated เป็นประจำเพื่อตรวจหา เวอร์ชันใหม่กว่า และอัปเกรด เป็นเวอร์ชันล่าสุดหากจำเป็น
4. บันทึก Podfile

5. เปิดเทอร์มินัลแล้วไปที่ไดเรกทอรีที่มี Podfile

   cd <path-to-project>

6. เรียกใช้คำสั่ง pod install ซึ่งจะติดตั้ง API ที่ระบุไว้ใน Podfile พร้อมกับทรัพยากร Dependency

   pod install

7. ปิด Xcode แล้วเปิด (ดับเบิลคลิก) ไฟล์ .xcworkspace ของโปรเจ็กต์เพื่อเปิด Xcode จากนี้ไป คุณต้องใช้ไฟล์ .xcworkspace เพื่อเปิดโปรเจ็กต์

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

1. เปิดเทอร์มินัลแล้วไปที่ไดเรกทอรีโปรเจ็กต์ที่มี Podfile
2. เรียกใช้คำสั่ง pod update ซึ่งจะอัปเดต API ทั้งหมด ที่ระบุไว้ใน Podfile เป็นเวอร์ชันล่าสุด

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