ส่วนนี้จะอธิบายวิธียืนยันว่าระบบของคุณเป็นไปตามข้อกำหนดขั้นต่ำ ตั้งค่ากลุ่ม Workspace และรับ Driver SDK
ก่อนเริ่มต้น
Driver SDK สำหรับ iOS กำหนดให้แอปของคุณต้องเป็นไปตามเกณฑ์ต่อไปนี้
- มี Navigation SDK
- เปิดใช้ Maps SDK สำหรับ iOS ใน Google Cloud Console และรับคีย์ API
ตรวจสอบข้อกำหนดขั้นต่ำของระบบ
ดูข้อกำหนดขั้นต่ำสำหรับ Driver SDK เวอร์ชันที่คุณใช้ได้ในหมายเหตุประจำรุ่น ดูบันทึกประจำรุ่น
- อุปกรณ์เคลื่อนที่ต้องใช้ iOS 14 ขึ้นไป
- Apple Xcode เวอร์ชัน 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
รับ Driver SDK
ติดตั้งและกำหนดค่า Driver SDK
CocoaPods
ติดตั้งเครื่องมือ CocoaPods: เปิดหน้าต่างเทอร์มินัลและเรียกใช้คำสั่งต่อไปนี้
sudo gem install cocoapods
ดูรายละเอียดเพิ่มเติมได้ในคู่มือเริ่มต้นใช้งาน CocoaPods
สร้าง Podfile สำหรับ Driver SDK: คุณใช้ Podfile เพื่อติดตั้ง API และการอ้างอิงของ API
สร้างไฟล์ชื่อ
Podfile
ในไดเรกทอรีโปรเจ็กต์ ไฟล์นี้กำหนดการขึ้นต่อกันของโปรเจ็กต์แก้ไข 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
บันทึก Podfile: เปิดเทอร์มินัลแล้วไปที่โฟลเดอร์ที่มี Podfile
cd <path-to-project>
เรียกใช้คำสั่ง pod install: คำสั่งนี้จะติดตั้ง API ที่ระบุใน Podfile พร้อมกับทรัพยากร Dependency ที่อาจมี
pod install
เปิดโปรเจ็กต์ใน Xcode: ปิด Xcode แล้วเปิด (ดับเบิลคลิก) ไฟล์ .xcworkspace ของโปรเจ็กต์เพื่อเปิด Xcode หากต้องการเปิดโปรเจ็กต์ในภายหลัง ให้ใช้ไฟล์ .xcworkspace
Swift Package Manager
คุณติดตั้ง Driver SDK ได้ผ่าน Swift Package Manager หากต้องการเพิ่ม SDK ให้ตรวจสอบว่าคุณได้ นำทรัพยากร Dependency ของ Driver SDK ที่มีอยู่ออกแล้ว
หากต้องการเพิ่ม SDK ลงในโปรเจ็กต์ใหม่หรือที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
-
เปิด Xcode
project
หรือworkspace
แล้วไปที่File > Add Package Dependencies - ป้อน https://github.com/googlemaps/ios-driver-sdk เป็น URL แล้วกด Enter เพื่อดึงแพ็กเกจ แล้วคลิก "เพิ่มแพ็กเกจ"
-
หากต้องการติดตั้ง
version
ที่เฉพาะเจาะจง ให้ตั้งค่าฟิลด์กฎการขึ้นต่อกันเป็นตัวเลือกใดตัวเลือกหนึ่ง ที่อิงตามเวอร์ชัน สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ระบุเวอร์ชันล่าสุดและ ใช้ตัวเลือก "เวอร์ชันที่แน่นอน" เมื่อดำเนินการเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ"
หากต้องการอัปเดต package
สำหรับโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
- หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนการขึ้นต่อกันของแพ็กเกจในProject Navigator เพื่อยืนยันแพ็กเกจและเวอร์ชัน
หากต้องการนำ Driver SDK ที่ติดตั้งไว้ด้วยตนเองออก ให้ทำตามขั้นตอนต่อไปนี้
จากการตั้งค่าการกำหนดค่าโปรเจ็กต์ Xcode ให้ค้นหาเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง ใช้เครื่องหมายลบ
(-)
เพื่อนำเฟรมเวิร์กต่อไปนี้ออกGoogleRidesharingDriver.xcframework
จากไดเรกทอรีระดับบนสุดของโปรเจ็กต์ Xcode ให้นำ
GoogleRidesharingDriver
bundle ออก
การติดตั้งด้วยตนเอง
คู่มือนี้แสดงวิธีเพิ่ม XCFramework ที่มี Driver SDK ลงในโปรเจ็กต์ด้วยตนเอง และวิธีกำหนดค่าการตั้งค่าบิลด์ใน Xcode
ก่อนทำตามคำแนะนำนี้ ให้ทำดังนี้
ดาวน์โหลด XCFramework ซึ่งเป็นแพ็กเกจไบนารีที่คุณใช้เพื่อติดตั้ง Driver SDK คุณใช้แพ็กเกจนี้ได้ในหลายแพลตฟอร์ม รวมถึง เครื่องที่ใช้ Apple Silicon
ติดตั้ง Navigation SDK
ทำตามขั้นตอนต่อไปนี้เพื่อติดตั้ง Driver SDK ด้วยตนเอง
ดาวน์โหลดไบนารีและทรัพยากรของ SDK
คลายซิปไฟล์เพื่อเข้าถึง XCFramework และทรัพยากร
เริ่ม Xcode แล้วเปิดโปรเจ็กต์ที่มีอยู่หรือสร้างโปรเจ็กต์ใหม่ หากคุณเพิ่งเริ่มใช้ iOS ให้สร้างโปรเจ็กต์ใหม่และเลือกเทมเพลตแอป iOS
หากกลุ่มโปรเจ็กต์ไม่มีกลุ่ม Framework ให้สร้างกลุ่มดังกล่าว
หากต้องการติดตั้ง Driver SDK ให้ลากไฟล์
GoogleRidesharingDriver.xcframework
ลงในโปรเจ็กต์ของคุณในส่วน Frameworks, Libraries, and Embedded Content หากมีข้อความแจ้ง ให้เลือก คัดลอกรายการลาก
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
เลือกโปรเจ็กต์แทนที่จะเลือกเป้าหมายที่เฉพาะเจาะจง แล้วเปิดแท็บการตั้งค่า บิลด์ ในส่วนแฟล็ก Linker อื่นๆ ให้เพิ่ม
-ObjC
สำหรับ ทั้งการแก้ไขข้อบกพร่องและการเผยแพร่หากไม่เห็นการตั้งค่าเหล่านี้ ให้เปลี่ยน ตัวกรองในแถบการตั้งค่าการสร้างจากพื้นฐานเป็นทั้งหมด
ตรวจสอบไฟล์ Manifest ด้านความเป็นส่วนตัวของ Apple
Apple กําหนดให้แอปใน App Store ต้องมีรายละเอียดความเป็นส่วนตัวของแอป ไปที่หน้ารายละเอียดความเป็นส่วนตัวของ Apple App Store เพื่อดูข้อมูลอัปเดตและข้อมูลเพิ่มเติม
ไฟล์ Apple Privacy Manifest จะรวมอยู่ในแพ็กเกจทรัพยากรสำหรับ SDK หากต้องการยืนยันว่าได้รวมไฟล์ Manifest ความเป็นส่วนตัวแล้ว และตรวจสอบเนื้อหาของไฟล์ ให้สร้างที่เก็บถาวรของแอปและสร้างรายงานความเป็นส่วนตัวจากที่เก็บถาวร
ขั้นตอนถัดไป
กำหนดค่าโปรเจ็กต์คอนโซล Google Cloud