ทีม Google Maps Platform จะอัปเดต SDK เป็นประจำด้วยฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง และการปรับปรุงประสิทธิภาพ หน้านี้จะแนะนำวิธีจัดการทรัพยากร Dependency ใน SDK อุปกรณ์เคลื่อนที่
ลิงก์กับเวอร์ชันใด
-
สำหรับแอปที่สำคัญต่อพันธกิจ ให้ลิงก์ไปยังการเผยแพร่จุดล่าสุดของเวอร์ชันหลักที่คุณใช้อยู่ (X.*) และอัปเกรดเป็นเวอร์ชันหลักใหม่ทุกปี
เมื่อคุณเปิดตัวแอปพลิเคชันเวอร์ชันใหม่ตลอดทั้งปี คุณอาจเริ่มใช้ Driver SDK เวอร์ชันใหม่กว่าสำหรับ iOS ได้ ซึ่งไม่จําเป็นต้องอัปเดตในแอปพลิเคชัน เนื่องจากเวอร์ชันใหม่ของจุดจะใช้งานร่วมกับเวอร์ชันเก่าได้
ข้อดี
- หากพบปัญหาใน Driver SDK สําหรับ iOS เราจะให้บริการแก้ไขในลักษณะที่เข้ากันได้ย้อนหลังเป็นเวลา 12 เดือนหลังจากการเปิดตัวเวอร์ชันหลักครั้งแรก ตามนโยบายการรองรับอุปกรณ์เคลื่อนที่ คุณไม่จำเป็นต้องอัปเกรดเป็น SDK เวอร์ชันที่ใช้ร่วมกันไม่ได้โดยด่วนเพื่อรับประโยชน์จากการแก้ไข
- คุณจะนำการปรับปรุงและฟีเจอร์ล่าสุดไปใช้งานได้ง่ายเมื่อแอปสร้างแอปในเวอร์ชันล่าสุดอยู่แล้ว
- การอัปเดต SDK เวอร์ชันหลักล่าสุดเป็นประจำทุกปีอาจทําให้การปรับแต่ง เขียนใหม่ และทดสอบแอปพลิเคชันได้ง่ายขึ้น แทนที่จะต้องจัดการกับการเปลี่ยนแปลงที่เข้ากันไม่ได้กับเวอร์ชันเก่าซึ่งมีการเผยแพร่ในหลายเวอร์ชันหลัก
สำหรับแอปที่ไม่สำคัญ ให้ลิงก์ไปยังเวอร์ชันที่แก้ไขแล้ว เมื่อได้รับการแจ้งเตือนการเลิกใช้งานสำหรับเวอร์ชันที่แก้ไขแล้ว คุณจะมีเวลา 12 เดือนในการทำให้โค้ดแอปที่อัปเดตพร้อมใช้งานสำหรับผู้ใช้
ข้อดี:
- มีงานบำรุงรักษาน้อยกว่า
- แอปเวอร์ชันใหม่ของคุณจะยังคงรองรับอุปกรณ์ของผู้ใช้ที่ใช้ระบบปฏิบัติการบนอุปกรณ์เคลื่อนที่รุ่นเก่าได้นานขึ้น (จนกว่าคุณจะต้องอัปเกรดเป็น SDK เวอร์ชันใหม่)
เจ้าของโปรเจ็กต์ซึ่งมีอีเมลที่ตรวจสอบแล้วจะได้รับการแจ้งเตือนเชิงรุกเกี่ยวกับการเปลี่ยนแปลงที่ส่งผลกระทบต่อแต่ละโปรเจ็กต์ ติดตามข้อมูลเกี่ยวกับการอัปเดตที่สำคัญ การเลิกใช้งาน และการเปลี่ยนแปลงอื่นๆ
การติดตั้ง
ให้ระบุหมายเลขเวอร์ชันในทรัพยากร Dependency เสมอแทนการใช้โอเปอเรเตอร์ที่มีประสิทธิภาพสูงสุด (~>) เนื่องจากอาจทำให้เกิดการสร้างบิลด์ที่คาดการณ์ไม่ได้และทำซ้ำไม่ได้ Driver SDK สําหรับ iOS เป็นไปตามการกําหนดเวอร์ชันแบบเซแมนติก และเวอร์ชันหลักใหม่จะรวมการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
CocoaPods
ตัวอย่างความเกี่ยวข้องของ 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แล้วไปที่ไฟล์ > เพิ่มการอ้างอิงแพ็กเกจ - ป้อน https://github.com/googlemaps/ios-driver-sdk เป็น URL แล้วกด Enter เพื่อดึงข้อมูลแพ็กเกจ แล้วคลิก "เพิ่มแพ็กเกจ"
-
หากต้องการติดตั้ง
versionที่เจาะจง ให้ตั้งค่าช่องกฎการขึ้นต่อกันเป็นตัวเลือกตามเวอร์ชันรายการใดรายการหนึ่ง สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ระบุเวอร์ชันล่าสุดและใช้ตัวเลือก "เวอร์ชันแบบตรงทั้งหมด" เมื่อดำเนินการเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ"
หากต้องการอัปเดต package สำหรับโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
- หากต้องการตรวจสอบการติดตั้ง ให้ไปที่ส่วนแพ็กเกจที่ต้องพึ่งพาของเครื่องมือนำทางโปรเจ็กต์เพื่อยืนยันแพ็กเกจและเวอร์ชัน
การบำรุงรักษาและการอัปเกรด
ตรวจสอบเวอร์ชันที่ใหม่กว่าและอัปเดตข้อมูลจำเพาะของเวอร์ชันเป็นประจำเพื่อสร้างโดยใช้การปรับปรุงล่าสุด หากคุณกำลังอัปเดตเป็นเวอร์ชันหลักใหม่ ให้ตรวจสอบบันทึกประจำรุ่นเพื่อดูการเปลี่ยนแปลงที่เข้ากันไม่ได้กับเวอร์ชันก่อนและวิธีอัปเดตโค้ด
โคโคพ็อด
-
เปิดเทอร์มินัลและไปที่ไดเรกทอรีที่มี
Podfile:cd <path-to-project>
- เรียกใช้
pod outdatedเพื่อดูว่ามี Driver SDK สำหรับ iOS เวอร์ชันใหม่หรือไม่ - หากพบ SDK เวอร์ชันใหม่ ให้อัปเดต
Podfileเป็นเวอร์ชันใหม่นี้ ดูการระบุเวอร์ชันพ็อดเพื่อดูวิธีตั้งค่าเวอร์ชันที่เฉพาะเจาะจงในPodfile - เรียกใช้
pod update - ทำการเปลี่ยนแปลงที่จำเป็นเนื่องจากการอัปเกรด ดูรายการการเปลี่ยนแปลงในแต่ละรุ่นได้ในบันทึกประจำรุ่น
- ล้างและสร้างโปรเจ็กต์อีกครั้งโดยเลือกผลิตภัณฑ์ > ล้าง แล้วเลือกผลิตภัณฑ์ > สร้าง
การติดตั้งด้วยตนเอง
รับลิงก์ไปยังไฟล์แหล่งที่มาล่าสุด เมื่อติดตั้ง SDK
นอกจากการหยั่งสัญญาณสำหรับเวอร์ชันใหม่แล้ว เจ้าของโปรเจ็กต์ Google Cloud จะได้รับอีเมลเกี่ยวกับการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลังซึ่งอาจส่งผลต่อโปรเจ็กต์ของตน หากต้องการมอบหมายบทบาทเจ้าของด้วยอีเมลที่มีการตรวจสอบสำหรับโปรเจ็กต์แต่ละรายการเพื่อรับการแจ้งเตือนล่วงหน้าเกี่ยวกับการเปลี่ยนแปลงที่เข้ากันไม่ได้กับเวอร์ชันเก่า