ดาวน์โหลด Driver SDK

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

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

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

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

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

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

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

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

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

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

    เช่น แนวทางปฏิบัติแนะนำคือการตั้งชื่อกลุ่ม google-maps-platform-sdk-users@workspacedomain.comในระหว่างการเริ่มต้นใช้งาน

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

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

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

ลงชื่อเข้าใช้ด้วย 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 และเพิ่มการอ้างอิง ตัวอย่างที่รวมการอ้างอิงมีดังนี้

      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 พร้อมกับส่วนที่ใช้อ้างอิงที่อาจมี

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

Swift Package Manager

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

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

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

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

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

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

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

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

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

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

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

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

  • ติดตั้ง Navigation SDK

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

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

  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. เลือกโปรเจ็กต์แทนที่จะเลือกเป้าหมายที่เฉพาะเจาะจง แล้วเปิดแท็บการตั้งค่า การสร้าง ในส่วนแฟล็ก Linker อื่นๆ ให้เพิ่ม -ObjC สำหรับ ทั้งการแก้ไขข้อบกพร่องและการเผยแพร่

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

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

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

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

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

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