ดาวน์โหลด 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 และทรัพยากร Dependency

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

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

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

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

      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 ที่ API เหล่านั้นอาจมี

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

Swift Package Manager

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

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

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

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

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

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

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

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

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

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

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

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

  • ติดตั้ง Navigation SDK

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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