So installieren Sie Software mit Git unter Linux

Wurde Ihnen gesagt, dass Sie das Repo klonen und erstellen sollen, und Sie wissen nicht, was Sie als Nächstes tun sollen? Wir zeigen Ihnen, wie Sie dieses Programm auf GitHub unter Linux zum Laufen bringen, auch wenn Sie ein Anfänger sind.

Die Anweisungen, aus denen ein Computerprogramm besteht, werden in Textdateien geschrieben, bearbeitet und gespeichert. Ein Compiler genanntes Programm verarbeitet diese Dateien dann. Dadurch entsteht die ausführbare Version des Programms. Die Textdateien der Anweisungen werden als Quellcode bezeichnet. Die Version des Programms, die tatsächlich auf einem Computer ausgeführt werden kann, wird als Binärdatei oder ausführbare Datei bezeichnet.

Das ist eine vereinfachte Version der Ereignisse, aber sie zeichnet ein korrektes – wenn auch verallgemeinertes – Bild. In der Praxis finden Sie alle möglichen Variationen dieses Modells. Manchmal erzeugen andere Programme die Textdateien. In anderen Fällen läuft der Quellcode in einem Interpreter und muss nicht kompiliert werden, und so weiter.

Die eine universelle Wahrheit über alle Softwareprojekte hinweg lautet jedoch: Die Quellcodedateien sind die Kronjuwelen, und sie müssen genauso sorgfältig gepflegt werden.

Versionskontrollprogramme

Alle Quellcodedateien innerhalb eines Projekts werden als Codebasis bezeichnet. Bei großen Projekten arbeiten oft viele Entwickler an der Codebasis. Jede Codeänderung muss nachverfolgt und identifizierbar sein. Gegebenenfalls müssen die Änderungen reversibel sein. Wenn verschiedene Entwickler Änderungen an derselben Quellcodedatei vornehmen, müssen ihre Änderungen zusammengeführt werden.

Es ist daher nicht verwunderlich, dass Softwareprogramme namens Versionskontrollsysteme existieren, um die Verwaltung von Änderungen an der Codebasis zu vereinfachen. Versionskontrollsysteme halten alle früheren Versionen jeder Datei in der Codebasis, und jede Änderung wird aufgezeichnet, kommentiert und verfolgt.

Ein kleines Ding namens Git

Linus Torvalds, der Schöpfer des Linux-Kernels, entwickelte ein Versionskontrollprogramm namens Git, um die Codebasis des Linux-Kernels zu verwalten. Es ist jetzt die weltweit am weitesten verbreitete Versionskontrollsoftware. Es gibt Millionen von Menschen, die es verwenden – buchstäblich.

Bei Git wird die Codebasis eines Projekts in Repositories gespeichert. Zusätzlich zu den lokalen Repositories, die sich auf den Computern der Entwickler und vielleicht auf einem zentralen Server im Netzwerk befinden, ist es eine gute Praxis, ein Offsite- oder Remote-Repository zu haben.

Und hier kommt GitHub ins Spiel.

GitHub

GitHub wurde aufgrund des Erfolgs von git erstellt. Die Gründer sahen den aufkommenden Bedarf an sicher gehosteten Remote- git -Repositories. Sie gründeten ein Unternehmen, das eine Cloud-Plattform bereitstellte, um es Entwicklungsteams zu ermöglichen, Remote-Repositories zu hosten. Ab April 2019 hostet GitHub über 100 Millionen Repositories.

Wenn es sich bei einer Anwendung um ein Open-Source-Projekt handelt, sind die Chancen sehr hoch, dass sie auf GitHub gehostet wird. Es gibt andere Repository-Plattformen wie BitBucket und GitLab, aber GitHub hat den Löwenanteil an Open-Source-Repositorys.

Anatomie eines Repositorys

Ein GitHub-Repository besteht aus Ordnern, die Dateien wie die wichtigen Quellcodedateien enthalten. Normalerweise gibt es viele andere Arten von Dateien im Repository. Es kann Dokumentationsdateien, Handbuchseiten, Softwarelizenzdateien, Bauanleitungen und Shell-Skriptdateien geben. Es gibt keine Regeln dafür, was ein Repository enthalten sollte oder muss, aber es gibt Konventionen.

Wenn Sie sich in einer Küche auskennen, können Sie sich in jeder Küche zurechtfinden. Genauso verhält es sich mit Repositories. Sobald Sie die Konventionen verstanden haben, wissen Sie, wo Sie das finden, was Sie brauchen.

Wie erhalten Sie also eine Kopie des Repositorys auf Ihrem Computer und wie bauen Sie das Programm in eine ausführbare Binärdatei ein?

Die Readme-Datei

Es ist üblich, eine Readme-Datei in ein Repository aufzunehmen. Es könnte Readme, Readme oder README heißen. Es kann die Erweiterung „.md“ oder gar keine Erweiterung haben.

