ทีม Google Maps Platform อัปเดต SDK ให้มีฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง และ เพื่อปรับปรุงประสิทธิภาพ หน้านี้จะมีคำแนะนำเกี่ยวกับวิธีจัดการทรัพยากร Dependency เกี่ยวกับ SDK อุปกรณ์เคลื่อนที่
จะลิงก์กับเวอร์ชันใด
-
สำหรับแอปที่สำคัญต่อพันธกิจ ให้ลิงก์ไปยังการเผยแพร่ของจุดล่าสุด เวอร์ชันที่คุณใช้งานอยู่ (X.*) และอัปเกรดรายปีเป็นเวอร์ชันหลักใหม่
ขณะที่คุณเผยแพร่แอปพลิเคชันเวอร์ชันใหม่ คุณอาจเริ่มใช้ Driver SDK เวอร์ชันใหม่สำหรับ iOS ได้ตลอดทั้งปี การดำเนินการนี้จะ คุณไม่จำเป็นต้องอัปเดตในแอปพลิเคชันเนื่องจากจุดเวอร์ชันใหม่เข้ากันได้แบบย้อนหลัง
ข้อดี
- หากคุณพบปัญหาใน Driver SDK สำหรับ iOS จะมีการแก้ไขใน ที่เข้ากันได้แบบย้อนหลังเป็นเวลา 12 เดือนหลังจากการเปิดตัวเวอร์ชันหลักเป็นครั้งแรกตาม การสนับสนุนสำหรับอุปกรณ์เคลื่อนที่ คุณไม่จำเป็นต้องอัปเกรดเป็น SDK เวอร์ชันที่ใช้ร่วมกันไม่ได้โดยด่วน เพื่อใช้ประโยชน์จากการแก้ไข
- คุณจะนำการปรับปรุงและฟีเจอร์ล่าสุดไปใช้งานได้ง่ายเมื่อมีการสร้างแอปอยู่แล้ว เวอร์ชันล่าสุด
- การอัปเดต SDK เวอร์ชันหลักเวอร์ชันล่าสุดที่เพิ่มขึ้นรายปีอาจต้องใช้การทำงานน้อยลง เพื่อปรับตัว เขียนใหม่ และทดสอบแอปพลิเคชันของคุณ การเปลี่ยนแปลงที่เกิดขึ้นในรุ่นหลักหลายรุ่น
สำหรับแอปที่ไม่สำคัญ ให้ลิงก์ไปยังเวอร์ชันที่แก้ไขแล้ว เมื่อคุณได้รับการเลิกใช้งาน สำหรับเวอร์ชันที่แก้ไขแล้ว คุณจะมีเวลา 12 เดือนในการทำให้โค้ดแอปที่อัปเดตพร้อมใช้งานสำหรับ ผู้ใช้ของคุณ
ข้อดี
- มีงานบำรุงรักษาน้อยกว่า
- แอปเวอร์ชันใหม่ของคุณรองรับผู้ใช้อยู่เสมอ อุปกรณ์ที่ใช้งานโทรศัพท์มือถือรุ่นเก่า ระบบเป็นเวลานานขึ้น (จนกว่าคุณจะต้องอัปเกรดเป็น SDK เวอร์ชันใหม่)
เจ้าของโปรเจ็กต์ซึ่งมีอีเมลที่ตรวจสอบแล้วจะได้รับการแจ้งเตือนเชิงรุกเกี่ยวกับการเปลี่ยนแปลงที่ ส่งผลต่อแต่ละโปรเจ็กต์ของพวกเขาอย่างไร อยู่ต่อ แจ้งเกี่ยวกับการอัปเดตที่สำคัญ การเลิกใช้งาน และการเปลี่ยนแปลงอื่นๆ
การติดตั้ง
ระบุหมายเลขเวอร์ชันในทรัพยากร Dependency เสมอแทนการใช้หมายเลขเวอร์ชัน
โอเปอเรเตอร์แบบเพิ่มประสิทธิภาพ (~>) เนื่องจากอาจทำให้เกิดการคาดการณ์และ
บิลด์ที่ไม่สามารถทำซ้ำได้ Driver SDK สำหรับ iOS ปฏิบัติตาม
การกำหนดเวอร์ชันเชิงความหมาย และการเผยแพร่เวอร์ชันหลักใหม่
รวมการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
CocoaPods
ตัวอย่างการใช้ Podfile Dependency ที่ใช้ไวยากรณ์ Podfile ดังนี้
source "https://github.com/CocoaPods/Specs.git"
target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
pod 'GoogleRidesharingDriver', '2.0.0'
end
เครื่องมือจัดการแพ็กเกจ 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 สำหรับโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
- จาก Xcode ให้ไปที่ "File > แพ็กเกจ > อัปเดตเป็นเวอร์ชันล่าสุดของแพ็กเกจ"
- หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนการอ้างอิงแพ็กเกจของ Project Navigator เพื่อยืนยันแพ็กเกจและเวอร์ชันของแพ็กเกจ
การบำรุงรักษาและการอัปเกรด
หากต้องการสร้างด้วยการปรับปรุงล่าสุด ให้หมั่นตรวจสอบหาเวอร์ชันที่ใหม่กว่าและ อัปเดตข้อกำหนดเวอร์ชัน หากคุณกำลังอัปเดตเป็นเวอร์ชันหลักใหม่ ตรวจสอบ บันทึกประจำรุ่น เพื่อดูการเปลี่ยนแปลงที่เข้ากันไม่ได้กับเวอร์ชันก่อนและวิธีอัปเดตโค้ด
Cocoapods
-
เปิดเทอร์มินัลและไปที่ไดเรกทอรีที่มี
Podfile:cd <path-to-project>
- เรียกใช้
pod outdatedเพื่อดูว่าเวอร์ชันที่ใหม่กว่าของ Driver SDK สำหรับ iOS พร้อมใช้งานแล้ว - หากพบ SDK เวอร์ชันใหม่ ให้อัปเดต
Podfileเป็นเวอร์ชันใหม่นี้ ดูการระบุเวอร์ชันพ็อด เพื่อดูวิธีการตั้งค่าเวอร์ชันที่เฉพาะเจาะจงในPodfile - เรียกใช้
pod update - ทำการเปลี่ยนแปลงที่จำเป็นซึ่งเป็นผลมาจากการอัปเกรด โปรดดู บันทึกประจำรุ่นสำหรับรายการการเปลี่ยนแปลงในแต่ละรุ่น
- ล้างและสร้างโปรเจ็กต์ใหม่โดยเลือกผลิตภัณฑ์ > ล้าง จากนั้น ผลิตภัณฑ์ > สร้าง
การติดตั้งด้วยตนเอง
รับลิงก์ไปยังไฟล์ต้นฉบับล่าสุด ในการติดตั้ง SDK
นอกจากการสำรวจแอปเวอร์ชันใหม่แล้ว Google Cloud โปรเจ็กต์ เจ้าของจะได้รับอีเมลเกี่ยวกับการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลังซึ่งอาจส่งผลต่อโปรเจ็กต์ของตน ถึง รับการแจ้งเตือนเชิงรุกเกี่ยวกับการเปลี่ยนแปลง ที่เข้ากันไม่ได้แบบย้อนหลัง มอบหมาย บทบาทเจ้าของที่มีอีเมลที่ตรวจสอบสำหรับแต่ละโปรเจ็กต์