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 หากต้องการเพิ่ม SDK โปรดตรวจสอบว่าคุณได้นําข้อกําหนดของ Places SDK สําหรับ iOS ที่มีอยู่ออกแล้ว

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

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

    หากคุณอัปเดต Google Places Swift

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

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

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

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

    หากคุณอัปเดต Google Places Swift

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

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

CocoaPods

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

ตัวอย่างความเกี่ยวข้องของ Podfile ที่ใช้ไวยากรณ์ Podfile

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

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '9.2.0'
  pod 'GooglePlacesSwift', '0.3.0'
end

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

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

Swift Package Manager

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

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

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 ยังจะได้รับอีเมลเกี่ยวกับการเปลี่ยนแปลงที่เข้ากันไม่ได้กับเวอร์ชันเก่าซึ่งอาจส่งผลต่อโปรเจ็กต์ของตน หากต้องการมอบหมายบทบาทเจ้าของด้วยอีเมลที่มีการตรวจสอบสำหรับโปรเจ็กต์แต่ละรายการเพื่อรับการแจ้งเตือนล่วงหน้าเกี่ยวกับการเปลี่ยนแปลงที่เข้ากันไม่ได้กับเวอร์ชันเก่า