ทีม Google Maps Platform ได้อัปเดต SDK ให้มีฟีเจอร์ใหม่ๆ การแก้ไขข้อบกพร่อง และปรับปรุงประสิทธิภาพเป็นประจำ หน้านี้มีคำแนะนำเกี่ยวกับวิธีจัดการทรัพยากร Dependency ของ SDK อุปกรณ์เคลื่อนที่
จะลิงก์กับเวอร์ชันใด
-
สำหรับแอปที่สำคัญต่อพันธกิจ ให้ลิงก์ไปยังเวอร์ชันหลักที่เผยแพร่ล่าสุด (X.*) และอัปเกรดเป็นเวอร์ชันหลักใหม่ทุกปี
เมื่อเปิดตัวแอปพลิเคชันเวอร์ชันใหม่ตลอดทั้งปี คุณอาจเริ่มใช้ Places SDK เวอร์ชันใหม่สำหรับ iOS ได้ ทั้งนี้ คุณไม่ต้องอัปเดตในแอปพลิเคชันเนื่องจากจุดเวอร์ชันใหม่เข้ากันได้แบบย้อนหลัง
ข้อดี
- หากคุณพบปัญหาใน Places SDK สำหรับ iOS เราจะแก้ไขด้วยวิธีที่เข้ากันได้แบบย้อนหลังเป็นเวลา 12 เดือนหลังจากการเปิดตัวเวอร์ชันหลักครั้งแรกตามนโยบายการสนับสนุนสำหรับอุปกรณ์เคลื่อนที่ คุณไม่จำเป็นต้องอัปเกรด SDK เป็นเวอร์ชันที่incompatibleอย่างเร่งด่วนเพื่อใช้ประโยชน์จากการแก้ไข
- การปรับปรุงและฟีเจอร์ล่าสุดจะนําไปใช้งานได้ง่าย เมื่อแอปของคุณสร้างขึ้นในเวอร์ชันล่าสุดอยู่แล้ว
- การอัปเดตเพิ่มเติมรายปีของ SDK เวอร์ชันหลักใหม่ล่าสุดอาจทำให้แอปทำงานน้อยลงในการปรับ เขียนใหม่ และทดสอบแอปพลิเคชัน แทนที่จะต้องคอยจัดการกับการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลังซึ่งเกิดขึ้นในเวอร์ชันหลักหลายๆ รุ่น
สำหรับแอปที่ไม่สำคัญ ให้ลิงก์กับเวอร์ชันที่แก้ไขแล้ว เมื่อได้รับประกาศการเลิกใช้งานสำหรับเวอร์ชันที่แก้ไขแล้ว คุณจะมีเวลา 12 เดือนในการทำให้โค้ดของแอปที่อัปเดตพร้อมใช้งานสำหรับผู้ใช้
ข้อดี
- ลดความถี่ในการซ่อมบำรุง
- แอปเวอร์ชันใหม่จะรองรับอุปกรณ์ของผู้ใช้ที่ใช้ระบบปฏิบัติการบนอุปกรณ์เคลื่อนที่เวอร์ชันเก่านานขึ้น (จนกว่าคุณจะอัปเกรดเป็น SDK เวอร์ชันใหม่)
เจ้าของโปรเจ็กต์ที่มีอีเมลที่มีการตรวจสอบจะได้รับการแจ้งเตือนเชิงรุกเกี่ยวกับการเปลี่ยนแปลงที่มีผลต่อแต่ละโปรเจ็กต์ของตน รับทราบข้อมูลอยู่เสมอเกี่ยวกับการอัปเดตที่สำคัญ การเลิกใช้งาน และการเปลี่ยนแปลงอื่นๆ
บริการติดตั้ง
ผู้จัดการแพ็กเกจของ Swift
Places SDK สำหรับ iOS สามารถติดตั้งผ่าน Swift Package Manager หากต้องการเพิ่ม SDK ให้ตรวจสอบว่าคุณได้นำ Places SDK สำหรับทรัพยากร Dependency ของ iOS ที่มีอยู่ออกแล้ว
หากต้องการเพิ่ม SDK ลงในโปรเจ็กต์ใหม่หรือโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
-
เปิด Xcode
project
หรือworkspace
แล้วไปที่ไฟล์ > เพิ่มการอ้างอิงแพ็กเกจ - ป้อน https://github.com/googlemaps/ios-places-sdk เป็น URL กด Enter เพื่อดึงแพ็กเกจขึ้นมา แล้วคลิก "เพิ่มแพ็กเกจ"
-
หากต้องการติดตั้ง
version
ที่เจาะจง ให้ตั้งค่าช่องกฎการขึ้นต่อกันเป็นหนึ่งในตัวเลือกตามเวอร์ชัน สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ระบุเวอร์ชันล่าสุดและใช้ตัวเลือก "เวอร์ชันที่แน่นอน" เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ" -
จากหน้าต่างเลือกผลิตภัณฑ์แพ็กเกจ โปรดยืนยันว่าจะเพิ่ม
GooglePlaces
ไปยังเป้าหมายmain
ที่กำหนดไว้ เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ" -
ไปที่แผง
General
ของเป้าหมายเพื่อยืนยันการติดตั้ง คุณจะเห็นแพ็กเกจที่ติดตั้งไว้ในเฟรม ไลบรารี และเนื้อหาที่ฝัง นอกจากนี้ คุณยังสามารถดูส่วน "ทรัพยากร Dependency ของแพ็กเกจ" ของ "ตัวนำทางโปรเจ็กต์" เพื่อยืนยันแพ็กเกจและเวอร์ชันได้ด้วย
หากต้องการอัปเดต package
สำหรับโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
หากอัปเกรดจากเวอร์ชันที่เก่ากว่า 9.0.0 คุณต้องนำทรัพยากร Dependency ต่อไปนี้ออก
GoogleMapsBase
,GoogleMapsCore
และGoogleMapsM4B
หลังจากอัปเกรด ไม่ต้องนำทรัพยากร Dependency สำหรับGoogleMaps
ออก ดูข้อมูลเพิ่มเติมได้ที่บันทึกประจำรุ่นของเวอร์ชัน 9.0.0จากการตั้งค่าการกําหนดค่าโปรเจ็กต์ Xcode ให้ค้นหา Frameworks, Libraries, และเนื้อหาที่ฝัง ใช้เครื่องหมายลบ(-) เพื่อนำกรอบต่อไปนี้ออก
GoogleMapsBase
(สำหรับการอัปเกรดจากเวอร์ชันที่เก่ากว่า 9.0.0 เท่านั้น)GoogleMapsCore
(สำหรับการอัปเกรดจากเวอร์ชันที่เก่ากว่า 9.0.0 เท่านั้น)GoogleMapsM4B
(สำหรับการอัปเกรดจากเวอร์ชันที่เก่ากว่า 9.0.0 เท่านั้น)
- จาก Xcode ให้ไปที่ "ไฟล์ > แพ็กเกจ > อัปเดตเป็นแพ็กเกจเวอร์ชันล่าสุด"
- หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนทรัพยากร Dependency ของแพ็กเกจของตัวนำทางโปรเจ็กต์เพื่อยืนยันแพ็กเกจและเวอร์ชันของแพ็กเกจ
หากต้องการนำ Places SDK ที่มีอยู่สำหรับทรัพยากร Dependency ของ iOS ที่เพิ่มโดยใช้ CocoaPods
ออก ให้ทำตามขั้นตอนต่อไปนี้
- ปิดพื้นที่ทำงาน Xcode เปิดเทอร์มินัลและเรียกใช้คำสั่งต่อไปนี้
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
นำ
Podfile
,Podfile.resolved
และ Xcodeworkspace
ออกหากไม่ได้ใช้งานในทางอื่นใดนอกเหนือจาก CocoaPods
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', '8.3.0' end
การบำรุงรักษาและการอัปเกรด
หากต้องการสร้างด้วยการปรับปรุงล่าสุด ให้หมั่นตรวจหาเวอร์ชันใหม่และอัปเดตข้อมูลจำเพาะของเวอร์ชัน หากคุณกำลังอัปเดตเป็นเวอร์ชันหลักใหม่ ให้ตรวจสอบบันทึกประจำรุ่นเพื่อดูการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลังและวิธีอัปเดตโค้ด
ผู้จัดการแพ็กเกจของ Swift
หากต้องการอัปเดต package
สำหรับโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
หากอัปเกรดจากเวอร์ชันที่เก่ากว่า 9.0.0 คุณต้องนำทรัพยากร Dependency ต่อไปนี้ออก
GoogleMapsBase
,GoogleMapsCore
และGoogleMapsM4B
หลังจากอัปเกรด ไม่ต้องนำทรัพยากร Dependency สำหรับGoogleMaps
ออก ดูข้อมูลเพิ่มเติมได้ที่บันทึกประจำรุ่นของเวอร์ชัน 9.0.0จากการตั้งค่าการกําหนดค่าโปรเจ็กต์ Xcode ให้ค้นหา Frameworks, Libraries, และเนื้อหาที่ฝัง ใช้เครื่องหมายลบ(-) เพื่อนำกรอบต่อไปนี้ออก
GoogleMapsBase
(สำหรับการอัปเกรดจากเวอร์ชันที่เก่ากว่า 9.0.0 เท่านั้น)GoogleMapsCore
(สำหรับการอัปเกรดจากเวอร์ชันที่เก่ากว่า 9.0.0 เท่านั้น)GoogleMapsM4B
(สำหรับการอัปเกรดจากเวอร์ชันที่เก่ากว่า 9.0.0 เท่านั้น)
- จาก Xcode ให้ไปที่ "ไฟล์ > แพ็กเกจ > อัปเดตเป็นแพ็กเกจเวอร์ชันล่าสุด"
- หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนทรัพยากร Dependency ของแพ็กเกจของตัวนำทางโปรเจ็กต์เพื่อยืนยันแพ็กเกจและเวอร์ชันของแพ็กเกจ
CocoaPods
เปิดเทอร์มินัลและไปที่ไดเรกทอรีที่มี
Podfile
:cd <path-to-project>
- เรียกใช้
pod outdated
เพื่อดูว่า Places SDK สำหรับ iOS เวอร์ชันใหม่พร้อมใช้งานหรือไม่ - หากพบ SDK เวอร์ชันใหม่กว่า ให้อัปเดต
Podfile
เป็นเวอร์ชันใหม่นี้ ดูการระบุเวอร์ชันพ็อดเพื่อดูวิธีตั้งค่าเวอร์ชันเฉพาะในPodfile
- เรียกใช้
pod update
- ทำการเปลี่ยนแปลงที่จำเป็นหลังการอัปเกรด ดูรายการการเปลี่ยนแปลงในแต่ละรุ่นได้ที่บันทึกประจำรุ่น
- ล้างและสร้างโปรเจ็กต์อีกครั้งโดยเลือกผลิตภัณฑ์ > ล้าง จากนั้นเลือกผลิตภัณฑ์ > บิลด์
การติดตั้งด้วยตนเอง
รับลิงก์ไปยังไฟล์ต้นฉบับล่าสุด ในขั้นตอนการติดตั้ง SDK
นอกเหนือจากการสำรวจแอปเวอร์ชันใหม่แล้ว เจ้าของโปรเจ็กต์ของ Google Cloud จะได้รับอีเมลเกี่ยวกับการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลังซึ่งอาจส่งผลต่อโปรเจ็กต์ของตน หากต้องการรับการแจ้งเตือนเชิงรุกเกี่ยวกับการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลัง ให้มอบหมายบทบาทเจ้าของด้วยอีเมลที่ได้รับการตรวจสอบของแต่ละโปรเจ็กต์