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

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

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

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

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

    ข้อดี:

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

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

    ข้อดี:

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

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

การติดตั้ง

Swift Package ManagerCocoaPods

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

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

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

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

  1. หากอัปเกรดจากเวอร์ชันที่เก่ากว่า 9.0.0 คุณต้องนําข้อกําหนดต่อไปนี้ออก GoogleMapsBase, GoogleMapsCore และ GoogleMapsM4B หลังจากอัปเกรด อย่านําข้อกําหนดของ GoogleMaps ออก ดูข้อมูลเพิ่มเติมได้ที่บันทึกประจำรุ่นของเวอร์ชัน 9.0.0

    จากการตั้งค่าการกําหนดค่าโปรเจ็กต์ Xcode ให้ค้นหาเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง ใช้เครื่องหมายลบ(-) เพื่อนำเฟรมเวิร์กต่อไปนี้ออก

    • GoogleMapsBase (สำหรับการอัปเกรดจากเวอร์ชันที่เก่ากว่า 9.0.0 เท่านั้น)
    • GoogleMapsCore (สำหรับการอัปเกรดจากเวอร์ชันที่เก่ากว่า 9.0.0 เท่านั้น)
    • GoogleMapsM4B (สำหรับการอัปเกรดจากเวอร์ชันที่เก่ากว่า 9.0.0 เท่านั้น)
  2. จาก Xcode ให้ไปที่ "ไฟล์ > แพ็กเกจ > อัปเดตเป็นเวอร์ชันล่าสุดของแพ็กเกจ"
  3. หากต้องการตรวจสอบการติดตั้ง ให้ไปที่ส่วนแพ็กเกจที่ต้องพึ่งพาของเครื่องมือนำทางโปรเจ็กต์เพื่อยืนยันแพ็กเกจและเวอร์ชัน

หากต้องการนําทรัพยากร Dependency ของ Maps SDK สําหรับ iOS ที่มีอยู่ซึ่งเพิ่มโดยใช้ CocoaPods ออก ให้ทําตามขั้นตอนต่อไปนี้

  1. ปิดพื้นที่ทํางาน Xcode เปิดเทอร์มินัลและเรียกใช้คําสั่งต่อไปนี้ 
    sudo gem install cocoapods-deintegrate cocoapods-clean 
pod deintegrate 
pod cache clean --all
  2. นำ Podfile, Podfile.resolved และ Xcode workspace ออกหากคุณไม่ได้ใช้กับสิ่งอื่นนอกเหนือจาก CocoaPods

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

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

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

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '9.3.0'
end

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

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

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

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

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

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

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

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

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