รับ iOS Consumer SDK

เลือกแพลตฟอร์ม แอนดรอยด์ iOS JavaScript

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

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

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

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

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

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

รับ SDK ของผู้บริโภค

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

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

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

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

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

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

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

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

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

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

ใช้ CocoaPods

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

    sudo gem install cocoapods
    

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

  2. สร้าง Podfile สำหรับ SDK ของผู้บริโภค: คุณ ใช้ Podfile เพื่อติดตั้ง API และทรัพยากร Dependency

    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 ด้วยตนเองที่มี SDK ของผู้บริโภคไปยังโปรเจ็กต์และกําหนดการตั้งค่าบิลด์ใน Xcode

ก่อนทำตามคู่มือนี้ โปรดดำเนินการต่อไปนี้

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

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

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

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

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

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

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