รับ iOS Consumer SDK

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

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

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

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

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

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

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

รับ Consumer SDK

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

Swift Package Manager

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

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

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

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

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

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

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

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

ใช้ CocoaPods

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

    sudo gem install cocoapods
    

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

  2. สร้าง Podfile สําหรับ Consumer SDK: คุณใช้ Podfile เพื่อติดตั้ง API และทรัพยากรที่เกี่ยวข้อง

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

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

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

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

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

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

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

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

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

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

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

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

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

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