หัวข้อนี้จะอธิบายวิธียืนยันว่าระบบของคุณเป็นไปตามข้อกำหนดขั้นต่ำ ตั้งค่ากลุ่ม Workspace และรับ Driver SDK
ก่อนเริ่มต้น
Driver SDK สำหรับ iOS กำหนดให้แอปของคุณต้องเป็นไปตามเกณฑ์ต่อไปนี้
- มี Navigation SDK
- เปิดใช้ Maps SDK สำหรับ iOS ในคอนโซล Google Cloud และรับคีย์ API
ตรวจสอบข้อกำหนดขั้นต่ำของระบบ
ตรวจสอบบันทึกประจำรุ่นเพื่อดูข้อกำหนดขั้นต่ำสำหรับเวอร์ชันของ Driver SDK ที่คุณใช้อยู่ ดูบันทึกประจำรุ่น
- อุปกรณ์เคลื่อนที่ต้องใช้ iOS 14 ขึ้นไป
- Xcode ของ Apple เวอร์ชัน 15 ขึ้นไป
รับสิทธิ์เข้าถึง 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 Group
ดาวน์โหลด Driver SDK
ติดตั้งและกำหนดค่า Driver SDK
CocoaPods
ติดตั้งเครื่องมือ CocoaPods: เปิดหน้าต่างเทอร์มินัลและเรียกใช้ต่อไปนี้ คำสั่ง
sudo gem install cocoapods
โปรดดูรายละเอียดเพิ่มเติมในคู่มือเริ่มต้นใช้งาน CocoaPods
สร้าง Podfile สำหรับ Driver SDK: คุณใช้ Podfile ในการติดตั้ง API และทรัพยากร Dependency
สร้างไฟล์ชื่อ
Podfile
ในไดเรกทอรีโปรเจ็กต์ ไฟล์นี้ระบุทรัพยากร Dependency ของโปรเจ็กต์แก้ไข Podfile และเพิ่มการอ้างอิงของคุณ ลองดูตัวอย่างต่อไปนี้ มีทรัพยากร Dependency ต่อไปนี้
source "https://github.com/CocoaPods/Specs.git" target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleRidesharingDriver' end
ต่อไปนี้คือตัวอย่างที่มีพ็อดอัลฟ่าและเบต้าสำหรับ 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
บันทึก Podfile: เปิดเทอร์มินัลแล้วไปที่โฟลเดอร์ที่มี Podfile:
cd <path-to-project>
เรียกใช้คำสั่งติดตั้งพ็อด: คำสั่งนี้จะติดตั้ง API ที่ระบุไว้ใน Podfile พร้อมกับทรัพยากร Dependency ต่างๆ ที่อาจมี
pod install
เปิดโปรเจ็กต์ใน Xcode: ปิด Xcode แล้วเปิด (ดับเบิลคลิก) ไฟล์ .xcworkspace ของโครงการเพื่อเปิด Xcode เพื่อเปิด ในโปรเจ็กต์ในภายหลัง ให้ใช้ไฟล์ .xcworkspace
เครื่องมือจัดการแพ็กเกจ Swift
สามารถติดตั้ง Driver SDK ผ่าน Swift Package Manager หากต้องการเพิ่ม SDK โปรดตรวจสอบว่าคุณมี นำทรัพยากร Dependency ของ Driver SDK ที่มีอยู่ออกแล้ว
หากต้องการเพิ่ม SDK ลงในโปรเจ็กต์ใหม่หรือโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
-
เปิด Xcode
project
หรือworkspace
แล้วไปที่ ไฟล์ > เพิ่มทรัพยากร Dependency ของแพ็กเกจ - ป้อน https://github.com/googlemaps/ios-driver-sdk เป็น URL แล้วกด Enter เพื่อดึงข้อมูลแพ็กเกจ แล้วคลิก "เพิ่มแพ็กเกจ"
-
หากต้องการติดตั้ง
version
ที่เจาะจง ให้ตั้งค่าช่องกฎการขึ้นต่อกันเป็นค่าใดค่าหนึ่ง ตัวเลือกตามเวอร์ชัน สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ระบุเวอร์ชันล่าสุดและ โดยใช้ "เวอร์ชันที่แน่นอน" ตัวเลือก เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ" -
จากหน้าต่างเลือกผลิตภัณฑ์แพ็กเกจ ให้ยืนยันว่าจะเพิ่ม
GoogleRidesharingDriver
ไปยัง เป้าหมายmain
ที่คุณกำหนด เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ" -
หากต้องการยืนยันการติดตั้ง ให้ไปที่แผง
General
ของเป้าหมาย คุณควรเห็นแพ็กเกจที่ติดตั้งไว้ในเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง นอกจากนี้ คุณยังสามารถดู "ทรัพยากร Dependency ของแพ็กเกจ" ส่วนของ "Project Navigator" เพื่อยืนยันแพ็กเกจและเวอร์ชันของแพ็กเกจ
หากต้องการอัปเดต package
สำหรับโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
หากกำลังอัปเกรดจากเวอร์ชันก่อน 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 เท่านั้น)
- จาก Xcode ให้ไปที่ "File > แพ็กเกจ > อัปเดตเป็นเวอร์ชันล่าสุดของแพ็กเกจ"
- หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนการอ้างอิงแพ็กเกจของ Project Navigator เพื่อยืนยันแพ็กเกจและเวอร์ชันของแพ็กเกจ
หากต้องการนำทรัพยากร Dependency ของ Driver SDK ที่มีอยู่ออกด้วย
CocoaPods
ให้ทำตามขั้นตอนต่อไปนี้
- ปิดพื้นที่ทำงาน Xcode เปิดเทอร์มินัลและเรียกใช้คำสั่งต่อไปนี้
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
นำ
Podfile
,Podfile.resolved
และ Xcodeworkspace
หากคุณไม่ได้ใช้สำหรับวัตถุประสงค์อื่นนอกเหนือจาก CocoaPods
วิธีนำ Driver SDK ที่ติดตั้งไว้ออก ด้วยตนเอง ให้ทำตามขั้นตอนต่อไปนี้
จากการตั้งค่าการกำหนดค่าโปรเจ็กต์ Xcode ให้ค้นหา Frameworks ไลบรารีและเนื้อหาที่ฝัง ใช้เครื่องหมายลบ
(-)
เพื่อนำออก เฟรมเวิร์กต่อไปนี้GoogleRidesharingDriver.xcframework
จากไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Xcode ให้นำ แพ็กเกจ
GoogleRidesharingDriver
การติดตั้งด้วยตนเอง
คู่มือนี้จะแสดงวิธีเพิ่ม XCFramework ด้วยตนเองที่มี Driver SDK ในโปรเจ็กต์และกําหนดการตั้งค่าบิลด์ใน Xcode
ก่อนทำตามคู่มือนี้ โปรดดำเนินการต่อไปนี้
ดาวน์โหลด XCFramework ซึ่งเป็นแพ็กเกจไบนารีที่คุณใช้ติดตั้ง SDK ไดรเวอร์ คุณสามารถใช้แพ็กเกจนี้ได้ในหลายแพลตฟอร์ม รวมถึง เครื่องที่ใช้ Apple silicon
ติดตั้ง navigation SDK
ทําตามขั้นตอนต่อไปนี้เพื่อติดตั้ง Driver SDK ด้วยตนเอง
ดาวน์โหลดไบนารี SDK และทรัพยากร ดังนี้
แตกไฟล์ ZIP เพื่อเข้าถึง XCFramework และทรัพยากร
เริ่มต้น Xcode และเปิดโปรเจ็กต์ที่มีอยู่หรือสร้างโปรเจ็กต์ หากคุณ หากเพิ่งเริ่มใช้ iOS ให้สร้างโปรเจ็กต์ใหม่และเลือกเทมเพลตแอป iOS
หากกลุ่มโปรเจ็กต์ของคุณไม่มีกลุ่มเฟรมเวิร์ก ให้สร้างกลุ่มดังกล่าว
หากต้องการติดตั้ง Driver SDK ให้ลาก
GoogleRidesharingDriver.xcframework
ไฟล์ลงในโปรเจ็กต์ภายใต้ เฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง หากได้รับข้อความแจ้ง ให้เลือก คัดลอกรายการลาก
GoogleRidesharingDriver.bundle
ที่ดาวน์โหลดแล้วไปไว้ในระดับบนสุด ของโปรเจ็กต์ Xcode หากได้รับข้อความแจ้ง ให้เลือกคัดลอกรายการเลือกโปรเจ็กต์จาก Project Navigator แล้วเลือก ของแอปพลิเคชันเป้าหมาย
เปิดแท็บสร้างระยะ และในลิงก์ไบนารีกับไลบรารี ให้เพิ่มเมธอด เฟรมเวิร์กและไลบรารีต่อไปนี้หากยังไม่มี
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
เลือกโปรเจ็กต์แทนเป้าหมายเฉพาะ แล้วเปิด Build การตั้งค่า ในส่วนแฟล็กอื่นๆ ของ Linker ให้เพิ่ม
-ObjC
สำหรับ ทั้งแก้ไขข้อบกพร่องและรุ่นหากไม่เห็นการตั้งค่าเหล่านี้ ให้เปลี่ยน ในแถบการตั้งค่าการสร้างจากพื้นฐานเป็นทั้งหมด
ตรวจสอบไฟล์ Manifest ด้านความเป็นส่วนตัวของ Apple
Apple ต้องการรายละเอียดความเป็นส่วนตัวของแอปสำหรับแอปใน App Store ไปที่หน้ารายละเอียดความเป็นส่วนตัวของ Apple App Store เพื่อดูข้อมูลอัปเดตและข้อมูลเพิ่มเติม
ไฟล์ Manifest ด้านความเป็นส่วนตัวของ Apple จะรวมอยู่ในแพ็กเกจทรัพยากรของ SDK หากต้องการตรวจสอบว่าไฟล์ Manifest สำหรับความเป็นส่วนตัวรวมอยู่ในไฟล์แล้ว และต้องการตรวจสอบเนื้อหา ให้สร้างที่เก็บถาวรของแอปแล้วสร้างรายงานความเป็นส่วนตัวจากที่เก็บถาวร