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

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

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

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

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

    ข้อดี

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

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

    ข้อดี

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

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

การติดตั้ง

ในไฟล์ 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 ใหม่ เพียงดำเนินการต่อไปนี้

  1. เปิดใช้ Places API (ใหม่) บนคีย์ API ที่ใช้ในแอป ดูข้อมูลเพิ่มเติมได้ที่การใช้คีย์ API

  2. ในส่วน 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 แบบทรานซิทีฟ

  3. อัปเดตแอปที่มีอยู่เพื่อเรียกใช้ Places.initializeWithNewPlacesApiEnabled() ในการเริ่มต้นแอป สำหรับข้อมูลเพิ่มเติม โปรดดู เริ่มต้นไคลเอ็นต์ของ Places API

แอปที่มีอยู่จะยังคงทำงานเหมือนเดิม แต่ตอนนี้คุณสามารถ จากฟีเจอร์ใหม่ทั้งหมดของ SDK