รับ iOS Consumer SDK

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

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

ดูตัวอย่างได้ที่แอปตัวอย่าง iOS หรือ ตัวอย่างที่รวมกัน

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

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

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

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

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

รับ Consumer SDK

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

Swift Package Manager

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

สำคัญ: คำสั่งเหล่านี้ถือว่าใช้ Xcode 15 ขึ้นไป แต่ควรจะคล้ายกัน สำหรับ Xcode เวอร์ชันก่อนหน้า

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

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

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

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

สำคัญ: บางครั้งอาจแก้ปัญหาอาร์ติแฟกต์ไม่ได้หรืออาจเกิดข้อผิดพลาด ในกรณีนี้ ให้เลือก "ไฟล์ > แพ็กเกจ > รีเซ็ตแคชแพ็กเกจ"

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

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

   • GoogleRidesharingConsumer.xcframework

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

ใช้ CocoaPods

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

   sudo gem install cocoapods
   

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

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

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

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

   pod install
   

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

   หมายเหตุ: เรียกใช้ pod outdated เป็นระยะๆ เพื่อตรวจหาเมื่อมี SDK เวอร์ชันใหม่กว่า ดูข้อมูลเพิ่มเติมได้ที่ เวอร์ชัน Consumer SDK ในหมายเหตุประจำรุ่นของ Consumer SDK

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

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

ข้อควรระวัง: แนวทางปฏิบัติแนะนำคือให้ใช้ Cocoapods เพื่อติดตั้ง Consumer SDK ทุกครั้งที่ เป็นไปได้

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

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

• ติดตั้ง Maps SDK

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

   • GoogleRidesharingConsumer.xcframework
   • GoogleRidesharingConsumer.bundle
   • gRPCCertificates.bundle

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

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

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

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

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

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

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

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

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

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

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

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

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

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