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

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

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

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

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

  ข้อดี:

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

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

  ข้อดี:

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

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

การติดตั้ง

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

หมายเหตุ: Driver SDK สำหรับ iOS ไม่รองรับการติดตั้งโดยใช้ Carthage

CocoaPods

ตัวอย่างความเกี่ยวข้องของ 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 โปรดตรวจสอบว่าคุณได้นำ Dependency ของ Driver SDK ที่มีอยู่ออกแล้ว

สำคัญ: วิธีการเหล่านี้จะถือว่าใช้ Xcode 15 ขึ้นไป แต่ควรคล้ายกับ Xcode เวอร์ชันก่อนหน้า

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

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

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

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

สำคัญ: ในบางครั้ง ระบบอาจแก้ไขอาร์ติแฟกต์ไม่ได้หรือเกิดข้อผิดพลาดขึ้น ในกรณีนี้ ให้เลือก "ไฟล์ > แพ็กเกจ > รีเซ็ตแคชแพ็กเกจ"

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

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

Cocoapods

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

   cd <path-to-project>

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

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

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

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