ความเข้ากันได้แบบย้อนหลัง

รายงานปัญหา ดูแหล่งที่มา

Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

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

Bazel กำลังพัฒนา เวอร์ชันย่อยที่เผยแพร่เป็นส่วนหนึ่งของเวอร์ชันหลัก LTS จะมีความเข้ากันได้แบบย้อนหลังอย่างเต็มรูปแบบ การเปลี่ยนแปลงระหว่างรุ่น LTS หลักอาจมีการเปลี่ยนแปลงที่เข้ากันไม่ได้ซึ่งต้องใช้ ความพยายามในการย้ายข้อมูล ดูข้อมูลเพิ่มเติมเกี่ยวกับจังหวะการเผยแพร่ Bazel ได้ที่ ประกาศการเผยแพร่ Bazel ที่มีการสนับสนุนระยะยาว (LTS)

สรุป

1. ขอแนะนำให้ใช้ฟีเจอร์แฟล็ก --incompatible_* สำหรับการเปลี่ยนแปลงที่ทำให้เกิดข้อขัดข้อง
2. สำหรับ--incompatible_*ฟีเจอร์ที่ต้องเปิดใช้ด้วยค่าสถานะแต่ละรายการ ปัญหาใน GitHub จะอธิบาย การเปลี่ยนแปลงลักษณะการทำงานและมีเป้าหมายเพื่อจัดทำสูตรการย้ายข้อมูล
3. API และลักษณะการทำงานที่ได้รับการป้องกันโดยฟีเจอร์--experimental_*อาจเปลี่ยนแปลงได้ทุกเมื่อ
4. ห้ามเรียกใช้บิลด์เวอร์ชันที่ใช้งานจริงด้วยแฟล็ก --experimental_* หรือ --incompatible_*

วิธีปฏิบัติตามนโยบายนี้

• สำหรับผู้ใช้ Bazel - วิธีอัปเดต Bazel
• สำหรับผู้ร่วมให้ข้อมูล - แนวทางปฏิบัติแนะนำสำหรับการเปลี่ยนแปลงที่ไม่เข้ากัน
• สำหรับผู้จัดการการเผยแพร่ - วิธีอัปเดตป้ายกำกับปัญหาและการเผยแพร่

ฟังก์ชันการทำงานที่เสถียรคืออะไร

โดยทั่วไปแล้ว API หรือลักษณะการทำงานที่ไม่มี Flag --experimental_... จะถือว่าเป็นฟีเจอร์ที่เสถียรและรองรับใน Bazel

ซึ่งรวมถึงกรณีต่อไปนี้

• ภาษาและ API ของ Starlark
• กฎที่มาพร้อมกับ Bazel
• API ของ Bazel เช่น API การดำเนินการจากระยะไกลหรือโปรโตคอลเหตุการณ์การสร้าง
• แฟล็กและความหมาย

การเปลี่ยนแปลงที่ไม่รองรับและสูตรการย้ายข้อมูล

สำหรับการเปลี่ยนแปลงที่ไม่เข้ากันทุกครั้งในการเปิดตัวเวอร์ชันใหม่ ทีม Bazel ตั้งใจที่จะจัดทำสูตรการย้ายข้อมูลที่จะช่วยคุณอัปเดตโค้ด (ไฟล์ BUILD และ .bzl รวมถึงการใช้งาน Bazel ในสคริปต์ การใช้งาน Bazel API และอื่นๆ)

การเปลี่ยนแปลงที่เข้ากันไม่ได้ควรมี--incompatible_*ที่เกี่ยวข้องและปัญหาใน GitHub ที่สอดคล้องกัน

การสื่อสารการเปลี่ยนแปลงที่ไม่รองรับ

แหล่งข้อมูลหลักเกี่ยวกับการเปลี่ยนแปลงที่ไม่เข้ากันคือปัญหาใน GitHub ที่มีป้ายกำกับ"incompatible-change"

สำหรับการเปลี่ยนแปลงที่ไม่เข้ากันทุกครั้ง ปัญหาจะระบุสิ่งต่อไปนี้

• ชื่อของฟีเจอร์ที่ควบคุมการเปลี่ยนแปลงที่ไม่รองรับ
• คำอธิบายฟังก์ชันการทำงานที่เปลี่ยนแปลง
• สูตรการย้ายข้อมูล

เมื่อการเปลี่ยนแปลงที่ไม่เข้ากันพร้อมสำหรับการย้ายข้อมูลด้วย Bazel ที่ HEAD (และด้วย Bazel รุ่นถัดไปที่เผยแพร่แบบต่อเนื่อง) คุณควรทำเครื่องหมายด้วยป้ายกำกับ migration-ready ปัญหาการเปลี่ยนแปลงที่ไม่เข้ากันจะปิดเมื่อมีการสลับแฟล็กที่ไม่เข้ากันที่ HEAD