ดาวน์โหลด Driver SDK

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

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

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

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

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

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

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

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

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

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

    ตัวอย่างเช่น แนวทางปฏิบัติแนะนำคือตั้งชื่อกลุ่มขณะเริ่มต้นใช้งาน 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

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

สําหรับระบบบิลด์หรือการผสานรวมอย่างต่อเนื่อง ให้ตั้งค่าโฮสต์การทำงานอัตโนมัติตามรายการวิธีการที่ใช้บัญชีบริการเพื่อตรวจสอบสิทธิ์กับ API และบริการของ Google โปรดดูรายละเอียดที่ส่วนบัญชีบริการในหน้าวิธีการตรวจสอบสิทธิ์ของ 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 และทรัพยากรที่เกี่ยวข้อง

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

    2. แก้ไข Podfile และเพิ่ม 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. เรียกใช้คําสั่ง pod install: คําสั่งนี้จะติดตั้ง API ที่ระบุไว้ใน Podfile พร้อมกับข้อกําหนดซึ่งอาจเกี่ยวข้อง

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

Swift Package Manager

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

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

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

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

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

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

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