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

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

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

จะลิงก์กับเวอร์ชันใด

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

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

  ข้อดี

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

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

  ข้อดี

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

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

การติดตั้ง

ในไฟล์ build.gradle ระดับแอป ให้ระบุเวอร์ชันแทนช่วงคำนำหน้า (+) หรือ latest เสมอ เนื่องจากอาจทำให้เกิดบิลด์ที่คาดการณ์ไม่ได้และทำซ้ำไม่ได้ Places SDK สำหรับ Android เป็นไปตามการกำหนดเวอร์ชันเชิงความหมาย และการเปิดตัวเวอร์ชันหลักใหม่อาจมีการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ ระดับ API ขั้นต่ำที่รองรับคือ 21

dependencies {
    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 ที่ใช้ในแอป หากคุณใช้ทั้ง Places SDK ที่มีอยู่สำหรับ Android และ Places SDK สำหรับ Android (ใหม่) เราขอแนะนำให้สร้างคีย์ API แยกต่างหากสำหรับ API แต่ละเวอร์ชัน ดูข้อมูลเพิ่มเติมได้ที่การใช้คีย์ API

2. ในส่วน dependencies ของไฟล์ build.gradle ระดับโมดูล ให้อัปเดตทรัพยากร Dependency places และเพิ่มการอ้างอิง kotlin-bom ดังนี้

     dependencies {
         implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
         implementation 'com.google.android.libraries.places:places:3.3.0'
     }

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

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

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