Skip to content

Latest commit

 

History

History
52 lines (50 loc) · 3.89 KB

SUPPORT.md

File metadata and controls

52 lines (50 loc) · 3.89 KB
Raw

SUPPORT

Wie kann ich Freetz-NG unterstützen?

  • UNTESTED
    Im menuconfig und in FIRMWARES sind verschieden Geräte als UNTESTED markiert.
    Mangels Hardware konnte auf diesen nicht ausprobiert werden ob Freetz-NG funktioniert.
    Falls jemand so ein Gerät erfolgreich mit Freetz-NG betreibt, bitte Rückmeldung geben.
    Am besten gleich mit einem Screenshot von Box-Info.
  • Quellcode
    Um ein modifiziertes Image zu erstellen, ist von AVM der passende Quellcode notwendig.
    Da AVM Software nutzt die zB unter der GPL steht, muss dieser Sourcecode herausgegeben
    werden - allerdings nur auf Anfrage!
    Dazu sollte jeder für jedes seiner Geräte eine E-Mail an [email protected] schicken.
    Dies zu jeder veröffentlichten FritzOS Version, auch für die sogenannten "Labor".
    AVM veröffentlicht das Paket dann früher oder später auf osp.avm.de/.
  • Pull request
    Eigene Änderungen zu Freetz-NG "pushen":
    • Auf github.com/Freetz-NG/freetz-ng/ oben mit Fork einen Fork im eigenen Account erstellen.
    • Eigenen Fork auschecken: git clone https://github.com/BENUTZERNAME/freetz-ng.git
    • Einen Branch erstellen: git branch BRANCHNAME ; git checkout BRANCHNAME ; git push -u origin BRANCHNAME
    • Geänderte/hinzugefügte Dateien hochladen: git add . ; git commit -m "BESCHREIBUNG" ; git push
    • Auf github.com/Freetz-NG/freetz-ng/ mit New pull request die eigenen Änderungen abschicken.
  • Mailbox Format
    Falls ein pull request zu aufwändig ist kann auch ein Patch erstellt werden:
    • Auschecken: git clone https://github.com/Freetz-NG/freetz-ng.git
    • Sicherstellen dass der Name gesetzt ist: git config --global user.name "GITHUB-NAME"
    • Sicherstellen dass die eMail gesetzt ist: git config --global user.email [email protected]
    • Veränderungen vornehmen, Dateien löschen oder hinzufügen.
    • Alle Veränderungen hinzufügen: git add .
    • Einen Commit erstellen: git commit -m "BESCHREIBUNG"
    • Die Patchdatei erstellen: git format-patch origin/HEAD
    • Alle lokalen Veränderungen wieder löschen git reset --hard origin/HEAD
  • Package bump
    Minimale Schritte um die Version eines Packages zu aktualisieren:
    • Changelog lesen, es kann sich etwas geändert haben das beachtet werden muss.
    • Hinweis: Libraries befinden sich nicht in make/$PKG/ sondern: make/libs/$PKG/
    • Die Datei docs/CHANGELOG.md anpassen.
    • Die Version in make/$PKG/Config.in anpassen.
    • Das Wiki aktualisieren durch ausführen von: docs/generate.sh
    • Die Version in make/$PKG/$PKG.mk anpassen.
    • Die Prüfsumme in make/$PKG/$PKG.mk anpassen.
    • Falls der Dateiname die Version enthält, make/$PKG/external.* anpassen.
    • Vorhandene Patches in make/$PKG/patches/ aktualisieren durch
      ausführen von: make $PKG-autofix
    • Compilieren testen mit: make $PKG-precompiled FREETZ_VERBOSITY_LEVEL=2
    • Am besten noch auf eine Fritzbox flashen und testen.
  • Wiki
    Viele Teile des unter freetz-ng.github.io/ zu erreichenden Wikis sind veraltet und bedürfen einer
    Überarbeitung. Alle Datein des Wikis sind im Checkout unter docs/wiki/ zu finden.
    Wichtig: Nach Änderungen unter docs/ oder von Config.in-Dateien docs/generate.sh zum
    Aktualisieren des Indexes ausführen.