ทีม Google Maps Platform จะอัปเดต SDK เป็นประจำด้วยฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง และการปรับปรุงประสิทธิภาพ หน้านี้จะให้คำแนะนำเกี่ยวกับวิธีจัดการทรัพยากร Dependency ใน SDK บนอุปกรณ์เคลื่อนที่
ลิงก์กับเวอร์ชันใด
-
สำหรับแอปที่มีความสำคัญต่อภารกิจ ให้ลิงก์กับเวอร์ชันย่อยล่าสุดของเวอร์ชันหลักที่คุณใช้อยู่ (X.*) และอัปเกรดเป็นเวอร์ชันหลักใหม่ทุกปี
เมื่อเปิดตัวแอปพลิเคชันเวอร์ชันใหม่ตลอดทั้งปี คุณอาจเริ่มใช้ Driver SDK สำหรับ iOS เวอร์ชันย่อยที่ใหม่กว่า การดำเนินการนี้ไม่จำเป็นต้องมีการอัปเดตในแอปพลิเคชันของคุณ เนื่องจากเวอร์ชันย่อยใหม่จะเข้ากันได้แบบย้อนหลัง
ข้อดี
- หากพบปัญหาใน Driver SDK สำหรับ iOS เราจะแก้ไขปัญหาในลักษณะที่เข้ากันได้แบบย้อนหลังเป็นเวลา 12 เดือนหลังจากการเปิดตัวเวอร์ชันหลักครั้งแรก ตามนโยบายการสนับสนุนอุปกรณ์เคลื่อนที่ คุณไม่จำเป็นต้องอัปเกรดเป็น SDK เวอร์ชันที่ไม่เข้ากันอย่างเร่งด่วนเพื่อรับประโยชน์จากการแก้ไข
- การปรับปรุงและฟีเจอร์ล่าสุดจะนำไปใช้ได้ง่ายเมื่อแอปของคุณสร้างขึ้นในเวอร์ชันล่าสุดอยู่แล้ว
- การอัปเดต SDK เวอร์ชันหลักใหม่ล่าสุดที่เพิ่มขึ้นทุกปีอาจต้องใช้การปรับเปลี่ยน เขียนใหม่ และทดสอบแอปพลิเคชันน้อยกว่าการจัดการกับการเปลี่ยนแปลงที่ไม่เข้ากันแบบย้อนหลังซึ่งเปิดตัวในเวอร์ชันหลักหลายๆ เวอร์ชัน
สำหรับแอปที่ไม่สำคัญ ให้ลิงก์ไปยังเวอร์ชันที่แก้ไขแล้ว เมื่อได้รับการแจ้งเตือนการเลิกใช้งานสำหรับเวอร์ชันที่แก้ไขแล้ว คุณจะมีเวลา 12 เดือนในการทำให้โค้ดแอปที่อัปเดตพร้อมใช้งานสำหรับผู้ใช้
ข้อดี
- งานบำรุงรักษาที่ถี่น้อยลง
- แอปเวอร์ชันใหม่จะยังคงรองรับอุปกรณ์ของผู้ใช้ที่ใช้ระบบปฏิบัติการบนอุปกรณ์เคลื่อนที่เวอร์ชันก่อนหน้าได้นานขึ้น (จนกว่าคุณจะต้องอัปเกรดเป็น SDK เวอร์ชันใหม่)
เจ้าของโปรเจ็กต์ที่มีอีเมลที่ได้รับการตรวจสอบจะได้รับการแจ้งเตือนเชิงรุกเกี่ยวกับการเปลี่ยนแปลงที่ส่งผลต่อโปรเจ็กต์แต่ละรายการ รับทราบข้อมูลเกี่ยวกับการอัปเดตหลัก การเลิกใช้งาน และการเปลี่ยนแปลงอื่นๆ
การติดตั้ง
ระบุหมายเลขเวอร์ชันในการขึ้นต่อกันเสมอแทนการใช้โอเปอเรเตอร์แบบมองโลกในแง่ดี (~>) เนื่องจากอาจทำให้เกิดบิลด์ที่คาดเดาไม่ได้และทำซ้ำไม่ได้ Driver SDK สำหรับ iOS เป็นไปตามการกำหนดเวอร์ชันเชิงความหมาย และการเปิดตัวเวอร์ชันหลักใหม่จะรวมการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
CocoaPods
ตัวอย่างทรัพยากร Dependency ของ Podfile ที่ใช้ไวยากรณ์ Podfile
source "https://github.com/CocoaPods/Specs.git"
target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
pod 'GoogleRidesharingDriver', '2.0.0'
end
Swift Package Manager
คุณติดตั้ง Driver SDK ได้ผ่าน Swift Package Manager หากต้องการเพิ่ม SDK ให้ตรวจสอบว่าคุณได้นำทรัพยากร Dependency ของ Driver SDK ที่มีอยู่ออกแล้ว
หากต้องการเพิ่ม SDK ลงในโปรเจ็กต์ใหม่หรือโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
-
เปิด Xcode
projectหรือworkspaceแล้วไปที่ไฟล์ > เพิ่มทรัพยากร Dependency ของแพ็กเกจ - ป้อน https://github.com/googlemaps/ios-driver-sdk เป็น URL แล้วกด Enter เพื่อดึงแพ็กเกจเข้ามา แล้วคลิก "Add Package"
-
หากต้องการติดตั้ง
versionที่เฉพาะเจาะจง ให้ตั้งค่าช่องกฎการขึ้นต่อกันเป็นตัวเลือกตามเวอร์ชันตัวเลือกใดตัวเลือกหนึ่ง สําหรับโปรเจ็กต์ใหม่ เราขอแนะนําให้ระบุเวอร์ชันล่าสุดและใช้ตัวเลือก "เวอร์ชันที่แน่นอน" เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ" -
จากหน้าต่างเลือกผลิตภัณฑ์แพ็กเกจ ให้ยืนยันว่าระบบจะเพิ่ม
GoogleRidesharingDriverลงในเป้าหมายmainที่กำหนด เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ" - หากต้องการยืนยันการติดตั้ง ให้ไปที่แผงทั่วไปของเป้าหมาย ใน Frameworks, Libraries, and Embedded Content คุณควรเห็นแพ็กเกจที่ติดตั้งไว้ นอกจากนี้ คุณยังดูส่วน "Package Dependencies" ของ "Project Navigator" เพื่อยืนยันแพ็กเกจและเวอร์ชันได้ด้วย
หากต้องการอัปเดต package สำหรับโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
- จาก Xcode ให้ไปที่ไฟล์ > แพ็กเกจ > อัปเดตเป็นเวอร์ชันแพ็กเกจล่าสุด
- หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนทรัพยากร Dependency ของแพ็กเกจในเครื่องมือนำทางโปรเจ็กต์เพื่อยืนยันแพ็กเกจและเวอร์ชัน
การบำรุงรักษาและการอัปเกรด
หากต้องการสร้างด้วยการปรับปรุงล่าสุด ให้ตรวจหาเวอร์ชันใหม่เป็นประจำและอัปเดตข้อกำหนดเวอร์ชัน หากคุณกำลังอัปเดตเป็นเวอร์ชันหลักใหม่ ให้ตรวจสอบบันทึกประจำรุ่นเพื่อดูการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลังและวิธีอัปเดตโค้ด
Cocoapods
-
เปิดเทอร์มินัลและไปที่ไดเรกทอรีที่มี
Podfileดังนี้cd <path-to-project>
- เรียกใช้
pod outdatedเพื่อดูว่า Driver SDK สำหรับ iOS เวอร์ชันใหม่พร้อมใช้งานหรือไม่ - หากพบ SDK เวอร์ชันใหม่ ให้อัปเดต
Podfileด้วยเวอร์ชันใหม่นี้ ดูการระบุเวอร์ชัน Pod เพื่อดูวิธีตั้งค่าเวอร์ชันที่เฉพาะเจาะจงในPodfile - วิ่ง
pod update - ทำการเปลี่ยนแปลงที่จำเป็นอันเป็นผลมาจากการอัปเกรด ดูรายการการเปลี่ยนแปลงในแต่ละรุ่นได้ที่บันทึกประจำรุ่น
- ล้างและสร้างโปรเจ็กต์ใหม่โดยเลือกผลิตภัณฑ์ > ล้าง แล้วเลือกผลิตภัณฑ์ > สร้าง
การติดตั้งด้วยตนเอง
รับลิงก์ไปยังไฟล์ต้นฉบับล่าสุดที่หัวข้อการติดตั้ง SDK
นอกจากการตรวจสอบเวอร์ชันใหม่แล้ว เจ้าของโปรเจ็กต์ Google Cloud จะได้รับอีเมลเกี่ยวกับการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลังซึ่งอาจส่งผลต่อโปรเจ็กต์ของตนด้วย หากต้องการรับการแจ้งเตือนเชิงรุกเกี่ยวกับการเปลี่ยนแปลงที่ไม่เข้ากันแบบย้อนหลัง ให้มอบหมายบทบาทเจ้าของด้วยอีเมลที่มีการตรวจสอบสำหรับแต่ละโปรเจ็กต์