ดาวน์โหลด Driver SDK

ส่วนนี้อธิบายวิธียืนยันว่าระบบของคุณเป็นไปตามข้อกำหนดขั้นต่ำ ตั้งค่ากลุ่ม Workspace และรับ Driver SDK

ก่อนเริ่มต้น

Driver SDK สำหรับ iOS กำหนดให้แอปของคุณต้องเป็นไปตามเกณฑ์ต่อไปนี้

• มี Navigation SDK
• เปิดใช้ Maps SDK สำหรับ iOS ใน Google Cloud Console และรับคีย์ API

ตรวจสอบข้อกำหนดขั้นต่ำของระบบ

ดูหมายเหตุประจำรุ่นเพื่อดูข้อกำหนดขั้นต่ำสำหรับ Driver SDK เวอร์ชันที่คุณใช้ ดูบันทึกประจำรุ่น

• อุปกรณ์เคลื่อนที่ต้องใช้ iOS 14 ขึ้นไป
• Apple Xcode เวอร์ชัน 15 ขึ้นไป

รับสิทธิ์เข้าถึง Google Workspace

หากคุณเป็นลูกค้า Google Workspace ให้ทำตามขั้นตอนต่อไปนี้

1. สร้างกลุ่ม Workspace โปรดดูข้อมูลเพิ่มเติมที่กลุ่ม Workspace

   เช่น แนวทางปฏิบัติแนะนำคือการตั้งชื่อกลุ่ม [e-mail]ในระหว่างการเริ่มต้นใช้งาน

2. ระบุชื่อให้ Google เพื่อเพิ่มกลุ่ม Workspace ของคุณลงในรายการที่อนุญาต ซึ่ง จะให้สิทธิ์เข้าถึงที่เก็บ CocoaPods ที่ถูกต้อง

3. ตรวจสอบว่าอีเมลผู้ใช้และอีเมลบัญชีบริการที่ต้องมีสิทธิ์เข้าถึง รวมอยู่ในรายการนี้

หากองค์กรสร้างกลุ่ม Workspace ไม่ได้ ให้ส่งรายการอีเมลของผู้ใช้และบัญชีบริการที่ต้องมีสิทธิ์เข้าถึงอาร์ติแฟกต์เหล่านี้ให้ Google

หมายเหตุ: กลุ่ม Workspace ไม่ใช่กลุ่ม Google ซึ่งมีชื่อลงท้ายด้วย @googlegroups.com รองรับเฉพาะกลุ่ม Workspace

ลงชื่อเข้าใช้ด้วย Cloud SDK

สำหรับการพัฒนาในเครื่อง ให้ลงชื่อเข้าใช้ด้วย Cloud SDK ดูรายละเอียดได้ที่ติดตั้ง gcloud CLI

ตัวอย่างต่อไปนี้แสดงวิธีลงชื่อเข้าใช้ด้วย Cloud SDK

gcloud

gcloud auth login

คุณต้องใช้อีเมลที่เป็นสมาชิกของกลุ่ม Workspace

ตั้งค่าโฮสต์การทำงานอัตโนมัติ

สําหรับระบบบิลด์หรือการผสานรวมอย่างต่อเนื่อง ให้ตั้งค่าโฮสต์การทำงานอัตโนมัติตามรายการวิธีการที่ระบุไว้สําหรับการใช้บัญชีบริการเพื่อตรวจสอบสิทธิ์กับ Google APIs และบริการ โปรดดูรายละเอียดที่ส่วนบัญชีบริการ ในหน้าวิธีการตรวจสอบสิทธิ์ที่ Google

• หากกระบวนการทำงานภายในสภาพแวดล้อม Google Cloud ให้ใช้ การตรวจหาข้อมูลเข้าสู่ระบบอัตโนมัติ ดูข้อมูลเพิ่มเติมได้ที่การตรวจหาข้อมูลเข้าสู่ระบบอัตโนมัติ

• หรือจะจัดเก็บไฟล์คีย์บัญชีบริการไว้ในตำแหน่งที่ปลอดภัยในระบบไฟล์ของโฮสต์ แล้วตั้งค่าตัวแปรสภาพแวดล้อม GOOGLE_APPLICATION_CREDENTIALS ให้เหมาะสมก็ได้ โปรดดูรายละเอียดเพิ่มเติมที่ GOOGLE_APPLICATION_CREDENTIALS

อีเมลบัญชีบริการที่เชื่อมโยงกับข้อมูลเข้าสู่ระบบต้องเป็นสมาชิกของ กลุ่ม Workspace

รับ Driver SDK

ติดตั้งและกำหนดค่า Driver SDK

CocoaPods

1. ติดตั้งเครื่องมือ CocoaPods: เปิดหน้าต่างเทอร์มินัลและเรียกใช้คำสั่งต่อไปนี้

   sudo gem install cocoapods
   

   โปรดดูรายละเอียดเพิ่มเติมในคู่มือเริ่มต้นใช้งาน CocoaPods

2. สร้าง Podfile สำหรับ Driver SDK: คุณใช้ Podfile เพื่อติดตั้ง API และการอ้างอิงของ API

   1. สร้างไฟล์ชื่อ Podfile ในไดเรกทอรีโปรเจ็กต์ ไฟล์นี้จะกำหนดการอ้างอิงของโปรเจ็กต์

   2. แก้ไข Podfile และเพิ่มทรัพยากร Dependency ตัวอย่างที่รวมการอ้างอิงมีดังนี้

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

      ต่อไปนี้คือตัวอย่างที่มีพ็อด Alpha และ Beta สำหรับ Driver SDK เป็นการขึ้นต่อกัน

      source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git"
      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

   3. บันทึก Podfile: เปิดเทอร์มินัลแล้วไปที่โฟลเดอร์ที่มี Podfile

      cd <path-to-project>
      

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

   pod install
   

