ดาวน์โหลด Driver SDK

gcloud

gcloud auth login

CocoaPods

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

   sudo gem install cocoapods
   

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

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

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

   2. แก้ไข Podfile และเพิ่มการอ้างอิง ตัวอย่างที่มีทรัพยากร Dependency มีดังนี้

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

      ต่อไปนี้คือตัวอย่างที่มีพ็อด Alpha และ Beta สำหรับ Driver SDK เป็นการอ้างอิง

      source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git"
      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

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

      cd <path-to-project>
      

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

   pod install
   

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

Swift Package Manager

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

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

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

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

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

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

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

   • GoogleRidesharingDriver.xcframework

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

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

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

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

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

• ติดตั้ง Navigation SDK

ทำตามขั้นตอนต่อไปนี้เพื่อติดตั้ง Driver SDK ด้วยตนเอง

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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

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

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

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

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

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

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

   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libxml2.tbd
   • libz.tbd
   • LocalAuthentication.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • WebKit.framework

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

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