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