Was ist der beste Weg, um eine Binärdatei meines Projekts auf GitHub zu verteilen?

Question

Ich habe eine small github repo MS Word-Dokumente zu konvertieren, aber die meisten Menschen wollen nur die Binärdatei.

Sollte ich

• reorganisieren meine Repo ein src/ und bin/ Verzeichnisse haben, mit dem die meisten bis zu Datum .exe in mit dem Code und erwarten, dass die Menschen die ganze Menge zum Download?
• Kompilieren und platzieren Sie meine Binärdatei irgendwo anders im Internet und verknüpfen Sie sie?
• Schließen Sie meine Binärdatei in meinen Repo ein, aber verlinken Sie sie separat?

Answer 1

Um diese Binärdatei für Ihre Anwendung zu hosten, können Sie jetzt since 2nd July 2013, eine Freigabe definieren.

Releases, ein Workflow für den Versand von Software an Endbenutzer.
Releases sind erstklassige Objekte mit Changelogs und binären Assets, die eine vollständige Projekthistorie jenseits von Git-Artefakten darstellen.Sie sind zugänglich von einem Repository-Homepage:

• Releases von Release Notes und Links begleitet werden, die Software oder Quellcode zum Download bereit.
• Nach den Konventionen vieler Git-Projekte sind Releases an Git-Tags gebunden. Sie können ein vorhandenes Tag verwenden oder Releases das Tag erstellen lassen, wenn es veröffentlicht wird.
• Sie können auch binäre Assets (wie kompilierte ausführbare Dateien, minimierte Skripts, Dokumentation) an ein Release anhängen. Nach der Veröffentlichung sind die Veröffentlichungsdetails und -elemente für jeden verfügbar, der das Repository anzeigen kann.

dass die old binary upload service ersetzt, die removed in December 2012 war (wie Sie in Ihrer Frage erwähnen).

Answer 2

Wahrscheinlich nicht das, was Sie hören möchten, aber in Ihrem Fall ist dies meist persönliche Vorlieben.

Sie müssen die Binärdatei nicht im Repo speichern, da dies keine wichtige Abhängigkeit ist. Es ist umgekehrt: Alles, was Sie brauchen, um die Datei neu zu erstellen, sollte sich in Ihrem Repository befinden (einschließlich Makefiles/Projektdateien).

Sie können die Binärdatei im Repo speichern, da sie ziemlich klein ist. Sie sollten es nicht im Repository speichern, wenn die Gesamtgröße im Repository (Basisgröße + Diffs, abhängig davon, wie groß die Diffs sind) überwältigend ist, aber das scheint nicht der Fall zu sein (500 KiB nach Ihrem Repo).

---

Meine persönliche Präferenz ist, niemals speichern generierten Dateien (Binärdateien, sondern auch erzeugt Textdateien) im Repo. Möglicherweise, weil ich Erfahrung mit 2 GiB CSV-Repositories habe, die ewig dauern, um zu ziehen. (um fair zu sein: es braucht auch ewig um kompiliert zu werden)

Für mein github Projekt habe ich eine Subdomain auf einem Webspace erstellt, wo ich alle meine Downloads und die Indexseite dieser Subdomain auf meine github-Seiten weiterleite. Die github-Seiten verlinken auf die Downloads meiner Webspace-Subdomain. Nur weil ich meine Github Subdomain ein wenig mehr für dieses Projekt mag.

Mein Tool funktioniert zwar für verschiedene Plattformen, so dass nicht jeder Benutzer jede Binärdatei benötigt. Die Binärdateien sind eigentlich Backends (daher Abhängigkeiten), aber austauschbar/optional

Sie können sehen my setup.

Answer 3

Sie können dies versuchen: http://sourceforge.net/publish/?source=github

Es sieht vielversprechend aus der Lage sein, „auf Github zu schaffen, sondern auf Source verteilen“.