Sideloaded-Entwicklung auf Android TV: Systempartition einrichten

Aktualisiert 2026-10-31

Warum Sideloads auf Android TV eine eigene Systempartition benötigen

Wenn du eine Android TV-Firmware mit manuellen Werkzeugen auf einem Gerät wie dem NVIDIA Shield TV oder einem Xiaomi Mi Mirror umwandelst, reicht der übliche Weg über Apps nicht mehr aus. Die Entwicklersuite von Google verlangt eine korrekt geformte, lesbare Partition mit dem Label „System“ und den passenden Berechtigungen, damit der Bootloader die Datei akzeptiert. Ohne die richtige Partition wird das Image beim nächsten Neustart abgelehnt – die Entwicklungsumgebung bleibt unbrauchbar. Viele Nutzer merken schnell, dass die Standard-OEM-Methode nur für fertige Builds funktioniert und nicht für selbst gebautes Toolchain-Material. Dieser Artikel erklärt Schritt für Schritt, wie du die Zielpartition anlegst, werstellt und sicher in dein Gerät schiebst.

Die Zieleinheit der Systempartition: Aufbau und Label

Die Systempartition auf Android TV ist keine gewöhnliche ISO-Datei im Speicher, sondern eine strukturierte Datenstruktur, die vom Bootloader gemessen wird. Für Sideloaded-Entwickler gilt ein dreistufiges Verfahren: Erst legst du über fastboot das Target-System an, zweitens erzeugst du eine neue Partition mit dem korrekten Label „system“, und drittens schreibst du das kompilierte Image hinein. Das Label ist entscheidend – der Bootloader prüft, ob die Partition als System markiert ist, bevor er sie mountet. Fehlt das Label oder ist es falsch geschrieben, bricht das Update ab, und du erhältst den Fehler „Partition system is not mounted or invalid partition label“. Die gängigen Begriffe lauten „system“ oder „system_boot“, je nach Firmware-Revision. Das Label darf nicht mit englischen Schreibfehlern auftreten; es muss exakt mit small caps bleiben.

Schritt-für-Schritt-Anleitung zum Erstellen der Systempartition

Du brauchst ein Programmiergerät mit USB-Over-The-Top-Fastboot-Unterstützung und eine aktuelle ADB/Fastboot-Version von Android. Starte das Gerät im Fastboot-Modus, indem du adb reboot-bootloader startest, und prüfe mit fastboot devices, ob NVIDIA Shield, Google Chromecast‑Satelliten oder ein ähnliches Android TV-Gerät erkannt wird.

Erstelle zunächst das Target-System-Element:

fastboot -w target-system=system target-system-name="system" status=1

Dies legt die Verzeichnisstruktur für die neue Systempartition an. Danach wird die Patches-Berechtigung gesetzt:

fastboot -p 0 remount-partition boot
chmod 755 /dev/system

Wichtig ist nun die Erstellung eines Image-Standards. Baue deinen Entwicklungskernel und Recovery-Image mit dem Befehl build/fix_image und stelle sicher, dass die Partitionen im Format system vorliegen. Danach schreibst du das Image in die Zielpartition:

fastboot -p 0 put kernel.img /dev/system/vendor/system/images/boot.img
fastboot -p 0 put recovery.img /dev/system/vendor/firmware/build.img

Nach dem Neustart prüfst du mit fastboot getvar -s die Größe der Systempartition. Eine korrekte Partition liegt typischerweise zwischen 256 MB und 1 GB, je nach Gerät. Wenn die Partition zu klein ist, stürzt das System nach dem Flash-Vorgang ab. Eine typische Größe für den NVIDIA Shield TV ist 512 MB.

Feintuning und typische Fehlerquellen

Der häufigste Fehler ist eine falsche Berechtigung – das Label „system“ muss Lesezugriff haben, und die Partition darf nicht beschreibbar sein. Ein weiterer Stolperer: das Image muss die richtige Architektur (arm64, x86) und die korrekte prod/release-Codename-Zuordnung enthalten. Bei Xiaomi Mi Mirrors läuft das über die Xiaomi Developer Platform, die über FTP auf das Gerät hochgeladen werden kann. Der Dateiname muss exakt der Build-Nummer entsprechen, sonst verweigert der Bootloader die Integration. Auch die Dateigröße spielt eine Rolle: ein Image, das mehr als 600 MB an Systemdateien enthält, führt zu einem Abbruch beim Mounten. Halte deine Build-Dateien sauber und komprimiere keine .zip-Archive, da das Format für die Programmierung nicht unterstützt wird.

Wie du die Partition jetzt korrekt neu formulierst

Sobald du die Zielpartition mit dem Label „system“ angelegt hast, kannst du deine eigene Entwicklungsumgebung installieren, ohne dass sich das Gerät weigert, das Image zu akzeptieren. Nutze die Partition, um wiederkehrende Builds zu lagern, und setze sie mittels der Fastboot-Befehle zurück. So behältst du volle Kontrolle über die Firmware, ohne auf den Hersteller-Tooling angewiesen zu sein. Mit dieser Anleitung kannst du die Systempartition jetzt selbst bei Bedarf erstellen, reparieren oder neu strukturieren – ein wichtiger Schritt für jedes ernsthafte Sideloaded-Projekt auf Android TV.

Weiterlesen: mehr zu Android TV