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

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

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

ลิงก์กับเวอร์ชันใด

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

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

  ข้อดี

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

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

  ข้อดี

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

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

การติดตั้ง

Swift Package Manager

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

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

1. เปิด Xcode project หรือ workspace แล้วไปที่ไฟล์ > เพิ่มทรัพยากร Dependency ของแพ็กเกจ
2. ป้อน https://github.com/googlemaps/ios-maps-sdk เป็น URL แล้วกด Enter เพื่อดึงแพ็กเกจเข้ามา แล้วคลิก "Add Package"
3. หากต้องการติดตั้ง version ที่เฉพาะเจาะจง ให้ตั้งค่าช่องกฎการขึ้นต่อกันเป็นตัวเลือกตามเวอร์ชันตัวเลือกใดตัวเลือกหนึ่ง สําหรับโปรเจ็กต์ใหม่ เราขอแนะนําให้ระบุเวอร์ชันล่าสุดและใช้ตัวเลือก "เวอร์ชันที่แน่นอน" เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ"
4. จากหน้าต่างเลือกผลิตภัณฑ์แพ็กเกจ ให้ยืนยันว่าระบบจะเพิ่ม GoogleMaps (สำหรับเวอร์ชันก่อน 9.0.0 ให้ยืนยัน GoogleMaps, GoogleMapsBase และ GoogleMapsCore) ลงในเป้าหมาย main ที่กำหนด เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ"
5. หากต้องการยืนยันการติดตั้ง ให้ไปที่แผงทั่วไปของเป้าหมาย ใน Frameworks, Libraries, and Embedded Content คุณควรเห็นแพ็กเกจที่ติดตั้งไว้ นอกจากนี้ คุณยังดูส่วน "Package Dependencies" ของ "Project Navigator" เพื่อยืนยันแพ็กเกจและเวอร์ชันได้ด้วย

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

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

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

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

สำคัญ: บางครั้งอาร์ติแฟกต์อาจไม่ได้รับการแก้ไขหรืออาจเกิดข้อผิดพลาด ในกรณีนี้ ให้เลือก "File > Packages > Reset Package Cache"

หากต้องการนำทรัพยากร 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

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

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

Swift Package Manager

To update the package for an existing project, follow these steps:

  

    
    
    

      To verify your installation, go to the Package Dependencies section of Project Navigator
      to verify the package and its version.
    
  
  
  

    Important: Sometimes, artifacts cannot be resolved or errors can occur, 
    in this case select "File > Packages > Reset Package Cache".
  

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

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

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