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

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

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

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

    ข้อดี

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

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

    ข้อดี

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

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

บริการติดตั้ง

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

CocoaPods

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

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

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

เครื่องมือจัดการแพ็กเกจ Swift

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

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

  1. เปิด Xcode project หรือ workspace แล้วไปที่ไฟล์ > เพิ่มการอ้างอิงแพ็กเกจ
  2. ป้อน https://github.com/googlemaps/ios-driver-sdk เป็น URL กด Enter เพื่อดึงข้อมูลแพ็กเกจ แล้วคลิก "เพิ่มแพ็กเกจ"
  3. หากต้องการติดตั้ง version ที่เจาะจง ให้ตั้งค่าช่องกฎการขึ้นต่อกันเป็นตัวเลือกตามเวอร์ชันรายการใดรายการหนึ่ง สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ระบุเวอร์ชันล่าสุดและใช้ตัวเลือก "เวอร์ชันแบบตรงทั้งหมด" เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ"
  4. จากหน้าต่างเลือกผลิตภัณฑ์แพ็กเกจ ให้ยืนยันว่าจะเพิ่ม GoogleRidesharingDriver ไปยังเป้าหมาย main ที่คุณกำหนด เมื่อเสร็จแล้ว ให้คลิก "เพิ่มแพ็กเกจ"
  5. หากต้องการยืนยันการติดตั้ง ให้ไปที่แผง General ของเป้าหมาย คุณควรเห็นแพ็กเกจที่ติดตั้งไว้ในเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง นอกจากนี้ คุณยังสามารถดูส่วน "การอ้างอิงของแพ็กเกจ" ของ "Project Navigator" เพื่อตรวจสอบแพ็กเกจและเวอร์ชันของแพ็กเกจได้

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

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

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

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

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

  1. ปิดพื้นที่ทำงาน Xcode เปิดเทอร์มินัลและเรียกใช้คำสั่งต่อไปนี้ 
    sudo gem install cocoapods-deintegrate cocoapods-clean 
pod deintegrate 
pod cache clean --all
  2. นำ Podfile, Podfile.resolved และ Xcode workspace ออกหากคุณไม่ได้ใช้ 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 จะได้รับอีเมลเกี่ยวกับการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลังซึ่งอาจส่งผลต่อโปรเจ็กต์ของตน หากต้องการรับการแจ้งเตือนเชิงรุกเกี่ยวกับการเปลี่ยนแปลงที่เข้ากันไม่ได้แบบย้อนหลัง ให้มอบหมายบทบาทเจ้าของด้วยอีเมลที่ได้รับการตรวจสอบสำหรับแต่ละโปรเจ็กต์