4. เปิดโปรเจ็กต์ใน Xcode: ปิด Xcode แล้วเปิด (ดับเบิลคลิก) ไฟล์ .xcworkspace ของโปรเจ็กต์เพื่อเปิด Xcode หากต้องการเปิดโปรเจ็กต์ในภายหลัง ให้ใช้ไฟล์ .xcworkspace

   หมายเหตุ: เรียกใช้ pod outdated เป็นระยะๆ เพื่อตรวจหาเมื่อมี SDK เวอร์ชันใหม่กว่า ดูข้อมูลเพิ่มเติมได้ที่ เวอร์ชันของ Driver SDK สำหรับ iOS

Swift Package Manager

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

สำคัญ: วิธีการเหล่านี้ถือว่าใช้ Xcode 15 ขึ้นไป แต่ควรจะคล้ายกัน สำหรับ Xcode เวอร์ชันก่อนหน้า

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

1. เปิด Xcode project หรือ workspace แล้วไปที่File > Add Package Dependencies
2. ป้อน https://github.com/googlemaps/ios-driver-sdk เป็น URL แล้วกด Enter เพื่อดึงแพ็กเกจ แล้วคลิก "เพิ่มแพ็กเกจ"
3. หากต้องการติดตั้ง version ที่เฉพาะเจาะจง ให้ตั้งค่าฟิลด์กฎการขึ้นต่อกันเป็นตัวเลือกใดตัวเลือกหนึ่ง ที่อิงตามเวอร์ชัน สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ระบุเวอร์ชันล่าสุดและ ใช้ตัวเลือก "เวอร์ชันที่แน่นอน" เมื่อดำเนินการเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ"

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

1. หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนการขึ้นต่อกันของแพ็กเกจในProject Navigator เพื่อยืนยันแพ็กเกจและเวอร์ชัน

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

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

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

   • GoogleRidesharingDriver.xcframework

2. จากไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Xcode ให้นำ GoogleRidesharingDriver bundle ออก

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

คู่มือนี้แสดงวิธีเพิ่ม XCFramework ที่มี Driver SDK ลงในโปรเจ็กต์ด้วยตนเองและกำหนดค่าการตั้งค่าบิลด์ใน Xcode

ข้อควรระวัง: แนวทางปฏิบัติแนะนำคือให้ใช้ Cocoapods เพื่อติดตั้ง Driver SDK ทุกครั้งที่เป็นไปได้

ก่อนทำตามคู่มือนี้ ให้ทำดังนี้

• ดาวน์โหลด XCFramework ซึ่งเป็นแพ็กเกจไบนารีที่คุณใช้เพื่อติดตั้ง Driver SDK คุณใช้แพ็กเกจนี้ได้ในหลายแพลตฟอร์ม รวมถึง เครื่องที่ใช้ Apple Silicon

• ติดตั้ง Navigation SDK

ทำตามขั้นตอนต่อไปนี้เพื่อติดตั้ง Driver SDK ด้วยตนเอง

1. ดาวน์โหลดไบนารีและทรัพยากรของ SDK

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

2. คลายซิปไฟล์เพื่อเข้าถึง XCFramework และทรัพยากร

3. เริ่ม Xcode แล้วเปิดโปรเจ็กต์ที่มีอยู่หรือสร้างโปรเจ็กต์ใหม่ หากคุณเพิ่งเริ่มใช้ iOS ให้สร้างโปรเจ็กต์ใหม่และเลือกเทมเพลตแอป iOS

4. หากกลุ่มโปรเจ็กต์ไม่มีกลุ่ม Frameworks ให้สร้างกลุ่มดังกล่าว

5. หากต้องการติดตั้ง Driver SDK ให้ลากไฟล์ GoogleRidesharingDriver.xcframework ไปยังโปรเจ็กต์ในส่วน เฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง หากมีข้อความแจ้ง ให้เลือก คัดลอกรายการ

6. ลาก GoogleRidesharingDriver.bundle ที่ดาวน์โหลดแล้วไปยังไดเรกทอรีระดับบนสุด ของโปรเจ็กต์ Xcode หากมีข้อความแจ้ง ให้เลือกคัดลอกรายการ

7. เลือกโปรเจ็กต์จากแถบนำทางของโปรเจ็กต์ แล้วเลือกเป้าหมายของแอปพลิเคชัน

8. เปิดแท็บขั้นตอนการสร้าง และในลิงก์ไบนารีกับไลบรารี ให้เพิ่มเฟรมเวิร์กและไลบรารีต่อไปนี้ หากยังไม่มี

   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libxml2.tbd
   • libz.tbd
   • LocalAuthentication.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • WebKit.framework

9. เลือกโปรเจ็กต์แทนที่จะเลือกเป้าหมายที่เฉพาะเจาะจง แล้วเปิดแท็บการตั้งค่า การสร้าง ในส่วน Other Linker Flags ให้เพิ่ม -ObjC สำหรับทั้งการดีบักและการเผยแพร่

   หากไม่เห็นการตั้งค่าเหล่านี้ ให้เปลี่ยนตัวกรองในแถบการตั้งค่าการสร้างจากพื้นฐานเป็นทั้งหมด

ตรวจสอบไฟล์ Manifest ด้านความเป็นส่วนตัวของ Apple

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

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

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

กำหนดค่าโปรเจ็กต์คอนโซล Google Cloud