ทีม Google Maps Platform อัปเดต SDK เป็นประจำด้วยฟีเจอร์ใหม่ การแก้ไขข้อบกพร่อง และการปรับปรุงประสิทธิภาพ หน้านี้มีคำแนะนำเกี่ยวกับวิธีจัดการการพึ่งพา 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 Services
การบำรุงรักษาและการอัปเกรด
Android Studio จะตรวจสอบเวอร์ชันใหม่กว่าที่พร้อมใช้งานโดยอัตโนมัติและแสดงประกาศเตือนเมื่อมีเวอร์ชันใหม่กว่าของทรัพยากร Dependency อัปเดตเป็นเวอร์ชันใหม่ล่าสุดที่พร้อมใช้งานโดยเร็วที่สุดเพื่อลดหนี้ทางเทคนิค หากคุณกำลังอัปเดตเป็นเวอร์ชันหลักใหม่, ตรวจสอบหมายเหตุประจำรุ่น เพื่อดูการเปลี่ยนแปลงที่ไม่เข้ากันกับเวอร์ชันก่อนหน้าและวิธีอัปเดตโค้ด
นอกจากการสำรวจเวอร์ชันใหม่กว่าแล้ว เจ้าของโปรเจ็กต์ Google Cloud จะได้รับอีเมลเกี่ยวกับการเปลี่ยนแปลงที่ไม่เข้ากันกับเวอร์ชันก่อนหน้าซึ่งอาจ ส่งผลต่อโปรเจ็กต์ หากต้องการรับการแจ้งเตือนเชิงรุกเกี่ยวกับการเปลี่ยนแปลงที่ไม่เข้ากันแบบย้อนหลัง ให้กำหนดบทบาทเจ้าของด้วยอีเมลที่ได้รับการตรวจสอบสำหรับแต่ละโปรเจ็กต์