ทีม Google Maps Platform อัปเดต SDK ให้มีฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง และ เพื่อปรับปรุงประสิทธิภาพ หน้านี้จะมีคำแนะนำเกี่ยวกับวิธีจัดการทรัพยากร Dependency เกี่ยวกับ SDK อุปกรณ์เคลื่อนที่
จะลิงก์กับเวอร์ชันใด
-
สำหรับแอปที่สำคัญต่อพันธกิจ ให้ลิงก์ไปยังการเปิดตัวแอปหลักล่าสุด เวอร์ชันที่คุณใช้งานอยู่ (X.*) และอัปเกรดรายปีเป็นเวอร์ชันหลักใหม่
ขณะที่คุณเผยแพร่แอปพลิเคชันเวอร์ชันใหม่ คุณสามารถเริ่มใช้ Places SDK เวอร์ชันใหม่ๆ ของ Places สำหรับ Android ได้ตลอดทั้งปี การดำเนินการนี้จะ คุณไม่จำเป็นต้องอัปเดตในแอปพลิเคชันเนื่องจากจุดเวอร์ชันใหม่เข้ากันได้แบบย้อนหลัง
ข้อดี
- ถ้าคุณพบปัญหาใน Places SDK สำหรับ Android คุณสามารถดูการแก้ไขใน ที่เข้ากันได้แบบย้อนหลังเป็นเวลา 12 เดือนหลังจากการเปิดตัวเวอร์ชันหลักเป็นครั้งแรกตาม การสนับสนุนสำหรับอุปกรณ์เคลื่อนที่ คุณไม่จำเป็นต้องอัปเกรดเป็น SDK เวอร์ชันที่ใช้ร่วมกันไม่ได้โดยด่วน เพื่อใช้ประโยชน์จากการแก้ไข
- คุณจะนำการปรับปรุงและฟีเจอร์ล่าสุดไปใช้งานได้ง่ายเมื่อมีการสร้างแอปอยู่แล้ว เวอร์ชันล่าสุด
- การอัปเดต SDK เวอร์ชันหลักใหม่ล่าสุดรายปีอาจต้องใช้การทำงานน้อยลง เพื่อปรับตัว เขียนใหม่ และทดสอบแอปพลิเคชันของคุณ การเปลี่ยนแปลงที่เกิดขึ้นในรุ่นหลักหลายรุ่น
สำหรับแอปที่ไม่สำคัญ ให้ลิงก์ไปยังเวอร์ชันที่แก้ไขแล้ว เมื่อคุณได้รับการเลิกใช้งาน สำหรับเวอร์ชันที่แก้ไขแล้ว คุณจะมีเวลา 12 เดือนในการทำให้โค้ดแอปที่อัปเดตพร้อมใช้งานสำหรับ ผู้ใช้ของคุณ
ข้อดี
- มีงานบำรุงรักษาน้อยกว่า
- แอปเวอร์ชันใหม่ของคุณรองรับผู้ใช้อยู่เสมอ อุปกรณ์ที่ใช้งานโทรศัพท์มือถือรุ่นเก่า ระบบเป็นเวลานานขึ้น (จนกว่าคุณจะต้องอัปเกรดเป็น SDK เวอร์ชันใหม่)
เจ้าของโปรเจ็กต์ซึ่งมีอีเมลที่ตรวจสอบแล้วจะได้รับการแจ้งเตือนเชิงรุกเกี่ยวกับการเปลี่ยนแปลงที่ ส่งผลต่อแต่ละโปรเจ็กต์ของพวกเขาอย่างไร อยู่ต่อ แจ้งเกี่ยวกับการอัปเดตที่สำคัญ การเลิกใช้งาน และการเปลี่ยนแปลงอื่นๆ
การติดตั้ง
ในไฟล์ build.gradle.kts
หรือ build.gradle
ระดับแอป ให้ระบุเสมอ
เวอร์ชันแทนที่จะเป็นช่วงคำนำหน้า (+
) หรือ latest
เนื่องจากอาจมี
ไปจนถึงงานสร้างที่คาดเดาไม่ได้และคาดเดาไม่ได้ Places SDK สำหรับ Android ปฏิบัติตาม
การกำหนดเวอร์ชันทางความหมาย และการสร้าง
เวอร์ชันหลักอาจมีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ ระดับ API ขั้นต่ำที่รองรับคือ
21
dependencies { // If updating kotlin-bom version number above, also edit project-level build.gradle definition of $kotlin_version variable implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version")) implementation 'com.google.android.libraries.places:places:3.3.0' }
การบำรุงรักษาและการอัปเกรด
Android Studio จะตรวจหาเวอร์ชันใหม่ที่พร้อมให้บริการโดยอัตโนมัติและให้คำเตือนเมื่อ มีทรัพยากร Dependency รุ่นใหม่กว่าพร้อมใช้งาน เพื่อลดหนี้ทางเทคนิค ให้อัปเดตเป็น เวอร์ชันที่พร้อมใช้งานโดยเร็วที่สุด หากคุณกำลังอัปเดตเป็นเวอร์ชันหลักใหม่ ตรวจสอบบันทึกประจำรุ่น เพื่อดูการเปลี่ยนแปลงที่เข้ากันไม่ได้กับเวอร์ชันก่อนและวิธีอัปเดตโค้ด
นอกจากการสำรวจแอปเวอร์ชันใหม่แล้ว Google Cloud โปรเจ็กต์ เจ้าของจะได้รับอีเมลเกี่ยวกับการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลัง ซึ่งอาจ ที่ส่งผลต่อโปรเจ็กต์ของตน เพื่อรับการแจ้งเตือนเชิงรุกเกี่ยวกับความเข้ากันได้แบบย้อนหลัง การเปลี่ยนแปลง, มอบหมาย บทบาทเจ้าของที่มีอีเมลที่ตรวจสอบสำหรับแต่ละโปรเจ็กต์
หากคุณกำลังอัปเกรดจาก Places SDK สำหรับ Android เวอร์ชัน 3.2.0 หรือเก่ากว่า
คุณไม่จําเป็นต้องย้ายข้อมูลเมื่อเปลี่ยนไปใช้ SDK ใหม่ เพียงดำเนินการต่อไปนี้
- เปิดใช้ Places API (ใหม่) บนคีย์ API ที่ใช้ในแอป ดูข้อมูลเพิ่มเติมได้ที่การใช้คีย์ API
ในส่วน
dependencies
ของระดับโมดูลbuild.gradle
โปรดอัปเดตทรัพยากร Dependency ของplaces
และเพิ่มทรัพยากร Dependency ของkotlin-bom
ดังนี้dependencies { implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0")) implementation 'com.google.android.libraries.places:places:3.5.0' }
ดูข้อมูลเพิ่มเติมเกี่ยวกับทรัพยากร Dependency ของ
kotlin-bom
ได้ที่ การใช้ kotlin-stdlib เวอร์ชันล่าสุดในทรัพยากร Dependency แบบทรานซิทีฟ- อัปเดตแอปที่มีอยู่เพื่อเรียกใช้
Places.initializeWithNewPlacesApiEnabled()
ในการเริ่มต้นแอป สำหรับข้อมูลเพิ่มเติม โปรดดู เริ่มต้นไคลเอ็นต์ของ Places API
แอปที่มีอยู่จะยังคงทำงานเหมือนเดิม แต่ตอนนี้คุณสามารถ จากฟีเจอร์ใหม่ทั้งหมดของ SDK