بروتوبوف
Protocol
حقوق الطبع والنشر لعام 2023 مملوكة لشركة Google LLC
المخازن المؤقتة للبروتوكول (المعروفة أيضًا باسم protobuf) هي آلية Google المحايدة للغة والمنصة المحايدة والقابلة للتوسيع لإجراء تسلسل للبيانات المنظمة. يمكنك معرفة المزيد عنها في وثائق protobuf.
يحتوي ملف README هذا على تعليمات تثبيت protobuf. لتثبيت protobuf، تحتاج إلى تثبيت مترجم البروتوكول (المستخدم لتجميع ملفات .proto) ووقت تشغيل protobuf للغة البرمجة التي اخترتها.
سيجد معظم المستخدمين أن العمل من الإصدارات المدعومة هو المسار الأسهل.
إذا اخترت العمل من المراجعة الرئيسية للفرع الرئيسي، فسيتم أحيانًا كسر البنية الخاصة بك بسبب التغييرات غير المتوافقة مع المصدر والسلوك الذي لم يتم اختباره بشكل كافٍ (وبالتالي معطل).
إذا كنت تستخدم C++ أو كنت بحاجة إلى إنشاء protobuf من المصدر كجزء من مشروعك، فيجب عليك تثبيت التزام الإصدار على فرع الإصدار.
وذلك لأنه حتى فروع الإصدار يمكن أن تواجه بعض عدم الاستقرار بين التزامات الإصدار.
مترجم protobuf مكتوب بلغة C++. إذا كنت تستخدم C++، فيرجى اتباع تعليمات تثبيت C++ لتثبيت protoc مع وقت تشغيل C++.
بالنسبة للمستخدمين الذين لا يستخدمون لغة C++، فإن أبسط طريقة لتثبيت مترجم البروتوكول هي تنزيل ملف ثنائي تم إنشاؤه مسبقًا من صفحة إصدار GitHub الخاصة بنا.
في قسم التنزيلات بكل إصدار، يمكنك العثور على ثنائيات معدة مسبقًا في حزم مضغوطة: protoc-$VERSION-$PLATFORM.zip . أنه يحتوي على ثنائي protoc بالإضافة إلى مجموعة من ملفات .proto القياسية الموزعة مع protobuf.
إذا كنت تبحث عن إصدار قديم غير متوفر في صفحة الإصدار، فراجع مستودع Maven.
يتم توفير هذه الثنائيات المعدة مسبقًا فقط للإصدارات التي تم إصدارها. إذا كنت تريد استخدام الإصدار الرئيسي من github في HEAD، أو كنت بحاجة إلى تعديل كود protobuf، أو كنت تستخدم C++، فمن المستحسن إنشاء ثنائي protoc خاص بك من المصدر.
إذا كنت ترغب في إنشاء برنامج protoc ثنائي من المصدر، راجع تعليمات تثبيت C++.
يدعم Protobuf العديد من لغات البرمجة المختلفة. لكل لغة برمجة، يمكنك العثور على تعليمات في الدليل المصدر المقابل حول كيفية تثبيت وقت تشغيل protobuf لتلك اللغة المحددة:
| لغة | مصدر |
|---|---|
| C++ (يتضمن وقت تشغيل C++ والبروتوكول) | src |
| جافا | java |
| بايثون | بيثون |
| الهدف-C | موضوعي ج |
| ج# | com.csharp |
| روبي | روبي |
| يذهب | Protocolbuffers/protobuf-go |
| PHP | PHP |
| دارت | dart-lang/protobuf |
| جافا سكريبت | مخازن البروتوكول/protobuf-javascript |
أفضل طريقة لتعلم كيفية استخدام protobuf هي اتباع البرامج التعليمية الموجودة في دليل المطور الخاص بنا.
إذا كنت تريد التعلم من أمثلة التعليمات البرمجية، فقم بإلقاء نظرة على الأمثلة الموجودة في دليل الأمثلة.
الوثائق الكاملة متاحة على موقع مستند Protocol Buffers.
اقرأ عن سياسة دعم الإصدارات الخاصة بنا لتبقى مطلعًا على الأطر الزمنية للدعم لمكتبات اللغات.
ليتم تنبيهك بالتغييرات القادمة في المخازن المؤقتة للبروتوكول والتواصل مع مطوري ومستخدمي protobuf، انضم إلى مجموعة Google.
