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