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

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

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

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

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

    ข้อดี

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