buck

Verwenden Sie Buck2

Dieses Repo ist tot.

Weitere Informationen finden Sie unter https://github.com/facebook/Buck2 für das Build -System, das es ersetzt.

Der alte Inhalt wird nach unten für historische Zwecke fortgesetzt.

---

Bock

Buck ist ein Build -Werkzeug. Um zu sehen, was Buck für Sie tun kann, sehen Sie sich die Dokumentation unter http://buck.build/ an.

Installation

Da Buck zum Bau von Buck verwendet wird, umfasst der anfängliche Build -Prozess 2 Phasen:

1. Klonen Sie das Buck -Repository und Bootstrap mit ANT:

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

Sie müssen Java 8 oder 11 verwenden, damit dies erfolgreich zusammengestellt werden kann. Wenn Sie Kompilierungsfehler von ANT sehen, überprüfen Sie Ihr JAVA_HOME auf eine dieser Versionen.

2. Verwenden Sie die Bootstrap -Version von Buck, um Buck zu bauen:

 ./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

Binärdateien vorgebaut

Vorbereitete Binärdateien von Buck für jeden Buck sha können von https://jitpack.io/com/github/facebook/buck/<sha>/buck-<sha>.pex heruntergeladen werden. Das erste Mal, dass eine Version von Buck angefordert wird, wird sie über Jitpack erstellt. Infolgedessen könnte es einige Minuten dauern, bis diese anfängliche Binärdatei verfügbar ist. Jede nachfolgende Anfrage dient nur dem gebauten Artefakt direkt. Diese Funktionalität ist auch für jede Gabel von Buck verfügbar, sodass Sie https://jitpack.io/com/github/<github-user-or-org>/buck/<sha>/buck-<sha>.pex

Für die für JDK 11 gebaute Buckellbinärdateien ändern Sie das Ende der URL zu buck-<sha>-java11.pex .

Abwertung aufweisen

Buck versucht, sich in Bezug auf seine Interna schnell zu bewegen. Für Benutzer, die Funktionen (Erstellen von Regeln, Befehlszeilenschnittstellen usw.) ausgesetzt sind, versucht das Buck -Team jedoch, einen anmutigen Abschaltungsprozess zu haben. Beachten Sie, dass dies im Allgemeinen nur für dokumentierte Funktionen oder Funktionen gilt, die weniger dokumentiert sind, aber in großem Umfang verwendet werden. Dieser Prozess ist:

• Bei Github wird ein Problem eröffnet, das vorschlägt, was veraltet wird und wann es entfernt wird. Bei größeren Merkmalen, die veraltet sind, kann es einen Zeitraum geben, in dem die Standardeinstellung die neue Einstellung ist, und das alte Verhalten kann nur mit einer Konfigurationsänderung verwendet werden.
  • In der progressionenden Abwertung werden Probleme mit der Ankündigung und "Abschaltung" markiert
• Es wird eine Änderung an Buck übermittelt, die das alte Verhalten hinter ein Konfigurationsflag setzt und die Standardeinstellung auf das alte Verhalten setzt. Diese Flaggen finden Sie unter https://buck.build/concept/buckconfig.html#incompatible.
• Bei größeren Funktionen wird schließlich eine Änderung vorgenommen, die den Standard für das neue Verhalten festlegt. ZB, wenn Skylark zum Standard -Parser für Build -Datei wird.
• Wenn das Entfernungsdatum erreicht ist, wird eine Änderung eingereicht, um die Funktion zu entfernen. Zu diesem Zeitpunkt wird der Konfigurationswert weiterhin analysiert, wird jedoch nicht intern von Buck verwendet.

Lizenz

Apache -Lizenz 2.0