เวอร์ชัน

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

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

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

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

    ข้อดี

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

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

    ข้อดี

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

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

การติดตั้ง

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

การใช้ CocoaPods

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

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

platform :ios, '13.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '7.1.0'
end

การใช้คาร์เธจ

ตัวอย่างการใช้ Cartfile ที่ใช้ไวยากรณ์ Cartfile

binary "https://dl.google.com/geosdk/GoogleMaps.json" == 6.2.1

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

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

การใช้ CocoaPods

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

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

การใช้คาร์เธจ

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

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

กำหนดเอง

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

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