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