Helge Jung b08c0d8d87 add draft version of 'check-public.sh' | 9 vuotta sitten | |
---|---|---|
docker | 9 vuotta sitten | |
versions | 9 vuotta sitten | |
.gitignore | 9 vuotta sitten | |
ReadMe.md | 9 vuotta sitten | |
build-version.sh | 9 vuotta sitten | |
build.sh | 9 vuotta sitten | |
check-public.sh | 9 vuotta sitten | |
check.sh | 9 vuotta sitten | |
docker-build.sh | 9 vuotta sitten | |
functions.sh | 9 vuotta sitten |
Es gibt zwei Möglichkeiten, die Firmware zu bauen. Entweder in einem Docker-Container oder "nativ" auf einem Debian/Ubuntu-System. Der Weg über Docker ist der empfohlene Weg für alle, die die Firmware nur nachbauen wollen - der Docker-Weg ermöglicht vergleichbare Builds.
Man benötigt Docker, gawk und git:
sudo apt-get install gawk git
sudo apt-get install docker.io || wget -qO- https://get.docker.com/ | sh
docker pull ffpb/build
Das Docker-Repository ffpb/build
kann auch selbst erstellt werden: docker build -t ffpb/build docker
(wenn das Git-Repository, in dem diese ReadMe liegt, ausgecheckt wurde)
Als Requirements sind die allgemeinen Build-Tools sowie libfaketime nötig. Zum Bauen des gcc in der Toolchain sind noch drei weitere Bibliotheken notwendig:
sudo apt-get install build-essential git gawk python subversion unzip p7zip-full \
faketime lib{gmp,mpfr,mpc}-dev zlib1g-dev ncurses-dev
Klone das Repository in dem diese ReadMe liegt, falls noch nicht geschehen und wechsle in das Verzeichnis:
git clone https://git.c3pb.de/freifunk-pb/firmware.git
cd firmware
Rufe build.sh
bzw. docker-build.sh
auf und übergebe folgende Umgebungsvariablen:
# Baut eine testing-Firmware auf Basis von Gluon 2014.4
BASE=v2014.4 BRANCH=testing VERSION=0.6~rc1 ./build.sh
# Baut eine experimental-Firmware auf Basis des aktuellen Gluon-Master (nur für Experten)
BASE=master BRANCH=experimental ./build.sh
Nach erfolgreichem Build-Vorgang liegt die Firmware fertig paketiert im output/
Verzeichnis und in versions/
wurde (außer bei BRANCH=experimental) eine Versions-Informationsdatei abgelegt. Mit dieser (nur der Name) kann build-version.sh
die gegebene Version erneut bauen.
Klone das Repository in dem diese ReadMe liegt, falls noch nicht geschehen und wechsle in das Verzeichnis:
git clone https://git.c3pb.de/freifunk-pb/firmware.git
cd firmware
Im Verzeichnis versions
liegen alle bekannten Firmware-Versionen. Durch Aufruf von build-version.sh
und Übergabe des Dateinamens (ohne Pfad) wird diese Version erneut gebaut. Es werden zwei Umgebungsvariablen unterstützt:
build.sh
statt docker-build.sh
zum BauDie Nutzung von Docker zur Überprüfung von Builds wird dringend empfohlen, da Docker Unterschiede zwischen den Build-Rechnern ausgleicht und die Binaries so einfacher überprüfbar werden.
./build_version.sh 0.6.1_stable # baut Version '0.6.1_stable' erneut
NO_DOCKER=1 ./build_version.sh 0.6.1_stable # ohne Docker-Umgebung erneut bauen