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

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

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

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

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

    ข้อดี

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

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

    ข้อดี

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

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

การติดตั้ง

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

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

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

platform :ios, '14.0'

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

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

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

การใช้ CocoaPods

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

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

กำหนดเอง

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

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