Maps SDK สำหรับเวอร์ชัน Android

เลือกแพลตฟอร์ม: Android iOS JavaScript

ทีม Google Maps Platform ทำการอัปเดต SDK ด้วยฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง และการปรับปรุงประสิทธิภาพอยู่เสมอ หน้านี้จะให้คำแนะนำเกี่ยวกับวิธีจัดการทรัพยากร Dependency ของ SDK อุปกรณ์เคลื่อนที่

  • สำหรับแอปที่สำคัญต่อพันธกิจ ให้ลิงก์ไปยังการเผยแพร่ที่มีจุดล่าสุดของเวอร์ชันหลักที่คุณใช้ (X.*) และอัปเกรดทุกปีเป็นเวอร์ชันหลักใหม่

    เมื่อเปิดตัวแอปพลิเคชันเวอร์ชันใหม่ตลอดทั้งปี คุณอาจเริ่มใช้ Maps SDK เวอร์ชันใหม่ๆ ของ Maps SDK สำหรับ Android ได้ การดำเนินการนี้จะไม่ต้องมีการอัปเดตในแอปพลิเคชันเนื่องจากจุดเวอร์ชันใหม่เข้ากันได้แบบย้อนหลัง

    ข้อดี

    • หากคุณพบปัญหาเกี่ยวกับ Maps SDK สำหรับ Android เราจะทำการแก้ปัญหาด้วยวิธีที่เข้ากันได้แบบย้อนหลังเป็นเวลา 12 เดือนหลังจากการเผยแพร่เวอร์ชันหลักครั้งแรกตามนโยบายการสนับสนุนสำหรับอุปกรณ์เคลื่อนที่ คุณไม่จำเป็นต้องอัปเกรดเป็น SDK เวอร์ชันที่incompatibleอย่างเร่งด่วนเพื่อให้ได้รับประโยชน์จากการแก้ไข
    • คุณจะใช้งานการปรับปรุงและฟีเจอร์ล่าสุดได้ง่ายๆ เมื่อสร้างแอปเป็นเวอร์ชันล่าสุดอยู่แล้ว
    • การอัปเดตส่วนเพิ่มประจำปีของ SDK เวอร์ชันหลักรุ่นใหม่ล่าสุดอาจช่วยลดภาระในการปรับ เขียนใหม่ และทดสอบแอปพลิเคชันของคุณ แทนที่จะต้องจัดการกับการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลังซึ่งเกิดขึ้นในเวอร์ชันหลักหลายๆ รุ่น

  • สำหรับแอปที่ไม่สำคัญ ให้ลิงก์กับเวอร์ชันที่แก้ไขแล้ว เมื่อได้รับประกาศการเลิกใช้งานสำหรับเวอร์ชันที่แก้ไขแล้ว คุณจะมีเวลา 12 เดือนในการทำให้โค้ดของแอปที่อัปเดตพร้อมใช้งานสำหรับผู้ใช้

    ข้อดี

    • ไม่ต้องบำรุงรักษาบ่อย
    • แอปเวอร์ชันใหม่จะรองรับอุปกรณ์ของผู้ใช้ที่ใช้ระบบปฏิบัติการบนอุปกรณ์เคลื่อนที่เวอร์ชันเก่านานขึ้น (จนกว่าคุณจะต้องอัปเกรดเป็น SDK เวอร์ชันใหม่)

เจ้าของโปรเจ็กต์ที่มีอีเมลที่มีการตรวจสอบจะได้รับการแจ้งเตือนเชิงรุกเกี่ยวกับการเปลี่ยนแปลงที่มีผลต่อแต่ละโปรเจ็กต์ของตน รับทราบข้อมูลเกี่ยวกับการอัปเดตสำคัญ การเลิกใช้งาน และการเปลี่ยนแปลงอื่นๆ

การติดตั้ง

ในไฟล์ build.gradle ระดับแอป ให้ระบุเวอร์ชันแทนช่วงคำนำหน้า (+) หรือ latest เสมอ เนื่องจากอาจทำให้เกิดบิลด์ที่คาดการณ์ไม่ได้และทำซ้ำไม่ได้ Maps SDK สำหรับ Android เป็นไปตามการกำหนดเวอร์ชันเชิงความหมาย และการเปิดตัวเวอร์ชันหลักใหม่อาจมีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ ระดับ API ขั้นต่ำที่รองรับคือ 19

การระบุการพึ่งพา 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 จะได้รับอีเมลเกี่ยวกับการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลังซึ่งอาจส่งผลกระทบต่อโปรเจ็กต์ หากต้องการรับการแจ้งเตือนเชิงรุกเกี่ยวกับการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลัง ให้กำหนดบทบาทเจ้าของด้วยอีเมลที่มีการตรวจสอบสำหรับแต่ละโปรเจ็กต์