Werfen wir einen Blick auf das GitHub-Repository für den Atom-Editor. Sie sehen eine lange Liste von Ordnern und Dateien. Scrollen Sie nach unten, und Sie sehen den Inhalt der Datei README.md.

GitHub stellt den Inhalt der Readme-Datei automatisch auf die Startseite des Repositorys. Wenn die Readme-Datei die Erweiterung „.md“ hat, enthält sie die Auszeichnungssprache Markdown. Dadurch können die Entwickler Stilelemente wie Schriftarten, Aufzählungszeichen und Bilder verwenden.

In der Regel enthält eine Readme-Datei Abschnitte, in denen Sie erfahren, worum es bei dem Projekt geht, um welchen Lizenztyp es sich handelt, wer das Projekt verwaltet, wie Sie sich beteiligen und wie Sie die Anwendung erstellen und ausführen.

Wenn die eigentlichen Bauanweisungen nicht aufgeführt sind, wird Ihnen mitgeteilt, wo Sie diese Informationen finden. Andere nützliche Informationen zum Erstellen der Anwendung, z. B. die erforderlichen Erstellungstools und andere Abhängigkeiten, sind möglicherweise hier aufgeführt, oder ein Link führt Sie zu diesen Informationen.

Das Boxen-Repository

Unsere Mission ist es, das Box-Repository zu klonen und dann die boxes Anwendung zu erstellen.

Das Repository folgt dem gleichen Layout wie das von Atom. Es gibt eine Liste mit Ordnern und Dateien und darunter den Inhalt der Readme-Datei. Es folgt dem Standardlayout für ein Repository, ist aber ein kleineres Projekt, daher gibt es weniger Ordner und Dateien.

Die Readme-Datei ist auch kürzer. Es hat einen Abschnitt namens „Entwicklung“. In diesem Abschnitt befindet sich ein Link mit dem Titel „Building from Source“. Wenn wir diesem Link folgen, sollten wir die benötigten Informationen finden.

Es ist normalerweise eine leichte Detektivarbeit erforderlich, um durch das Repository zu navigieren und die gewünschten Informationen zu finden, aber es ist nicht schwierig. Lesen Sie alles auf der Repository-Seite sorgfältig durch. Manchmal sind die Informationen vorhanden, werden aber möglicherweise nicht deutlich angezeigt.

Die Abhängigkeiten

Die Seite „Building from Source“ hat einen Abschnitt namens „Building on Linux“, und das ist genau das, was wir brauchen. Es besagt, dass wir einen C-Compiler, Bison und Flex installiert haben müssen.

Die Build-Anweisungen besagen, dass der Befehl make ausgeführt werden soll, also benötigen wir auch make .

Die zum Erstellen dieser Anwendung erforderlichen Tools sind ein C-Compiler, Bison, Flex, make und Git (um das Repository auf Ihren Computer zu klonen).

Dieser Artikel wurde auf Computern recherchiert, auf denen die Linux-Distributionen Ubuntu, Fedora und Manjaro ausgeführt werden. Keine der Distributionen hatte alle diese Tools installiert – auf jedem von ihnen musste etwas installiert werden.

Installieren des Toolsets

Ubuntu musste Git, Flex, Bison und make installiert haben. Hier sind die Befehle:

 sudo apt-get install git 

 sudo apt-get install flex 

 sudo apt-get install bison 

 sudo apt-get install make 

Fedora musste Flex, Bison und make installiert haben. Hier sind die Befehle:

 sudo dnf install flex 

 sudo dnf install bison 

 sudo dnf install make 

Manjaro musste den GCC-Compiler, Flex und Bison installiert haben. Hier sind die Befehle:

 sudo pacman -Syu gcc 

 sudo pacman-Syuflex 

 sudo pacman -Syu-Bison 

Klonen des Repositorys

Jedes GitHub-Repository hat eine bestimmte Webadresse, die mit Git verwendet wird, um das Repository auf Ihren Computer zu klonen. Auf der Hauptseite des Box-Repositorys befindet sich eine grüne Schaltfläche mit der Aufschrift „Klonen oder herunterladen“.

Klicken Sie auf die Schaltfläche, um die Webadresse anzuzeigen. Dies ist die Adresse, die wir an den Befehl git übergeben müssen, wenn wir das Repository klonen.

Wechseln Sie in das Verzeichnis, in das wir das Repository geklont haben möchten, und verwenden Sie dann diesen Befehl. Wenn Ihr Terminalfenster dies unterstützt, können Sie die Webadresse kopieren und in den Befehl einfügen. Drücken Sie Strg+Umschalt+V, um sie in ein GNOME-Terminalfenster einzufügen.

Git klont das Remote-Repository und erstellt ein lokales auf Ihrem Computer. Es teilt uns mit, dass es in ein Verzeichnis namens „boxes“ klont.

Das Verzeichnis boxes wird innerhalb des Verzeichnisses erstellt, von dem aus Sie den Befehl git ausgegeben haben. Wenn wir in das Box-Verzeichnis wechseln und uns den Inhalt ansehen, sehen wir dieselbe Liste von Dateien und Ordnern, die wir auf der GitHub-Seite gesehen haben.

