mcap

mcap

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

เอกสาร

• ข้อกำหนดรูปแบบไฟล์
  • คำจำกัดความของโครงสร้าง Kaitai
• แรงจูงใจ
• เมทริกซ์สนับสนุน

นักพัฒนาเริ่มต้นอย่างรวดเร็ว

ห้องสมุด MCAP มีให้ในภาษาต่อไปนี้ สำหรับคำแนะนำเกี่ยวกับแต่ละภาษาโปรดดู readme ที่เกี่ยวข้อง:

ภาษา	readme	เอกสาร API	ชื่อแพ็คเกจ	รุ่น
C ++	readme	เอกสาร API	mcap
ไป	readme	เอกสาร API		ดูรุ่น
งูหลาม	readme	เอกสาร API	mcap
JavaScript/typescript	readme	เอกสาร API	@mcap/core
ฉับพลัน	readme	เอกสาร API		ดูรุ่น
สนิม	readme	เอกสาร API	mcap

ในการเรียกใช้การทดสอบตามความสอดคล้องคุณจะต้องใช้ GIT LFS ซึ่งใช้ในการจัดเก็บบันทึกการทดสอบภายใต้ tests/conformance/data

เครื่องมือ CLI

โต้ตอบกับไฟล์ MCAP จากบรรทัดคำสั่งโดยใช้เครื่องมือ MCAP CLI

ดาวน์โหลดเวอร์ชัน mcap-cli ล่าสุดจากหน้ารีลีส

ใบอนุญาต

ใบอนุญาต MIT

กระบวนการปลดปล่อย

การปล่อยหมายเลขตามรูปแบบ Minor.minor.patch ย่อเป็น "XYZ" ด้านล่าง

CI จะสร้างแพ็คเกจที่เหมาะสมเมื่อมีการผลักแท็กตามที่อธิบายไว้ด้านล่าง

ไปห้องสมุด

1. อัปเดต Version ใน GO/MCAP/เวอร์ชัน GO
2. Tag a release ที่ตรงกับหมายเลขเวอร์ชัน go/mcap/vX.YZ

CLI

แท็กการจับคู่ releases/mcap-cli/vX.YZ

หมายเลขเวอร์ชันถูกตั้งค่าตามเวลาการสร้างตามแท็ก

C ++

1. อัปเดตเวอร์ชันในไฟล์ที่เกี่ยวข้องทั้งหมด
   • cpp/bench/conanfile.py
   • CPP/build-docs.sh
   • CPP/build.sh
   • cpp/docs/conanfile.py
   • CPP/ตัวอย่าง/conanfile.py
   • CPP/MCAP/include/mcap/types.hpp ( MCAP_LIBRARY_VERSION )
   • CPP/MCAP/include/conanfile.py
   • cpp/test/conanfile.py
2. Tag a release ที่ตรงกับหมายเลข releases/cpp/vX.YZ

งูหลาม

มีแพ็คเกจงูหลามหลายแห่ง อัปเดตตามกระบวนการที่คล้ายกัน

1. อัปเดตเวอร์ชันในไฟล์ __init.py__ ที่เหมาะสม
2. ติดแท็กรุ่น
   • สำหรับไลบรารี Core MCAP ให้จับคู่รูปแบบรุ่น releases/python/vX.YZ
   • สำหรับแพ็คเกจอื่น ๆ ให้ใช้ releases/python/PACKAGE/vX.YZ
     • ตัวอย่างเช่น releases/python/mcap/v1.2.3

ตัวพิมพ์ใหญ่

มีแพ็คเกจ TS หลายแห่ง อัปเดตตามกระบวนการที่คล้ายกัน

1. อัปเดตเวอร์ชันใน package.json ที่เหมาะสม
2. แท็กการจับคู่ releases/typescript/PACKAGE/vX.YZ
   • ตัวอย่างเช่น releases/typescript/core/v1.2.3

ฉับพลัน

Tag a release ที่ตรงกับหมายเลข releases/swift/vX.YZ

สนิม

1. อัปเดตเวอร์ชันใน Rust/Cargo.toml
2. Tag a release ที่ตรงกับหมายเลข releases/rust/vX.YZ

การอ้างอิง

หากคุณใช้ MCAP ในการวิจัยของคุณโปรดอ้างอิงในงานของคุณ รูปแบบการอ้างอิงที่แนะนำของเราคือ:

 @software{MCAP,
  title = {MCAP: serialization-agnostic log container file format},
  author = {{Foxglove Developers}},
  url = {https://mcap.dev},
  version = {your version},
  date = {your date of access},
  year = {2024},
  publisher = {{Foxglove Technologies}},
  note = {Available from https://github.com/foxglove/mcap}
}

โปรดแทนที่ฟิลด์เวอร์ชันและวันที่ด้วยซอฟต์แวร์เวอร์ชันที่คุณใช้และวันที่ที่คุณได้รับ การอ้างถึง MCAP จะช่วยกระจายการรับรู้ของโครงการและเสริมสร้างระบบนิเวศ