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

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

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

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

    สิทธิประโยชน์

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

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

    สิทธิประโยชน์

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

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

การติดตั้ง

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

CocoaPods

ตัวอย่างทรัพยากร Dependency ของ Podfile โดยใช้ Podfile ไวยากรณ์:

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

      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver', '2.0.0'
      end
    

Swift Package Manager

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

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

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

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

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

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

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

Cocoapods

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

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

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

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

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