ส่วนนี้อธิบายวิธียืนยันว่าระบบเป็นไปตามข้อกำหนดขั้นต่ำ ตั้งค่ากลุ่ม Workspace และรับ Driver SDK
ก่อนเริ่มต้น
Driver SDK สำหรับ iOS กำหนดให้แอปของคุณต้องเป็นไปตามเกณฑ์ต่อไปนี้
- มี Navigation SDK
- เปิดใช้ Maps SDK สำหรับ iOS ในคอนโซล Google Cloud และรับคีย์ API
ตรวจสอบข้อกำหนดของระบบขั้นต่ำ
ดูหมายเหตุประจำรุ่นเพื่อดูข้อกำหนดขั้นต่ำสำหรับ Driver SDK เวอร์ชันที่คุณใช้ ดูบันทึกประจำรุ่น
- อุปกรณ์เคลื่อนที่ต้องใช้ iOS 16 ขึ้นไป
- Apple Xcode เวอร์ชัน 26 ขึ้นไป
รับสิทธิ์เข้าถึง Google Workspace
หากคุณเป็นลูกค้า Google Workspace ให้ทำตามขั้นตอนต่อไปนี้
สร้างกลุ่ม Workspace ดูข้อมูลเพิ่มเติมได้ที่กลุ่ม Workspace
เช่น แนวทางปฏิบัติแนะนำคือการตั้งชื่อกลุ่ม
google-maps-platform-sdk-users@workspacedomain.comในระหว่างการเริ่มต้นใช้งานระบุชื่อให้ Google เพื่อเพิ่มกลุ่ม Workspace ของคุณลงในรายการที่อนุญาตซึ่ง ให้สิทธิ์เข้าถึงที่เก็บ CocoaPods ที่ถูกต้อง
ยืนยันว่าอีเมลผู้ใช้และอีเมลบัญชีบริการที่ต้องมีสิทธิ์เข้าถึงอยู่ในรายการนี้
หากองค์กรสร้างกลุ่ม Workspace ไม่ได้ ให้ส่งรายชื่ออีเมลบัญชีผู้ใช้และบัญชีบริการที่ต้องมีสิทธิ์เข้าถึงอาร์ติแฟกต์เหล่านี้ให้ Google
ลงชื่อเข้าใช้ด้วย Cloud SDK
สำหรับการพัฒนาในเครื่อง ให้ลงชื่อเข้าใช้ด้วย Cloud SDK โปรดดูรายละเอียดที่หัวข้อติดตั้ง gcloud CLI
ตัวอย่างต่อไปนี้แสดงวิธีลงชื่อเข้าใช้ด้วย Cloud SDK
gcloud
gcloud auth login
คุณต้องใช้อีเมลที่เป็นสมาชิกของกลุ่ม Workspace
ตั้งค่าโฮสต์การทำงานอัตโนมัติ
สำหรับระบบบิลด์หรือการรวมอย่างต่อเนื่อง ให้ตั้งค่าโฮสต์การทำงานอัตโนมัติตามรายการวิธีการที่ระบุไว้สำหรับการใช้บัญชีบริการเพื่อตรวจสอบสิทธิ์กับ Google APIs และบริการ โปรดดูรายละเอียดที่ส่วนบัญชีบริการ ในหน้าวิธีการตรวจสอบสิทธิ์ที่ Google
หากกระบวนการทำงานภายในสภาพแวดล้อม Google Cloud ให้ใช้ การตรวจหาข้อมูลเข้าสู่ระบบอัตโนมัติ ดูข้อมูลเพิ่มเติมได้ที่การตรวจหาข้อมูลเข้าสู่ระบบอัตโนมัติ
หรือจะจัดเก็บไฟล์คีย์บัญชีบริการไว้ในตำแหน่งที่ปลอดภัยในระบบไฟล์ของโฮสต์ และตั้งค่าตัวแปรสภาพแวดล้อม GOOGLE_APPLICATION_CREDENTIALS ให้เหมาะสมก็ได้ ดูรายละเอียดเพิ่มเติมได้ที่ GOOGLE_APPLICATION_CREDENTIALS
อีเมลของบัญชีบริการที่เชื่อมโยงกับข้อมูลเข้าสู่ระบบต้องเป็นสมาชิกของกลุ่ม Workspace
รับ Driver SDK
ติดตั้งและกำหนดค่า Driver SDK
CocoaPods
ติดตั้งเครื่องมือ CocoaPods: เปิดหน้าต่างเทอร์มินัลและเรียกใช้คำสั่งต่อไปนี้
sudo gem install cocoapodsโปรดดูรายละเอียดเพิ่มเติมที่คู่มือเริ่มต้นใช้งาน CocoaPods
สร้าง Podfile สำหรับ Driver SDK: คุณใช้ Podfile เพื่อติดตั้ง API และการอ้างอิงของ API
สร้างไฟล์ชื่อ
Podfileในไดเรกทอรีโปรเจ็กต์ ไฟล์นี้จะกำหนดการขึ้นต่อกันของโปรเจ็กต์แก้ไข Podfile และเพิ่มการอ้างอิง ตัวอย่างที่รวมการอ้างอิงมีดังนี้
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บันทึก Podfile: เปิดเทอร์มินัลแล้วไปที่โฟลเดอร์ที่มี Podfile
cd <path-to-project>
เรียกใช้คำสั่ง pod install: คำสั่งนี้จะติดตั้ง API ที่ระบุไว้ใน Podfile พร้อมกับส่วนที่ใช้อ้างอิงที่อาจมี
pod installเปิดโปรเจ็กต์ใน Xcode: ปิด Xcode แล้วเปิด (ดับเบิลคลิก) ไฟล์ .xcworkspace ของโปรเจ็กต์เพื่อเปิด Xcode หากต้องการเปิดโปรเจ็กต์ในภายหลัง ให้ใช้ไฟล์ .xcworkspace
Swift Package Manager
คุณติดตั้ง Driver SDK ได้ผ่าน Swift Package Manager หากต้องการเพิ่ม SDK ให้ตรวจสอบว่าคุณได้ นำทรัพยากร Dependency ของ Driver SDK ที่มีอยู่ออกแล้ว
หากต้องการเพิ่ม SDK ลงในโปรเจ็กต์ใหม่หรือโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
-
เปิด Xcode
projectหรือworkspaceแล้วไปที่ไฟล์ > เพิ่มการขึ้นต่อกันของแพ็กเกจ - ป้อน https://github.com/googlemaps/ios-driver-sdk เป็น URL แล้วกด Enter เพื่อดึงแพ็กเกจ แล้วคลิก "เพิ่มแพ็กเกจ"
-
หากต้องการติดตั้ง
versionที่เฉพาะเจาะจง ให้ตั้งค่าฟิลด์กฎการขึ้นต่อกันเป็นตัวเลือกใดตัวเลือกหนึ่ง ที่อิงตามเวอร์ชัน สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ระบุเวอร์ชันล่าสุดและ ใช้ตัวเลือก "เวอร์ชันที่แน่นอน" เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ" -
จากหน้าต่างเลือกผลิตภัณฑ์ในแพ็กเกจ ให้ตรวจสอบว่าระบบจะเพิ่ม
GoogleRidesharingDriverลงในmainเป้าหมายที่กำหนด เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ" - หากต้องการยืนยันการติดตั้ง ให้ไปที่แผงทั่วไปของเป้าหมาย ในเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง คุณควรเห็นแพ็กเกจที่ติดตั้ง นอกจากนี้ คุณยังดูส่วน "การขึ้นต่อกันของแพ็กเกจ" ใน "Project Navigator" เพื่อยืนยันแพ็กเกจและเวอร์ชันของแพ็กเกจได้ด้วย
หากต้องการอัปเดต package สำหรับโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
- จาก Xcode ให้ไปที่ไฟล์ > แพ็กเกจ > อัปเดตเป็นแพ็กเกจเวอร์ชันล่าสุด
- หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนการขึ้นต่อกันของแพ็กเกจในProject Navigator เพื่อยืนยันแพ็กเกจและเวอร์ชัน
หากต้องการนำ Driver SDK ที่ติดตั้งไว้ด้วยตนเองออก ให้ทำตามขั้นตอนต่อไปนี้
จากการตั้งค่าการกำหนดค่าโปรเจ็กต์ Xcode ให้ค้นหาเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง ใช้เครื่องหมายลบ
(-)เพื่อนำเฟรมเวิร์กต่อไปนี้ออกGoogleRidesharingDriver.xcframework
จากไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Xcode ให้นำ
GoogleRidesharingDriverbundle ออก
การติดตั้งด้วยตนเอง
คู่มือนี้แสดงวิธีเพิ่ม XCFramework ที่มี Driver SDK ลงในโปรเจ็กต์ด้วยตนเอง และวิธีกำหนดการตั้งค่าบิลด์ใน Xcode
ก่อนทำตามคำแนะนำนี้ ให้ทำดังนี้
ดาวน์โหลด XCFramework ซึ่งเป็นแพ็กเกจไบนารีที่คุณใช้เพื่อติดตั้ง Driver SDK คุณใช้แพ็กเกจนี้ได้ในหลายแพลตฟอร์ม รวมถึง เครื่องที่ใช้ Apple Silicon
ติดตั้ง Navigation SDK
ทำตามขั้นตอนต่อไปนี้เพื่อติดตั้ง Driver SDK ด้วยตนเอง
ดาวน์โหลดไบนารีและทรัพยากร SDK
คลายซิปไฟล์เพื่อเข้าถึง XCFramework และทรัพยากร
เริ่ม Xcode แล้วเปิดโปรเจ็กต์ที่มีอยู่หรือสร้างโปรเจ็กต์ใหม่ หากคุณเพิ่งเริ่มใช้ iOS ให้สร้างโปรเจ็กต์ใหม่และเลือกเทมเพลตแอป iOS
หากกลุ่มโปรเจ็กต์ไม่มีกลุ่ม Frameworks ให้สร้างกลุ่มดังกล่าว
หากต้องการติดตั้ง Driver SDK ให้ลากไฟล์
GoogleRidesharingDriver.xcframeworkไปยังโปรเจ็กต์ในส่วน เฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง หากมีข้อความแจ้ง ให้เลือก คัดลอกรายการลาก
GoogleRidesharingDriver.bundleที่ดาวน์โหลดแล้วไปยังไดเรกทอรีระดับบนสุด ของโปรเจ็กต์ Xcode หากมีข้อความแจ้ง ให้เลือกคัดลอกรายการเลือกโปรเจ็กต์จากแถบนำทางของโปรเจ็กต์ แล้วเลือกเป้าหมายของแอปพลิเคชัน
เปิดแท็บขั้นตอนการสร้าง แล้วเพิ่มเฟรมเวิร์กและไลบรารีต่อไปนี้ในลิงก์ไบนารีกับไลบรารี หากยังไม่มี
Accelerate.frameworkAudioToolbox.frameworkAVFoundation.frameworkCoreData.frameworkCoreGraphics.frameworkCoreLocation.frameworkCoreTelephony.frameworkCoreText.frameworkGLKit.frameworkImageIO.frameworklibc++.tbdlibxml2.tbdlibz.tbdLocalAuthentication.frameworkOpenGLES.frameworkQuartzCore.frameworkSystemConfiguration.frameworkUIKit.frameworkWebKit.framework
เลือกโปรเจ็กต์แทนที่จะเลือกเป้าหมายที่เฉพาะเจาะจง แล้วเปิดแท็บการตั้งค่า การสร้าง ในส่วนแฟล็ก Linker อื่นๆ ให้เพิ่ม
-ObjCสำหรับ ทั้งการแก้ไขข้อบกพร่องและการเผยแพร่หากไม่เห็นการตั้งค่าเหล่านี้ ให้เปลี่ยนตัวกรองในแถบการตั้งค่าการสร้างจากพื้นฐานเป็นทั้งหมด
ตรวจสอบไฟล์ Manifest ด้านความเป็นส่วนตัวของ Apple
Apple กำหนดให้แอปใน App Store ต้องมีรายละเอียดความเป็นส่วนตัวของแอป ดูข้อมูลอัปเดตและข้อมูลเพิ่มเติมได้ที่หน้ารายละเอียดความเป็นส่วนตัวของ Apple App Store
ไฟล์ Apple Privacy Manifest จะรวมอยู่ในแพ็กเกจทรัพยากรสำหรับ SDK หากต้องการยืนยันว่าได้รวมไฟล์ Privacy Manifest แล้ว และต้องการตรวจสอบเนื้อหา ให้สร้างที่เก็บถาวรของแอปและสร้างรายงานความเป็นส่วนตัวจากที่เก็บถาวร
ขั้นตอนถัดไป
กำหนดค่าโปรเจ็กต์คอนโซล Google Cloud