รับ iOS Consumer SDK

เลือกแพลตฟอร์ม: Android iOS JavaScript

หากต้องการติดตามการเดินทางแบบออนดีมานด์ในแอปผู้บริโภค iOS ให้ใช้ Consumer SDK ดูข้อมูลเพิ่มเติมและข้อมูลเบื้องต้นเกี่ยวกับการติดตามการเดินทางได้ที่ติดตามการเดินทางใน iOS

หากต้องการตั้งค่า Consumer SDK สำหรับแอปผู้บริโภค iOS ให้ทำตามขั้นตอนต่อไปนี้

  1. ตรวจสอบข้อกำหนดของระบบขั้นต่ำ
  2. ดาวน์โหลด Consumer SDK
  3. ตรวจสอบไฟล์ Manifest ด้านความเป็นส่วนตัวของ Apple
  4. กำหนดค่าโปรเจ็กต์คอนโซล Google Cloud
  5. รับโทเค็นการตรวจสอบสิทธิ์
  6. เริ่มต้นใช้งาน Consumer SDK

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

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

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

ดาวน์โหลด Consumer SDK

คุณติดตั้งและกำหนดค่า Consumer SDK ด้วย CocoaPods

Swift Package Manager

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

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

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

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

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

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

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

    • GoogleRidesharingConsumer.xcframework

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

ใช้ CocoaPods

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

    sudo gem install cocoapods

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

  2. สร้าง Podfile สำหรับ Consumer 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 'GoogleRidesharingConsumer'
end

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

      cd <path-to-project>

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

    pod install

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

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

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

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

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

  • ติดตั้ง Maps SDK

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

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

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

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

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

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

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

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

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

    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework

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

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

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

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

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

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

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