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

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

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

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

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

    ข้อดี

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

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

    ข้อดี

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

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

การติดตั้ง

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

dependencies {

    // Places and Maps SDKs
    implementation("com.google.android.libraries.places:places:4.3.1")
}

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

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

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

หากคุณอัปเกรดจาก Places SDK สำหรับ Android เวอร์ชัน 3.2.0 หรือเก่ากว่า

ไม่จำเป็นต้องย้ายข้อมูลเมื่อเปลี่ยนไปใช้ SDK ใหม่ คุณเพียงแค่ต้องทำสิ่งต่อไปนี้

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

  2. ในส่วน dependencies ของไฟล์ระดับโมดูล build.gradle ให้อัปเดตการขึ้นต่อกันของ places และเพิ่มการขึ้นต่อกันของ 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 เวอร์ชันล่าสุดในการอ้างอิงแบบทรานซิทีฟ

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

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