OTA-Updates für die iOS-App; HACS-Fehlannahme korrigiert

HACS kann laut eigener Dokumentation grundsätzlich nicht mit privaten
GitHub-Repositories arbeiten (hacs.xyz/docs/faq/private_repositories) - keine
Ausnahme für Tokens oder verbundene Konten. Meine frühere Annahme, HACS käme
damit zurecht, wenn es unter dem richtigen Konto angemeldet ist, war falsch.
Da das Repository aus Lizenzgründen privat bleiben muss (Audi-Hausschrift,
Typenschilder), ist install.ps1 damit nicht die Rückfallebene, sondern der
einzige Installationsweg - README, INSTALL.md, ANLEITUNG.md, install.ps1 und
VERSIONIERUNG.md korrigiert.

Oberflächen-Updates für die iOS-App laufen jetzt ohne Xcode:
@capgo/capacitor-updater eingebaut, ein Update-Abschnitt in den
Einstellungen lädt ein neues Bündel und tauscht die Oberfläche aus. Kein
Selbstlauf (autoUpdate: false) - nur auf Tastendruck, nie während der
Benutzung.

Das Bündel liegt in der Integration selbst
(custom_components/audi_dashboard/frontend/app/), nicht unter /local/: so
reist es bei jeder Installation automatisch mit, ohne zweiten
Auslieferungsweg. Gebaut von companion-app/scripts/ota-paket.ps1 (neuer
Befehl: npm run ota), gemeldet über sensor.audi_dashboard_app_version
(neues Feld daten.buendel).

Ein echter Bug beim Bauen gefunden: [IO.Compression.ZipFile]::CreateFrom-
Directory schreibt unter Windows PowerShell 5.1 Backslashes in die
Zip-Einträge - iOS hätte das Archiv falsch entpackt. Behoben, indem die
Einträge von Hand mit "/" geschrieben werden.

Rückfallebene: notifyAppReady() läuft erst, wenn React nachweislich
gerendert hat (App.tsx). Kommt diese Meldung nicht, rollt das Plugin nach
20 Sekunden von selbst auf das vorherige Bündel zurück.

Am laufenden Testcontainer verifiziert: die ausgelieferte Zip hasht exakt
auf den in bundle.json hinterlegten Wert, 13 Einträge, index.html in der
Wurzel, keine Backslashes, keine Beschädigung. tsc sauber, 117/117 Tests
(5 davon neu für buendelPasst() - dabei eine echte Lücke gefunden: die
Funktion hätte bei unbekannter eigener Version fälschlich ein Update
angeboten, jetzt genauso vorsichtig wie versionVergleichen).

Co-Authored-By: Claude Sonnet 5 <[email protected]>

companion-app/src/screens/Einstellungen.tsx

@@ -8,8 +8,10 @@ import { useRef, useState } from "react"
 
 import { ActionButton, Feld, Seg, Switch, Tile } from "@audi-dash/ui"
 
-import { DIENST_DOMAIN, zugangVerwerfen } from "../api"
+import { DIENST_DOMAIN, zugangLesen, zugangVerwerfen } from "../api"
+import { eigeneVersion } from "../daten/appVersion"
 import { useDaten } from "../daten/DatenKontext"
+import { OtaFehler, buendelAnwenden, buendelPasst, otaMoeglich } from "../daten/ota"
 import type { Einstellungen as EinstellungenWerte } from "../daten/profilAdapter"
 import { datumZeit, de, isoTag } from "../format"
 import { useTheme } from "../theme"
@@ -35,6 +37,7 @@ export function Einstellungen({
     fahrten,
     tankvorgaenge,
     rohprofil,
+    otaBuendel,
     api,
     profilSpeichern,
     jetztAktualisieren,
@@ -44,8 +47,31 @@ export function Einstellungen({
   const [laeuft, setzeLaeuft] = useState(false)
   const [gespeichert, setzeGespeichert] = useState(false)
   const [importOffen, setzeImportOffen] = useState(false)
+  const [otaLaeuft, setzeOtaLaeuft] = useState(false)
+  const [otaFehler, setzeOtaFehler] = useState<string | null>(null)
   const dateiwahl = useRef<HTMLInputElement | null>(null)
 
+  const otaUpdateVerfuegbar = otaMoeglich() && buendelPasst(otaBuendel, eigeneVersion())
+
+  const otaAusloesen = async () => {
+    if (!otaBuendel) return
+    setzeOtaLaeuft(true)
+    setzeOtaFehler(null)
+    try {
+      const zugang = await zugangLesen()
+      if (!zugang) throw new OtaFehler("Kein Zugang eingerichtet.")
+      // Kehrt im Erfolgsfall nicht zurück - set() lädt die App neu, siehe
+      // daten/ota.ts. Der catch-Block unten fängt sowohl echte Fehlschläge
+      // als auch den defensiven letzten throw in buendelAnwenden() ab.
+      await buendelAnwenden(otaBuendel, zugang.basisUrl)
+    } catch (fehler) {
+      setzeOtaFehler(
+        fehler instanceof Error ? fehler.message : "Das Update konnte nicht installiert werden.",
+      )
+      setzeOtaLaeuft(false)
+    }
+  }
+
   if (!einstellungen || !fahrzeug) return null
   const werte = entwurf ?? einstellungen
 
@@ -349,6 +375,41 @@ export function Einstellungen({
         </div>
       </Tile>
 
+      {otaMoeglich() && (
+        <Tile>
+          <span className="ads-eyebrow">App-Update</span>
+          {otaUpdateVerfuegbar && otaBuendel ? (
+            <>
+              <Werteliste
+                kinder={
+                  <Wertzeile
+                    label="Verfügbare Version"
+                    wert={otaBuendel.version}
+                    zusatz={`${Math.round(otaBuendel.bytes / 1024)} KB`}
+                  />
+                }
+              />
+              <p className="dm-fussnote">
+                Lädt die Oberfläche neu und startet die App neu. Fahrzeugprofil, Fahrten und
+                Tankvorgänge sind davon nicht betroffen — die liegen in Home Assistant.
+              </p>
+              <div className="dm-knopfreihe">
+                <ActionButton onClick={() => void otaAusloesen()} disabled={otaLaeuft}>
+                  {otaLaeuft ? "Lade Update …" : "Update installieren"}
+                </ActionButton>
+              </div>
+              {otaFehler && <p className="dm-fehler">{otaFehler}</p>}
+            </>
+          ) : (
+            <p className="dm-fussnote">
+              {otaBuendel
+                ? `Diese App ist aktuell (${eigeneVersion() ?? "unbekannte Version"}).`
+                : "Der Server hat gerade kein Update-Bündel hinterlegt."}
+            </p>
+          )}
+        </Tile>
+      )}
+
       <Tile>
         <span className="ads-eyebrow">Zugang</span>
         <Werteliste