ทีม Google Maps Platform จะอัปเดต SDK เป็นประจำด้วยฟีเจอร์ใหม่ การแก้ไขข้อบกพร่อง และ การปรับปรุงประสิทธิภาพ หน้านี้ให้คำแนะนำเกี่ยวกับวิธีจัดการการอ้างอิงใน SDK บนอุปกรณ์เคลื่อนที่
จะลิงก์กับเวอร์ชันใด
-
สำหรับแอปที่มีความสำคัญต่อภารกิจ ให้ลิงก์ไปยังเวอร์ชันย่อยล่าสุดของเวอร์ชันหลัก ที่คุณใช้ (X.*) และอัปเกรดเป็นเวอร์ชันหลักใหม่ทุกปี
เมื่อเผยแพร่แอปพลิเคชันเวอร์ชันใหม่ ตลอดทั้งปี คุณอาจเริ่มใช้ Maps SDK สำหรับ iOS เวอร์ชันใหม่ที่มีจุด ซึ่ง ไม่จำเป็นต้องอัปเดตในแอปพลิเคชันเนื่องจากเวอร์ชันย่อยใหม่ๆ จะใช้งานร่วมกับเวอร์ชันก่อนหน้าได้
ข้อดี
- หากพบปัญหาใน Maps SDK สำหรับ iOS เราจะแก้ไขปัญหาในลักษณะที่ เข้ากันได้แบบย้อนหลังเป็นเวลา 12 เดือนหลังจากเปิดตัวเวอร์ชันหลักครั้งแรก ตาม นโยบายการสนับสนุนบนอุปกรณ์เคลื่อนที่ คุณไม่จำเป็นต้องอัปเกรดเป็น SDK เวอร์ชันที่เข้ากันไม่ได้โดยด่วน เพื่อรับประโยชน์จากการแก้ไข
- การปรับปรุงและฟีเจอร์ล่าสุดจะนำมาใช้ได้ง่ายเมื่อแอปสร้างขึ้นบน เวอร์ชันล่าสุดอยู่แล้ว
- การอัปเดต SDK เป็นเวอร์ชันหลักล่าสุดแบบเพิ่มทีละน้อยทุกปีอาจต้องใช้ความพยายามน้อยกว่า ในการปรับ เขียนใหม่ และทดสอบแอปพลิเคชันของคุณ เมื่อเทียบกับการต้องจัดการการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลัง ซึ่งเกิดขึ้นในการเผยแพร่ SDK เวอร์ชันหลักหลายเวอร์ชัน
สำหรับแอปที่ไม่สำคัญ ให้ลิงก์ไปยังเวอร์ชันที่แก้ไขแล้ว เมื่อคุณได้รับการแจ้งเตือนการเลิกใช้งาน สำหรับเวอร์ชันที่แก้ไขแล้ว คุณจะมีเวลา 12 เดือนในการทำให้โค้ดแอปที่อัปเดตพร้อมใช้งานสำหรับ ผู้ใช้
ข้อดี
- งานบำรุงรักษามีความถี่น้อยลง
- แอปเวอร์ชันใหม่จะรองรับอุปกรณ์ของผู้ใช้ที่ใช้ระบบปฏิบัติการบนอุปกรณ์เคลื่อนที่เวอร์ชันเก่าได้นานขึ้น (จนกว่าคุณจะต้องอัปเกรดเป็น SDK เวอร์ชันใหม่)
เจ้าของโปรเจ็กต์ที่มีอีเมลที่ตรวจสอบแล้วจะได้รับการแจ้งเตือนเชิงรุกเกี่ยวกับการเปลี่ยนแปลงที่ ส่งผลกระทบต่อโปรเจ็กต์แต่ละรายการ รับทราบข้อมูลเกี่ยวกับการอัปเดตที่สำคัญ การเลิกใช้งาน และการเปลี่ยนแปลงอื่นๆ
การติดตั้ง
Swift Package Manager
คุณติดตั้ง Maps SDK สำหรับ iOS ได้ผ่าน Swift Package Manager หากต้องการเพิ่ม SDK ให้ตรวจสอบว่าคุณได้ นำทรัพยากร Dependency ของ Maps SDK สำหรับ iOS ที่มีอยู่ออกแล้ว
หากต้องการเพิ่ม SDK ลงในโปรเจ็กต์ใหม่หรือที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
-
เปิด Xcode
project
หรือworkspace
แล้วไปที่File > Add Package Dependencies - ป้อน https://github.com/googlemaps/ios-maps-sdk เป็น URL แล้วกด Enter เพื่อดึงแพ็กเกจ แล้วคลิก "เพิ่มแพ็กเกจ"
-
หากต้องการติดตั้ง
version
ที่เฉพาะเจาะจง ให้ตั้งค่าฟิลด์กฎการขึ้นต่อกันเป็นตัวเลือกใดตัวเลือกหนึ่ง ที่อิงตามเวอร์ชัน สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ระบุเวอร์ชันล่าสุดและ ใช้ตัวเลือก "เวอร์ชันที่แน่นอน" เมื่อดำเนินการเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ"
หากต้องการอัปเดต package
สำหรับโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
หากอัปเกรดจากเวอร์ชันก่อน 9.0.0 คุณต้องนำการอ้างอิงต่อไปนี้ออก
GoogleMapsBase
,GoogleMapsCore
และGoogleMapsM4B
หลังจากอัปเกรด อย่านำการอ้างอิงสำหรับGoogleMaps
ออก ดูข้อมูลเพิ่มเติมได้ที่บันทึกประจำรุ่น 9.0.0จากการตั้งค่าการกำหนดค่าโปรเจ็กต์ Xcode ให้ค้นหาเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง ใช้เครื่องหมายลบ(-) เพื่อนำเฟรมเวิร์กต่อไปนี้ออก
GoogleMapsBase
(ใช้สำหรับการอัปเกรดจากเวอร์ชันก่อนหน้า 9.0.0 เท่านั้น)GoogleMapsCore
(ใช้สำหรับการอัปเกรดจากเวอร์ชันก่อนหน้า 9.0.0 เท่านั้น)GoogleMapsM4B
(ใช้สำหรับการอัปเกรดจากเวอร์ชันก่อนหน้า 9.0.0 เท่านั้น)
- จาก Xcode ให้ไปที่ "File > Packages > Update To Latest Package Versions"
- หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนการขึ้นต่อกันของแพ็กเกจในProject Navigator เพื่อยืนยันแพ็กเกจและเวอร์ชัน
หากต้องการนำทรัพยากร Dependency ของ Maps SDK สำหรับ iOS ที่มีอยู่ออกซึ่งเพิ่มโดยใช้
CocoaPods
ให้ทำตามขั้นตอนต่อไปนี้
- ปิดพื้นที่ทำงาน Xcode เปิดเทอร์มินัลแล้วเรียกใช้คำสั่งต่อไปนี้
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
นำ
Podfile
,Podfile.resolved
และ Xcodeworkspace
ออกหากคุณไม่ได้ใช้เพื่อวัตถุประสงค์อื่นนอกเหนือจาก CocoaPods
CocoaPods
ระบุหมายเลขเวอร์ชันใน Dependencies เสมอแทนที่จะใช้ตัวดำเนินการแบบมองโลกในแง่ดี
(~>
) เนื่องจากอาจทำให้เกิดบิลด์ที่ไม่สามารถคาดเดาและทำซ้ำได้
Maps SDK สำหรับ iOS เป็นไปตามการกำหนดเวอร์ชันเชิงความหมาย
และการเปิดตัวเวอร์ชันหลักใหม่จะมีการเปลี่ยนแปลงที่ไม่รองรับการทำงานร่วมกับเวอร์ชันก่อนหน้า
ตัวอย่างการอ้างอิง Podfile โดยใช้ไวยากรณ์ Podfile
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '16.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleMaps', '10.1.0' end
การบำรุงรักษาและการอัปเกรด
หากต้องการสร้างโดยใช้การปรับปรุงล่าสุด ให้ตรวจสอบเวอร์ชันใหม่กว่าเป็นประจำและอัปเดตข้อกำหนดเวอร์ชัน หากคุณกำลังอัปเดตเป็นเวอร์ชันหลักใหม่ โปรดดูบันทึกประจำรุ่นเพื่อดูการเปลี่ยนแปลงที่เข้ากันไม่ได้กับเวอร์ชันก่อนหน้าและวิธีอัปเดตโค้ด
Swift Package Manager
หากต้องการอัปเดต package
สำหรับโปรเจ็กต์ที่มีอยู่ ให้ทำตามขั้นตอนต่อไปนี้
- หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนการขึ้นต่อกันของแพ็กเกจในProject Navigator เพื่อยืนยันแพ็กเกจและเวอร์ชัน
Cocoapods
เปิดเทอร์มินัลแล้วไปที่ไดเรกทอรีที่มี
Podfile
cd <path-to-project>
- เรียกใช้
pod outdated
เพื่อดูว่ามี Maps SDK สำหรับ iOS เวอร์ชันใหม่กว่า หรือไม่ - หากพบ SDK เวอร์ชันใหม่กว่า ให้อัปเดต
Podfile
ด้วยเวอร์ชันใหม่นี้ ดูการระบุเวอร์ชันพ็อด เพื่อดูวิธีตั้งค่าเวอร์ชันที่เฉพาะเจาะจงในPodfile
- เรียกใช้
pod update
- ทำการเปลี่ยนแปลงที่จำเป็นอันเป็นผลมาจากการอัปเกรด ดูรายการการเปลี่ยนแปลงในแต่ละรุ่นได้ในบันทึกประจำรุ่น
- ล้างและสร้างโปรเจ็กต์ใหม่โดยเลือกผลิตภัณฑ์ > ล้าง แล้วเลือกผลิตภัณฑ์ > สร้าง
การติดตั้งด้วยตนเอง
รับลิงก์ไปยังไฟล์แหล่งที่มาล่าสุด ที่การติดตั้ง SDK
นอกจากจะตรวจสอบเวอร์ชันใหม่กว่าแล้ว เจ้าของโปรเจ็กต์ Google Cloud ยังได้รับอีเมลเกี่ยวกับการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลังซึ่งอาจส่งผลต่อโปรเจ็กต์ของตนด้วย หากต้องการรับการแจ้งเตือนล่วงหน้าเกี่ยวกับการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลัง มอบหมายบทบาทเจ้าของด้วยอีเมลที่ตรวจสอบแล้วสำหรับแต่ละโปรเจ็กต์