buck

استخدم Buck2

هذا الريبو ميت.

يرجى الاطلاع على https://github.com/facebook/buck2 لنظام الإنشاء الذي يحل محله.

يستمر المحتوى القديم أدناه لأغراض تاريخية.

---

باك

باك هو أداة بناء. لمعرفة ما يمكن أن يفعله باك من أجلك ، تحقق من الوثائق على http://buck.build/.

تثبيت

نظرًا لأن Buck يستخدم لبناء Buck ، فإن عملية الإنشاء الأولية تتضمن مرحلتين:

1. استنساخ مستودع باك و bootstrap مع النمل:

 git clone --depth 1 https://github.com/facebook/buck.git
cd buck
ant

يجب أن تستخدم Java 8 أو 11 حتى يتم تجميعها بنجاح. إذا رأيت أخطاء التجميع من ANT ، فتحقق من JAVA_HOME يشير إلى أحد هذه الإصدارات.

2. استخدم نسخة bootstrapped من باك لبناء باك:

 ./bin/buck build --show-output buck
# output will contain something like
# //programs:buck buck-out/gen/programs/buck.pex
buck-out/gen/programs/buck.pex --help

ثنائيات باك بنيت

يمكن تنزيل ثنائيات Buck التي تم إنشاؤها مسبقًا لأي باك sha من https://jitpack.io/com/github/facebook/buck/<sha>/buck-<sha>.pex /buck-<sha>.pex. في المرة الأولى التي يتم فيها طلب إصدار من باك ، تم تصميمه عبر jitpack. نتيجة لذلك ، قد يستغرق الأمر بضع دقائق حتى يصبح هذا الثنائي الأولي متاحًا. كل طلب لاحق سوف يخدم فقط القطع الأثرية المبنية مباشرة. هذه الوظيفة متاحة لأي شوكة من باك أيضًا ، بحيث يمكنك جلب https://jitpack.io/com/github/<github-user-or-org>/buck/<sha>/buck-<sha>.pex

بالنسبة إلى ثنائيات باك بنيت لـ JDK 11 ، تعديل نهاية عنوان URL إلى buck-<sha>-java11.pex .

ميزة إهمال

يحاول باك التحرك بسرعة فيما يتعلق بالداخلية. ومع ذلك ، بالنسبة للميزات التي تواجه المستخدم (قواعد الإنشاء ، واجهة سطر الأوامر ، إلخ) ، يحاول فريق باك أن يكون له عملية إهمال رشيقة. لاحظ أن هذا ينطبق بشكل عام فقط على الوظائف الموثقة ، أو الوظائف الأقل توثيقًا ، ولكن يبدو أنها تستخدم على نطاق واسع. هذه العملية هي:

• يتم فتح مشكلة على Github تشير إلى ما سيتم إهماله ، ومتى ستتم إزالته. بالنسبة للميزات الأكبر التي يتم إهمالها ، قد تكون هناك فترة يكون فيها الافتراضي هو الإعداد الجديد ، ويمكن استخدام السلوك القديم فقط مع تغيير التكوين.
  • يتم وضع علامة على قضايا الإهمال قيد التنفيذ مع "إعلان" و "إهمال"
• يتم تقديم التغيير إلى باك الذي يضع السلوك القديم وراء علامة التكوين ويضع الافتراضي للسلوك القديم. يمكن العثور على هذه الأعلام على https://buck.build/concept/buckconfig.html#inciptible.
• بالنسبة للميزات الأكبر ، يتم وضع التغيير في نهاية المطاف في مكان يضع الافتراضي للسلوك الجديد. على سبيل المثال عندما يصبح Skylark محلل الملف الافتراضي.
• عند الوصول إلى تاريخ الإزالة ، يتم تقديم تغيير لإزالة الميزة. في هذه المرحلة ، ستظل قيمة التكوين تحليلًا ، ولكن لن يتم استخدامها بواسطة Buck داخليًا.

رخصة

ترخيص Apache 2.0