ดาวน์โหลด Driver SDK

gcloud

gcloud auth login

CocoaPods

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

   sudo gem install cocoapods
   

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

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

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

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

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

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

      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 ที่ API เหล่านั้นอาจมี

   pod install
   

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

Swift Package Manager

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

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

1. เปิด project หรือ workspace ของ Xcode แล้วไปที่ File > Add Package Dependencies
2. ป้อน https://github.com/googlemaps/ios-driver-sdk เป็น URL กด Enter เพื่อดึงแพ็กเกจ และคลิก "Add Package"
3. หากต้องการติดตั้ง version ที่เฉพาะเจาะจง ให้ตั้งค่าช่องDependency Rule เป็นตัวเลือกใดตัวเลือกหนึ่งที่อิงตามเวอร์ชัน สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ระบุเวอร์ชันล่าสุดและ ใช้ตัวเลือก "Exact Version" เมื่อเสร็จแล้ว ให้คลิก "Add Package"
4. จากหน้าต่าง Choose Package Products ให้ตรวจสอบว่าระบบจะเพิ่ม GoogleRidesharingDriver ลงใน เป้าหมาย main ที่คุณกำหนด เมื่อเสร็จแล้ว ให้คลิก "Add Package"
5. หากต้องการยืนยันการติดตั้ง ให้ไปที่บานหน้าต่างGeneral ของเป้าหมาย คุณควรเห็นแพ็กเกจที่ติดตั้งในส่วนFrameworks, Libraries, and Embedded Content นอกจากนี้ คุณยังดูส่วน "Package Dependencies" ของ "Project Navigator" เพื่อยืนยันแพ็กเกจและเวอร์ชันได้ด้วย

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

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

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

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

   • 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. คลายซิปไฟล์เพื่อเข้าถึง XCFramework และทรัพยากร

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

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

5. หากต้องการติดตั้ง Driver SDK ให้ลากไฟล์ GoogleRidesharingDriver.xcframework ไปยังโปรเจ็กต์ในส่วนFrameworks, Libraries, and Embedded Content หากมีข้อความแจ้ง ให้เลือกคัดลอกรายการ

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

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

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

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

   หากไม่เห็นการตั้งค่าเหล่านี้ ให้เปลี่ยนตัวกรองในแถบ Build Settings จากBasic เป็นAll