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

เลือกแพลตฟอร์ม แอนดรอยด์ iOS JavaScript

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

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

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

    ข้อดี

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

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

    ข้อดี

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

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

การติดตั้ง

ในไฟล์ build.gradle.kts หรือ 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:19.0.0")
}

ดูคำแนะนำเพิ่มเติมสำหรับ การจัดการ Google การกำหนดเวอร์ชันของบริการ Google Play

การบำรุงรักษาและการอัปเกรด

Android Studio จะตรวจหาเวอร์ชันใหม่ที่พร้อมให้บริการโดยอัตโนมัติและให้คำเตือนเมื่อ มีทรัพยากร Dependency รุ่นใหม่กว่าพร้อมใช้งาน เพื่อลดหนี้ทางเทคนิค ให้อัปเดตเป็น เวอร์ชันที่พร้อมใช้งานโดยเร็วที่สุด หากคุณกำลังอัปเดตเป็นเวอร์ชันหลักใหม่ ตรวจสอบบันทึกประจำรุ่น เพื่อดูการเปลี่ยนแปลงที่เข้ากันไม่ได้กับเวอร์ชันก่อนและวิธีอัปเดตโค้ด

นอกจากการสำรวจแอปเวอร์ชันใหม่แล้ว Google Cloud โปรเจ็กต์ เจ้าของจะได้รับอีเมลเกี่ยวกับการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลัง ซึ่งอาจ ที่ส่งผลต่อโปรเจ็กต์ของตน เพื่อรับการแจ้งเตือนเชิงรุกเกี่ยวกับความเข้ากันได้แบบย้อนหลัง การเปลี่ยนแปลง, มอบหมาย บทบาทเจ้าของที่มีอีเมลที่ตรวจสอบสำหรับแต่ละโปรเจ็กต์