Toll! Wir haben den Quellcode und andere Dateien erfolgreich auf unseren Computer geklont. Jetzt müssen wir die Anwendung erstellen.

Erstellen der Anwendung

Um die Anwendung zu erstellen, müssen wir den Anweisungen im GitHub-Repository folgen. Manchmal führen wir eine bestimmte Shell-Datei aus, und manchmal führen wir make . Die Build-Anweisungen, denen wir folgen, haben uns angewiesen, make auszuführen.

Das Dienstprogramm make liest eine Reihe von Anweisungen aus einem Makefile und führt sie aus. Diese Anweisungen sagen make wie das Programm kompiliert und gelinkt wird. make übergibt die Anweisungen an den Compiler und andere Build-Tools.

Der Befehl, den wir verwenden sollen, ruft make zweimal auf. Der erste Aufruf von make erstellt die Anwendung, und der zweite führt eine Reihe von Tests aus.

Der Befehl, den uns die Build-Anweisungen sagten, lautet:

 machen && test machen 

Viele Zeilen der Ausgabe scrollen schnell im Terminalfenster vorbei. In ungefähr einer Minute kehren Sie zur Eingabeaufforderung zurück.

Bereitstellung der Boxen-Anwendung

Die Anwendung wurde erstellt und wir haben eine ausführbare Binärdatei. Wir müssen nun die Binärdatei in das Verzeichnis /usr/bin/ kopieren. Dadurch kann die Shell es finden, wenn wir versuchen, es zu verwenden.

Für einige Anwendungen ist dies möglicherweise alles, was Sie tun müssen. In anderen Fällen müssen Sie möglicherweise zusätzliche Dateien, z. B. Handbuchseiten und Konfigurationsdateien, an Speicherorte im Dateisystem kopieren. Letzteres müssen wir mit unserer neuen Anwendung machen, weil es in der Bauanleitung stand.

Verwenden Sie sudo , um diese Befehle auszuführen. Der erste Befehl kopiert eine Manpage in das Verzeichnis man1:

 sudo cp doc/boxes.1 /usr/share/man/man1 

Als nächstes kopieren Sie die globale Konfigurationsdatei in ein Verzeichnis in /usr/share/:

 sudo cp boxes-config /usr/share/boxes 

Kopieren Sie abschließend die Binärdatei nach /usr/bin:

 sudo cp src/boxes /usr/bin 

Testen der Boxen Anwendung

Mal sehen, ob das alles funktioniert! Versuchen Sie, die Manpage für den boxes -Befehl zu öffnen.

 Mann Boxen 

Das ist ermutigend! Sie sehen eine Manpage, die Ihnen erklärt, wie Sie den Befehl boxes verwenden.

Drücken Sie „Q“, um das Mann-System zu verlassen und versuchen Sie, den boxes -Befehl zu verwenden.

 echo Anleitung Geek | Boxen 

Und wir bekommen die Antwort:

Angesichts all der Anstrengungen, die Sie unternommen haben, mag dies etwas überwältigend erscheinen, aber der Sinn dieser Übung bestand darin, Sie durch das Zurückziehen eines Repositorys von GitHub und das Erstellen der Anwendung zu führen.

Mit dem Befehl „ boxes “ können Sie Text, der an ihn geleitet wird, in eine Vielzahl von Rahmen einschließen. Einige von ihnen könnten als Kommentare in Quellcodedateien verwendet werden. Das obige Format würde beispielsweise als Kommentar in einer C-Quellcodedatei funktionieren. Andere sind rein dekorativ. Mit der Option -d (Design) können Sie den Stil des Rahmens auswählen.

 echo Anleitung Geek | Boxen -d wirbelnd

 echo Anleitung Geek | Boxen -d c-cmt2 

Es gibt eine lange Liste von Designs, aus denen Sie wählen können. Verwenden Sie diesen Befehl, um sie alle anzuzeigen:

 Kästen -l | weniger

Fertig bauen

Die Schritte zum Erstellen aus der Quelle sind normalerweise einfach:

• Überprüfen Sie die Build-Anweisungen im Repository.
• Überprüfen Sie, ob die erforderlichen Tools installiert sind, und installieren Sie alle fehlenden.
• Klonen Sie das Repository auf Ihren Computer.
• Befolgen Sie die Build-Anweisungen, die oft so einfach sind wie das Eingeben von make .
• Kopieren Sie die Datei(en) an die erforderlichen Speicherorte.

Wenn Schritte in der Bauanleitung unklar sind, sehen Sie nach, ob das Projekt ein Forum oder eine Community hat, an die Sie eine Frage senden können. Wenn die Anwendung eine Website hat, könnte sie eine „Kontakt“-Seite haben. Der Entwickler, der das Boxen-Projekt verwaltet, hat seine E-Mail-Adresse auf der „Über“-Seite der Boxen-Website. Das ist eine großzügige Geste von ihm und typisch für die breitere Open-Source-Community.