mcap

MCAP

MCAP عبارة عن تنسيق وحاوية وحاوية معيارية ومكتبة تسجيل لرسائل Pub/Sub مع تسلسل الرسائل التعسفية. إنه مخصص في المقام الأول للاستخدام في تطبيقات الروبوتات ، ويعمل بشكل جيد في إطار أعباء العمل المختلفة وقيود الموارد ومتطلبات المتانة.

الوثائق

• مواصفات تنسيق الملف
  • تعريف بنية 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 من صفحة الإصدارات.

رخصة

رخصة معهد ماساتشوستس للتكنولوجيا.

عملية التحرير

يتبع ترقيم الإصدار تنسيقًا رئيسيًا.

سيقوم CI ببناء الحزم المناسبة بمجرد دفع العلامات ، كما هو موضح أدناه.

اذهب مكتبة

1. قم بتحديث Version في go/mcap/version.go
2. علامة إصدار مطابقة رقم الإصدار go/mcap/vX.YZ .

CLI

وضع علامة على إصدار releases/mcap-cli/vX.YZ .

يتم تعيين رقم الإصدار في وقت الإنشاء بناءً على العلامة.

C ++

1. قم بتحديث الإصدار في جميع الملفات ذات الصلة
   • CPP/مقعد/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/تشمل/conanfile.py
   • CPP/Test/Conanfile.py
2. علامة إصدار مطابقة لإصدارات رقم releases/cpp/vX.YZ

بيثون

هناك العديد من حزم بيثون. تحديث أي يتبع عملية مماثلة.

1. قم بتحديث الإصدار في ملف __init.py__ المناسب
2. وضع علامة على الإصدار
   • بالنسبة لمكتبة MCAP الأساسية ، تطابق releases/python/vX.YZ
   • للحزم الأخرى ، استخدم releases/python/PACKAGE/vX.YZ
     • على سبيل المثال ، releases/python/mcap/v1.2.3

TypeScript

هناك العديد من حزم TS. تحديث أي يتبع عملية مماثلة.

1. قم بتحديث الإصدار في package.json المناسبة. json
2. علامة إصدار releases/typescript/PACKAGE/vX.YZ
   • على سبيل المثال ، releases/typescript/core/v1.2.3

سريع

علامة إصدار مطابقة لإصدارات رقم releases/swift/vX.YZ

الصدأ

1. قم بتحديث الإصدار في Rust/Cargo.toml
2. وضع علامة على إصدار مطابقة 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 سيساعد في نشر الوعي بالمشروع وتعزيز النظام الإيكولوجي.