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.kts หรือ build.gradle ระดับแอป ให้ระบุเสมอ เวอร์ชันแทนที่จะเป็นช่วงคำนำหน้า (+) หรือ latest เนื่องจากอาจมี ไปจนถึงงานสร้างที่คาดเดาไม่ได้และคาดเดาไม่ได้ Places SDK สำหรับ Android ปฏิบัติตาม การกำหนดเวอร์ชันเชิงความหมาย และการสร้าง เวอร์ชันหลักอาจมีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ ระดับ API ขั้นต่ำที่รองรับคือ 23

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'
  }

    ดูข้อมูลเพิ่มเติมเกี่ยวกับ kotlin-bom ได้ที่การใช้ kotlin-stdlib เวอร์ชันล่าสุดใน transitive dependencies

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

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