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