Skip to content
⚠
Maschinelle Übersetzung

Diese Seite wurde automatisch aus dem Englischen übersetzt und kann Fehler oder technische Ungenauigkeiten enthalten. Im Zweifelsfall ziehe die englische oder russische Fassung heran. English · Русский

Fehler gefunden? Korrekturen sind willkommen.

Entwicklung ​

Dieser Abschnitt richtet sich an alle, die mehr wollen, als den Flipper nur zu benutzen: die Unleashed Firmware aus dem Quellcode bauen, eigene Apps in C oder JavaScript schreiben, sie auf echter Hardware debuggen, über die Kommandozeile mit dem Gerät sprechen oder verstehen, wie Updates und die Hardware intern funktionieren.

Unleashed

Unleashed ist ein Fork der offiziellen Firmware, der vollständig kompatibel zur offiziellen API und zu den offiziellen Apps bleibt. Nahezu alles aus der offiziellen Entwicklerdokumentation gilt unverändert. Die wichtigsten Punkte, die du dir merken solltest:

  • klone https://github.com/DarkFlippers/unleashed-firmware statt des offiziellen Repositorys;
  • wenn du Apps mit uFBT baust, richte es auf das Unleashed-SDK aus (--index-url=https://up.unleashedflip.com/directory.json), sonst wird deine App gegen das offizielle SDK gebaut und lädt möglicherweise nicht (Details);
  • die Firmware-Herkunft wird als Unleashed gemeldet, die aktuelle API-Version auf dev ist 88.27.

Die Firmware bauen ​

SeiteWas du bekommst
Die Firmware bauenUnleashed unter Linux, macOS und Windows klonen, bauen und flashen
Flipper Build Tool (fbt)Jedes fbt-Target, jede Option und jede Umgebungsvariable
Hardware-TargetsWie targets/ und target.json Hardwarevarianten beschreiben (f7, f18)
Apps unter Android bauen.fap-Apps auf dem Smartphone mit Termux + uFBT kompilieren, ohne PC

Apps schreiben ​

SeiteWas du bekommst
Deine erste App in CuFBT, App-Vorlage, "Hello world" mit einem Dialog, bauen und ausführen
App-Manifeste (.fam)Alle Felder von application.fam, Optionen für externe Apps, private Bibliotheken
Furi-APIHardware- und Softwarearchitektur, Furi-Kern, furi_assert / furi_check
GUI in AppsDialoge, ViewPort, Views & Scenes, View-Module
Apps debuggenSWD-Probes, Debugging in VS Code, Debug-Signale des Furi HAL
FuriHalBus-APIMCU-Peripherie korrekt ein- und ausschalten, DMA-Kanalbelegung
JavaScript auf dem FlipperSkripte in JavaScript statt in C schreiben (eigene Seitengruppe)
JS-Module nur in Unleashedsubghz, infrared, blebeacon, usbdisk, i2c, spi, vgm — nicht in der Stock-Firmware, nicht in der offiziellen Dokumentation

Mit dem Gerät arbeiten ​

SeiteWas du bekommst
Kommandozeile (CLI)Über USB-Serial verbinden; jeder CLI-Befehl mit seinen Argumenten
OTA-UpdatesWie der Updater arbeitet, Manifestfelder, [XX-YY]-Fehlercodes, Pakete bauen
Heatshrink-Tarball-FormatDer .tar.hs-Container für Ressourcen in Update-Paketen
HardwareTechnische Daten, Schaltpläne, 3D-Modelle, Zeichnungen von Modulen und Devboards

Testen ​

SeiteWas du bekommst
Unit-TestsDie App unit_tests auf dem Gerät bauen und ausführen, eigene Tests ergänzen
IntegrationstestsDer manuelle Testplan, der vor dem Mergen von PRs und vor Releases durchlaufen wird

Weitere nützliche Ressourcen ​

Projektstruktur des Firmware-Repositorys ​

OrdnerInhalt
applicationsAnwendungen und Dienste, die in der Firmware verwendet werden
assetsAssets, die von Anwendungen und Diensten verwendet werden
furiFuri Core: Primitive und Hilfsfunktionen auf Betriebssystemebene
debugDebug-Werkzeuge: GDB-Plugins, SVD-Datei usw.
documentationDokumentationsquellen und Generator-Konfigurationen
firmwareQuellcode der Firmware
libEigene und Drittanbieter-Bibliotheken, Treiber
site_sconsBuild-Hilfsfunktionen
scriptsErgänzende Skripte und Python-Bibliotheken
targetsDefinitionen der Hardware-Targets (f7, f18)

Viele dieser Ordner haben ihre eigene ReadMe.md — die Lektüre lohnt sich.

Nicht mit Flipper Devices verbunden. Nur für Bildungszwecke und rechtmäßige Nutzung.