ทีม Google Maps Platform จะอัปเดต SDK เป็นประจำด้วยฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง และการปรับปรุงประสิทธิภาพ หน้านี้จะให้คำแนะนำเกี่ยวกับวิธีจัดการทรัพยากร Dependency ใน SDK บนอุปกรณ์เคลื่อนที่
ลิงก์กับเวอร์ชันใด
-
สำหรับแอปที่มีความสำคัญต่อภารกิจ ให้ลิงก์กับเวอร์ชันย่อยล่าสุดของเวอร์ชันหลักที่คุณใช้อยู่ (X.*) และอัปเกรดเป็นเวอร์ชันหลักใหม่ทุกปี
เมื่อคุณเปิดตัวแอปพลิเคชันเวอร์ชันใหม่ตลอดทั้งปี คุณอาจเริ่มใช้ Maps SDK สำหรับ Android เวอร์ชันใหม่ที่มีจุดทศนิยม การดำเนินการนี้ไม่จำเป็นต้องมีการอัปเดตในแอปพลิเคชันของคุณ เนื่องจากเวอร์ชันย่อยใหม่จะเข้ากันได้แบบย้อนหลัง
ข้อดี
- หากพบปัญหาใน Maps SDK สำหรับ Android เราจะแก้ไขปัญหาในลักษณะที่เข้ากันได้แบบย้อนหลังเป็นเวลา 12 เดือนหลังจากการเปิดตัวเวอร์ชันหลักครั้งแรก ตามนโยบายการสนับสนุนอุปกรณ์เคลื่อนที่ คุณไม่จำเป็นต้องอัปเกรดเป็น SDK เวอร์ชันที่ไม่เข้ากันอย่างเร่งด่วนเพื่อรับประโยชน์จากการแก้ไข
- การปรับปรุงและฟีเจอร์ล่าสุดจะนำไปใช้ได้ง่ายเมื่อแอปของคุณสร้างขึ้นในเวอร์ชันล่าสุดอยู่แล้ว
- การอัปเดต SDK เวอร์ชันหลักใหม่ล่าสุดที่เพิ่มขึ้นทุกปีอาจต้องใช้การปรับเปลี่ยน เขียนใหม่ และทดสอบแอปพลิเคชันน้อยกว่าการจัดการกับการเปลี่ยนแปลงที่ไม่เข้ากันแบบย้อนหลังซึ่งเปิดตัวในเวอร์ชันหลักหลายๆ เวอร์ชัน
สำหรับแอปที่ไม่สำคัญ ให้ลิงก์ไปยังเวอร์ชันที่แก้ไขแล้ว เมื่อได้รับการแจ้งเตือนการเลิกใช้งานสำหรับเวอร์ชันที่แก้ไขแล้ว คุณจะมีเวลา 12 เดือนในการทำให้โค้ดแอปที่อัปเดตพร้อมใช้งานสำหรับผู้ใช้
ข้อดี
- งานบำรุงรักษาที่ถี่น้อยลง
- แอปเวอร์ชันใหม่จะยังคงรองรับอุปกรณ์ของผู้ใช้ที่ใช้ระบบปฏิบัติการบนอุปกรณ์เคลื่อนที่เวอร์ชันก่อนหน้าได้นานขึ้น (จนกว่าคุณจะต้องอัปเกรดเป็น SDK เวอร์ชันใหม่)
เจ้าของโปรเจ็กต์ที่มีอีเมลที่ได้รับการตรวจสอบจะได้รับการแจ้งเตือนเชิงรุกเกี่ยวกับการเปลี่ยนแปลงที่ส่งผลต่อโปรเจ็กต์แต่ละรายการ รับทราบข้อมูลเกี่ยวกับการอัปเดตหลัก การเลิกใช้งาน และการเปลี่ยนแปลงอื่นๆ
การติดตั้ง
ในไฟล์ build.gradle.kts หรือ build.gradle ระดับแอป ให้ระบุเวอร์ชันเสมอแทนช่วงคำนำหน้า (+) หรือ latest เนื่องจากอาจทำให้เกิดบิลด์ที่คาดเดาไม่ได้และทำซ้ำไม่ได้ Maps SDK สำหรับ Android เป็นไปตามการกำหนดเวอร์ชันเชิงความหมาย และการเปิดตัวเวอร์ชันหลักใหม่อาจรวมถึงการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ ระดับ API ขั้นต่ำที่รองรับคือ 23
ระบุทรัพยากร Dependency ของ Maps ภายในบริการ Google Play โดยใช้ไวยากรณ์ Gradle ดังนี้
dependencies { // Maps SDK for Android implementation(libs.play.services.maps) }
ดูคำแนะนำเพิ่มเติมสำหรับการจัดการเวอร์ชันของบริการ Google Play
การบำรุงรักษาและการอัปเกรด
Android Studio จะตรวจหาเวอร์ชันใหม่ที่พร้อมใช้งานโดยอัตโนมัติ และแสดงคำเตือนเมื่อมีทรัพยากร Dependency เวอร์ชันใหม่พร้อมใช้งาน โปรดอัปเดตเป็นเวอร์ชันใหม่ล่าสุดที่พร้อมใช้งานโดยเร็วที่สุดเพื่อลดหนี้ทางเทคนิค หากคุณกำลังอัปเดตเป็นเวอร์ชันหลักใหม่ ให้ตรวจสอบบันทึกประจำรุ่นเพื่อดูการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลังและวิธีอัปเดตโค้ด
นอกจากการตรวจสอบเวอร์ชันใหม่แล้ว เจ้าของโปรเจ็กต์ Google Cloud จะได้รับอีเมลเกี่ยวกับการเปลี่ยนแปลงที่ไม่เข้ากันแบบย้อนหลังซึ่งอาจส่งผลต่อโปรเจ็กต์ของตน หากต้องการรับการแจ้งเตือนเชิงรุกเกี่ยวกับการเปลี่ยนแปลงที่ไม่เข้ากันแบบย้อนหลัง ให้มอบหมายบทบาทเจ้าของด้วยอีเมลที่มีการตรวจสอบสำหรับแต่ละโปรเจ็กต์