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

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

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

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

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

    สิทธิประโยชน์

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

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

    สิทธิประโยชน์

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

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

การติดตั้ง

Swift Package Manager

คุณสามารถติดตั้ง Places SDK สำหรับ iOS ผ่าน Swift Package Manager ได้ หากต้องการเพิ่ม SDK ให้ตรวจสอบว่าคุณได้ นำการอ้างอิง Places SDK สำหรับ iOS ที่มีอยู่ออกแล้ว

หากต้องการเพิ่ม SDK ลงในโปรเจ็กต์ใหม่หรือโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้

  1. เปิด project หรือ workspace ของ Xcode แล้วไปที่ ไฟล์ > เพิ่มการอ้างอิงแพ็กเกจ
  2. ป้อน https://github.com/googlemaps/ios-places-sdk เป็น URL แล้วกด Enter เพื่อดึงแพ็กเกจเข้ามา จากนั้นคลิก "เพิ่มแพ็กเกจ"
  3. หากต้องการติดตั้ง version ที่เฉพาะเจาะจง ให้ตั้งค่าช่องกฎการอ้างอิง เป็นตัวเลือกใดตัวเลือกหนึ่งที่อิงตามเวอร์ชัน สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ระบุเวอร์ชันล่าสุดและ ใช้ตัวเลือก "เวอร์ชันที่แน่นอน" เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ"
  4. จากหน้าต่างเลือกผลิตภัณฑ์แพ็กเกจ ให้ตรวจสอบว่าระบบจะเพิ่ม GooglePlaces GooglePlacesSwift หรือทั้ง 2 อย่างลงในเป้าหมายหลักที่กำหนด เมื่อเสร็จแล้ว ให้คลิกเพิ่มแพ็กเกจ

    หากคุณกำลังอัปเดต Google Places Swift จาก URL GitHub ที่เลิกใช้งานแล้ว

    สำคัญ: URL GitHub สำหรับเข้าถึง Google Places Swift ได้เปลี่ยนไปแล้วโดยเริ่มตั้งแต่เวอร์ชัน 0.3.0 หากคุณกำลังอัปเดต GooglePlacesSwift เวอร์ชันที่เข้าถึงผ่าน URL เก่า https://github.com/googlemaps/ios-places-swift-sdk ให้นำออกจากการอ้างอิงแพ็กเกจของ Xcode

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

หากต้องการอัปเดต package สำหรับโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้

  1. จาก Xcode ให้ไปที่ไฟล์ > แพ็กเกจ > อัปเดตเป็นแพ็กเกจเวอร์ชันล่าสุด

    หากคุณกำลังอัปเดต Google Places Swift จาก URL GitHub ที่เลิกใช้งานแล้ว

    สำคัญ: URL GitHub สำหรับเข้าถึง Google Places Swift ได้เปลี่ยนไปแล้วโดยเริ่มตั้งแต่เวอร์ชัน 0.3.0 หากคุณกำลังอัปเดต GooglePlacesSwift เวอร์ชันที่เข้าถึงผ่าน URL เก่า https://github.com/googlemaps/ios-places-swift-sdk ให้นำออกจากการอ้างอิงแพ็กเกจของ Xcode

  2. หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนการอ้างอิงแพ็กเกจ ของตัวนำทางโปรเจ็กต์ เพื่อยืนยันแพ็กเกจและเวอร์ชัน

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

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

Swift Package Manager

หากต้องการอัปเดต package สำหรับโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้

  1. หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนการอ้างอิงแพ็กเกจ ของตัวนำทางโปรเจ็กต์ เพื่อยืนยันแพ็กเกจและเวอร์ชัน

การติดตั้งด้วยตนเอง

รับลิงก์ไปยังไฟล์ต้นฉบับล่าสุด ได้ที่หัวข้อการติดตั้ง SDK

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