ในตอนนี้ โซลูชันออนดีมานด์และการนําส่งแบบออนดีมานด์พร้อมให้บริการแก่พาร์ทเนอร์บางรายเท่านั้น

หน้านี้ได้รับการแปลโดย Cloud Translation API

SDK สำหรับผู้บริโภคสำหรับเวอร์ชัน iOS

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

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

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

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

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

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

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

การติดตั้ง

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

ผู้จัดการแพ็กเกจของ Swift

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

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

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

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

จาก Xcode ให้ไปที่ "ไฟล์ > แพ็กเกจ > อัปเดตเป็นแพ็กเกจเวอร์ชันล่าสุด"
หากต้องการยืนยันการติดตั้ง ให้ไปที่ส่วนทรัพยากร Dependency ของแพ็กเกจของตัวนำทางโปรเจ็กต์เพื่อยืนยันแพ็กเกจและเวอร์ชันของแพ็กเกจ

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

ปิดพื้นที่ทำงาน Xcode เปิดเทอร์มินัลและเรียกใช้คำสั่งต่อไปนี้
```
sudo gem install cocoapods-deintegrate cocoapods-clean 
pod deintegrate 
pod cache clean --all
```
นำ Podfile, Podfile.resolved และ Xcode workspace ออกหากไม่ได้ใช้งานในทางอื่นใดนอกเหนือจาก CocoaPods

CocoaPods

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

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

    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleRidesharingConsumer', ' 2.2.0'
    end

ตัวอย่างการใช้ Podfile รุ่นเบต้าสำหรับการใช้ SDK สำหรับผู้บริโภคเวอร์ชันเบต้า

    source "https://cpdc-eap.googlesource.com/ridesharing-consumer-sdk"
    source "https://github.com/CocoaPods/Specs.git"

    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleRidesharingConsumer', '2.1.0-beta01.0'
    end

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

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

CocoaPods

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

กำหนดเอง

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

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