ดาวน์โหลด Driver SDK

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

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

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

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

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

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

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

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

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

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

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

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

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

หากองค์กรของคุณสร้าง Workspace Group ไม่ได้ ให้ส่งอีเมลของผู้ใช้และบัญชีบริการที่ต้องการเข้าถึงรายการต่างๆ เหล่านี้ให้ 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 ในไดเรกทอรีโปรเจ็กต์ ไฟล์นี้จะกำหนดทรัพยากร Dependencies ของโปรเจ็กต์

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

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

      ต่อไปนี้คือตัวอย่างที่มีพ็อดรุ่นอัลฟ่าและเบต้าสำหรับ 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. เรียกใช้คำสั่งติดตั้งพ็อด: คำสั่งนี้จะติดตั้ง API ที่ระบุใน Podfile พร้อมกับทรัพยากร Dependency ต่างๆ ที่อาจมี

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

เครื่องมือจัดการแพ็กเกจ Swift

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

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

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

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

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

หากต้องการนํา 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. แตกไฟล์ ZIP เพื่อเข้าถึง XCFramework และทรัพยากร

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

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

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

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

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

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

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

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

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