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

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

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

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

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

    ข้อดี

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

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

    ข้อดี

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

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

การติดตั้ง

Swift Package Manager

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

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

  1. เปิด Xcode project หรือ workspace แล้วไปที่File > Add Package Dependencies
  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. หากต้องการยืนยันการติดตั้ง ให้ไปที่แผงทั่วไปของเป้าหมาย ในเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง คุณควรเห็นแพ็กเกจที่ติดตั้ง นอกจากนี้ คุณยังดูส่วนการขึ้นต่อกันของแพ็กเกจในProject Navigator เพื่อยืนยันแพ็กเกจและเวอร์ชันได้ด้วย

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

  1. จาก Xcode ให้ไปที่ "File > Packages > Update To Latest Package Versions"

    หากคุณอัปเดต 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. หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนการขึ้นต่อกันของแพ็กเกจในProject Navigator เพื่อยืนยันแพ็กเกจและเวอร์ชัน

CocoaPods

ระบุหมายเลขเวอร์ชันใน Dependencies เสมอแทนที่จะใช้ตัวดำเนินการแบบมองโลกในแง่ดี (~>) เนื่องจากอาจทำให้เกิดบิลด์ที่ไม่สามารถคาดการณ์ได้และทำซ้ำไม่ได้ Places SDK สำหรับ iOS เป็นไปตามการกำหนดเวอร์ชันเชิงความหมาย และการเปิดตัวเวอร์ชันหลักใหม่จะมีการเปลี่ยนแปลงที่ไม่รองรับการทำงานร่วมกัน

ตัวอย่างทรัพยากร Dependency ของ Podfile โดยใช้ไวยากรณ์ Podfile

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '10.8.0'
  pod 'GooglePlacesSwift', '10.8.0'
end

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

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

Swift Package Manager

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

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

Cocoapods

  1. เปิดเทอร์มินัลแล้วไปที่ไดเรกทอรีที่มี Podfile

    cd <path-to-project>
  2. เรียกใช้ pod outdated เพื่อดูว่ามี Places SDK สำหรับ iOS เวอร์ชันใหม่กว่า หรือไม่
  3. หากพบ SDK เวอร์ชันใหม่กว่า ให้อัปเดต Podfile ด้วยเวอร์ชันใหม่นี้ ดูการระบุเวอร์ชันพ็อด เพื่อดูวิธีตั้งค่าเวอร์ชันที่เฉพาะเจาะจงใน Podfile
  4. เรียกใช้ pod update
  5. ทำการเปลี่ยนแปลงที่จำเป็นอันเป็นผลมาจากการอัปเกรด ดูรายการการเปลี่ยนแปลงในแต่ละรุ่นได้ในบันทึกประจำรุ่น
  6. ล้างและสร้างโปรเจ็กต์ใหม่โดยเลือกผลิตภัณฑ์ > ล้าง แล้วเลือกผลิตภัณฑ์ > สร้าง

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

รับลิงก์ไปยังไฟล์แหล่งที่มาล่าสุด ที่การติดตั้ง SDK

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