รับ iOS Consumer SDK

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

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

ดูตัวอย่างได้ที่ตัวอย่างแอป 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 ที่มีอยู่ออก

สำคัญ: วิธีการเหล่านี้ขอสมมุติให้มีการใช้ Xcode 15 ขึ้นไป แต่ควรคล้ายกัน สำหรับ Xcode เวอร์ชันก่อนหน้า

หากต้องการเพิ่ม 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. หากกำลังอัปเกรดจากเวอร์ชันก่อน 9.0.0 คุณต้องนำออก ทรัพยากร Dependency ต่อไปนี้ GoogleMapsBase, GoogleMapsCore และ GoogleMapsM4B หลังจากอัปเกรด ไม่ต้องนำการอ้างอิงสำหรับ GoogleMaps สำหรับข้อมูลเพิ่มเติม โปรดดู บันทึกประจำรุ่นของเวอร์ชัน 9.0.0

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

   • GoogleMapsBase (สำหรับการอัปเกรดจากเวอร์ชันก่อน 9.0.0 เท่านั้น)
   • GoogleMapsCore (สำหรับการอัปเกรดจากเวอร์ชันก่อน 9.0.0 เท่านั้น)
   • GoogleMapsM4B (สำหรับการอัปเกรดจากเวอร์ชันก่อน 9.0.0 เท่านั้น)
2. จาก Xcode ให้ไปที่ "File > แพ็กเกจ > อัปเดตเป็นเวอร์ชันล่าสุดของแพ็กเกจ"
3. หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนการอ้างอิงแพ็กเกจของ Project Navigator เพื่อยืนยันแพ็กเกจและเวอร์ชันของแพ็กเกจ

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

หากต้องการนำทรัพยากร Dependency ของ Consumer SDK ที่มีอยู่ออกโดยใช้ CocoaPods ให้ทำตามขั้นตอนต่อไปนี้

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

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. นำ Podfile, Podfile.resolved และ Xcode workspace หากคุณไม่ได้ใช้สำหรับวัตถุประสงค์อื่นนอกเหนือจาก CocoaPods

วิธีนํา 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

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

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

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

ข้อควรระวัง: แนวทางปฏิบัติแนะนำคือ CocoaPods ที่จะติดตั้ง Consumer SDK เมื่อใดก็ตามที่ ที่เป็นไปได้

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

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

• ติดตั้ง Maps SDK

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

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

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