Ein Apple-TV-Target, und es zeigt schon etwas

Das leere Gerüst: eigene Wurzel FlixyTVApp, eigenes Target FlixyTV in project.yml, eigener Asset-Katalog. Es beweist Target, Icon, Signierung und Paketauflösung auf einen Schlag — bevor eine Zeile Logik daran hängt. **Das Icon von Hand gebaut.** Icon Composer deckt iOS, macOS und watchOS ab, tvOS nicht: der Fernseher verlangt gestapelte Bilder, damit die Parallaxe beim Wischen etwas zu bewegen hat. Zwei Ebenen aus derselben Marke — Verlauf hinten, Dreieck vorn —, dazu App-Store-Icon und beide Top-Shelf-Bilder. Ohne das breite lehnt App Store Connect den Upload mit 90513 ab. **Zwei Annahmen aus dem Plan haben sich beim Bauen erledigt.** PlexWebAuthenticator übersetzt nicht: ASWebAuthenticationSession steht zwar im tvOS-SDK, aber presentationContextProvider, cancel() und der Rest sind dort nicht verfügbar. Der Typ bleibt trotzdem stehen — als Attrappe, die sofort „ging nicht" meldet. Ihn herauszuschneiden hiesse, die Zustandsmaschine der Anmeldung für eine Plattform zu spalten, die diesen Zweig nie betritt. Dieselbe Bauform wie bei OrientationLock. NowPlaying wartet auf den Player in Schritt sieben. **Und eine Messung statt einer Vermutung.** Der Plan führte zwei offene Annahmen über den Sicherheitsrand. Der Simulator beantwortet beide: SwiftUI legt ihn von selbst an, und er misst sechzig oben und unten, achtzig seitlich — nicht neunzig. Nutzfläche 1760×960. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-29 17:18:03 +02:00
parent 6010229b80
commit 6326c8c24c
30 changed files with 399 additions and 7 deletions
@@ -1,3 +1,38 @@
+#if os(tvOS)
+import Foundation
+
+/// **Auf dem Fernseher gibt es kein Anmeldefenster.**
+///
+/// `ASWebAuthenticationSession` steht im tvOS-SDK, aber fast alles daran ist
+/// als nicht verfügbar markiert: kein `presentationContextProvider`, kein
+/// `prefersEphemeralWebBrowserSession`, nicht einmal `cancel()`. Ein
+/// Fernseher hat auch keinen Browser, in dem sich jemand bei Plex anmelden
+/// würde — und Plex ist in der ersten Fassung ohnehin nicht dabei.
+///
+/// **Der Typ bleibt trotzdem stehen.** `FlixySession` hält ihn als Feld und
+/// ruft ihn an sechs Stellen; ihn herauszuschneiden hiesse, die
+/// Zustandsmaschine der Anmeldung für eine Plattform zu spalten, die diesen
+/// Zweig nie betritt. Dieselbe Bauform wie bei `OrientationLock`: derselbe
+/// Name, dieselben Aufrufe, und nichts passiert.
+@MainActor
+final class PlexWebAuthenticator {
+    enum Failure: Error, Equatable {
+        case cancelled
+        case presentationFailed(String)
+    }
+
+    /// Immer „ging nicht": wer hier landet, soll nicht warten.
+    private(set) var outcome: Failure?
+    private(set) var didReturn = false
+
+    func present(url: URL, callbackScheme: String) {
+        outcome = .presentationFailed(String(localized: "signIn.windowFailed"))
+        didReturn = true
+    }
+
+    func dismiss() {}
+}
+#else
 import AuthenticationServices
 import Foundation
 #if canImport(UIKit)
@@ -114,3 +149,4 @@ extension PlexWebAuthenticator: ASWebAuthenticationPresentationContextProviding
        #endif
    }
 }
+#endif
@@ -0,0 +1,27 @@
+import SwiftUI
+import FlixyDesign
+
+/// Die App auf dem Fernseher.
+///
+/// **Eine eigene Wurzel statt eines Zweigs in `FlixyApp`.** Der Unterschied
+/// zwischen Telefon und Fernseher ist keine Feinheit der Darstellung, sondern
+/// die Bedienart: kein Finger, keine Grössenklasse, keine Werkzeugleiste, kein
+/// Ziehen zum Aktualisieren, keine halbhohen Sheets — und dafür ein Fokus, den
+/// es auf iOS gar nicht gibt. Ein `#if os(tvOS)` in der bestehenden Wurzel
+/// wäre kein Zweig, sondern ein zweiter Rumpf in derselben Datei, und der
+/// nächste, der die iOS-Seite ändert, bräche die andere, ohne es zu merken.
+///
+/// **Die Modelle dagegen werden geteilt**, nicht kopiert: `Flixy/Session/`
+/// kommt über einen Pfadeintrag in `project.yml` mit. Die Naht verläuft
+/// zwischen Modell und Ansicht, nicht zwischen den Plattformen.
+///
+/// **Kein SwiftData.** Der `ModelContainer` der iOS-App trägt ausschliesslich
+/// Downloads, und die gibt es hier nicht.
+@main
+struct FlixyTVApp: App {
+    var body: some Scene {
+        WindowGroup {
+            TVRootView()
+        }
+    }
+}
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>$(DEVELOPMENT_LANGUAGE)</string>
+	<key>CFBundleDisplayName</key>
+	<string>Flixy</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>APPL</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleVersion</key>
+	<string>1</string>
+	<key>ITSAppUsesNonExemptEncryption</key>
+	<false/>
+	<key>NSAppTransportSecurity</key>
+	<dict>
+		<key>NSAllowsLocalNetworking</key>
+		<true/>
+	</dict>
+	<key>NSLocalNetworkUsageDescription</key>
+	<string>Flixy benötigt Zugriff auf das lokale Netzwerk, um deinen Jellyfin-Server zu erreichen.</string>
+	<key>UIUserInterfaceStyle</key>
+	<string>Dark</string>
+</dict>
+</plist>
@@ -0,0 +1,13 @@
+{
+  "images": [
+    {
+      "idiom": "tv",
+      "filename": "back.png",
+      "scale": "1x"
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  }
+}
@@ -0,0 +1,6 @@
+{
+  "info": {
+    "author": "xcode",
+    "version": 1
+  }
+}
@@ -0,0 +1,14 @@
+{
+  "layers": [
+    {
+      "filename": "Front.imagestacklayer"
+    },
+    {
+      "filename": "Back.imagestacklayer"
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  }
+}
@@ -0,0 +1,13 @@
+{
+  "images": [
+    {
+      "idiom": "tv",
+      "filename": "front.png",
+      "scale": "1x"
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  }
+}
@@ -0,0 +1,6 @@
+{
+  "info": {
+    "author": "xcode",
+    "version": 1
+  }
+}
@@ -0,0 +1,18 @@
+{
+  "images": [
+    {
+      "idiom": "tv",
+      "filename": "back.png",
+      "scale": "1x"
+    },
+    {
+      "idiom": "tv",
+      "filename": "back@2x.png",
+      "scale": "2x"
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  }
+}
@@ -0,0 +1,6 @@
+{
+  "info": {
+    "author": "xcode",
+    "version": 1
+  }
+}
@@ -0,0 +1,14 @@
+{
+  "layers": [
+    {
+      "filename": "Front.imagestacklayer"
+    },
+    {
+      "filename": "Back.imagestacklayer"
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  }
+}
@@ -0,0 +1,18 @@
+{
+  "images": [
+    {
+      "idiom": "tv",
+      "filename": "front.png",
+      "scale": "1x"
+    },
+    {
+      "idiom": "tv",
+      "filename": "front@2x.png",
+      "scale": "2x"
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  }
+}
@@ -0,0 +1,6 @@
+{
+  "info": {
+    "author": "xcode",
+    "version": 1
+  }
+}
@@ -0,0 +1,32 @@
+{
+  "assets": [
+    {
+      "filename": "App Icon.imagestack",
+      "idiom": "tv",
+      "role": "primary-app-icon",
+      "size": "400x240"
+    },
+    {
+      "filename": "App Icon - App Store.imagestack",
+      "idiom": "tv",
+      "role": "primary-app-icon",
+      "size": "1280x768"
+    },
+    {
+      "filename": "Top Shelf Image.imageset",
+      "idiom": "tv",
+      "role": "top-shelf-image",
+      "size": "1920x720"
+    },
+    {
+      "filename": "Top Shelf Image Wide.imageset",
+      "idiom": "tv",
+      "role": "top-shelf-image-wide",
+      "size": "2320x720"
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  }
+}
@@ -0,0 +1,18 @@
+{
+  "images": [
+    {
+      "idiom": "tv",
+      "filename": "topshelfwide.png",
+      "scale": "1x"
+    },
+    {
+      "idiom": "tv",
+      "filename": "topshelfwide@2x.png",
+      "scale": "2x"
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  }
+}
@@ -0,0 +1,18 @@
+{
+  "images": [
+    {
+      "idiom": "tv",
+      "filename": "topshelf.png",
+      "scale": "1x"
+    },
+    {
+      "idiom": "tv",
+      "filename": "topshelf@2x.png",
+      "scale": "2x"
+    }
+  ],
+  "info": {
+    "author": "xcode",
+    "version": 1
+  }
+}
@@ -0,0 +1,6 @@
+{
+  "info": {
+    "author": "xcode",
+    "version": 1
+  }
+}
@@ -0,0 +1,19 @@
+import SwiftUI
+import FlixyDesign
+
+/// Was auf dem Fernseher zu sehen ist.
+///
+/// Zunächst nur der Name: dieser Schritt beweist Target, Icon, Signierung und
+/// Paketauflösung, bevor eine Zeile Logik daran hängt. Scheitert etwas davon,
+/// scheitert es hier in fünf Minuten statt später mit sechs offenen
+/// Baustellen daneben.
+struct TVRootView: View {
+    var body: some View {
+        ZStack {
+            Color.flixyCanvas.ignoresSafeArea()
+            Text(Branding.appName)
+                .font(.flixyHero)
+                .foregroundStyle(.white)
+        }
+    }
+}
@@ -109,15 +109,20 @@ public enum FlixySpacing {
 ///
 /// **Was das ist.** Ein Fernseher zeigt nicht zwingend das ganze Bild: je nach
 /// Gerät und Einstellung schneidet er am Rand ab, und was dort steht, sieht
-/// niemand. Apple nennt für 1920×1080 einen sicheren Bereich von neunzig
-/// Punkten seitlich und sechzig oben wie unten.
+/// niemand.
 ///
-/// Ein **Bild** darf darüber hinausgehen — ein Aufmacher soll das sogar.
-/// Schrift und Knöpfe nicht. Die Zahl steht hier für die Fälle, in denen der
-/// Sicherheitsrand absichtlich übergangen wird und der Text trotzdem drinnen
-/// bleiben muss.
+/// **Nachgemessen, nicht abgeschrieben.** Im Simulator eines Apple TV 4K
+/// meldet SwiftUI bei 1920×1080 genau diese Ränder — sechzig oben und unten,
+/// **achtzig** seitlich, Nutzfläche also 1760×960. Die verbreitete Angabe
+/// „neunzig" stimmt nicht; eine zweite Quelle nannte achtzig und hatte recht.
+///
+/// **Und man bekommt sie geschenkt.** SwiftUI legt sie von selbst als
+/// Sicherheitsrand an — deshalb steht in `FlixySpacing.screenMargin` nur die
+/// Rinne innerhalb davon. Die Zahl hier ist für die Gegenrichtung: ein
+/// bildfüllender Aufmacher, der den Sicherheitsrand absichtlich übergeht und
+/// dessen Schrift trotzdem drinbleiben muss.
 public enum FlixySafeArea {
-    public static let tv = EdgeInsets(top: 60, leading: 90, bottom: 60, trailing: 90)
+    public static let tv = EdgeInsets(top: 60, leading: 80, bottom: 60, trailing: 80)
 }

 public enum FlixyRadius {
@@ -5,6 +5,7 @@ options:
  deploymentTarget:
    iOS: "26.0"
    macOS: "26.0"
+    tvOS: "26.0"
  createIntermediateGroups: true
  groupSortPosition: top
  developmentLanguage: en
@@ -155,6 +156,87 @@ targets:
          Flixy benötigt Zugriff auf das lokale Netzwerk, um deinen
          Plex-Server zu finden und Medien direkt von ihm zu laden.

+  # Die Fassung für den Fernseher.
+  #
+  # **Eigene Ansichten, geteilte Modelle.** Die Quellenpfade sind die ganze
+  # Aussage dieses Blocks: `FlixyTV/` gehört nur hierher, `Flixy/Session/`
+  # gehört beiden. Keine Datei muss dafür umziehen — XcodeGen nimmt Pfade je
+  # Ziel, und die iOS-Fassung sieht von der ganzen Sache nichts.
+  FlixyTV:
+    type: application
+    platform: tvOS
+    # Aus demselben Grund ausgeschrieben wie bei Flixy — siehe dort.
+    scheme: {}
+    sources:
+      # Die eigenen Ansichten.
+      - path: FlixyTV
+      # Die Modelle.
+      - path: Flixy/Session
+        excludes:
+          # Ein Fernseher dreht sich nicht.
+          - "OrientationLock.swift"
+          # Downloads gibt es hier nicht.
+          - "DownloadService.swift"
+          - "DownloadRefiller.swift"
+          # Kommt mit dem Player in Schritt sieben. Solange es ihn nicht gibt,
+          # hätte die Anmeldung beim System nichts anzumelden.
+          - "NowPlaying.swift"
+      # Reines Modell trotz des Ordnernamens: LoadState, ErrorText und
+      # MediaRoute liegen zusammen in einer Datei.
+      - path: Flixy/Views/LoadState.swift
+        type: file
+      - path: Flixy/Branding.swift
+        type: file
+      # Die Texte. Dieselben Schlüssel, dieselben Übersetzungen.
+      - path: Flixy/Resources/Localizable.xcstrings
+        type: file
+    dependencies:
+      - package: FlixyKit
+        product: MediaKit
+      # Mitgenommen, obwohl Plex in Fassung 1 nicht angeboten wird:
+      # FlixySession kennt PlexResource und PlexBackend in seiner
+      # Zustandsmaschine. Das Paket mitzunehmen ist billiger, als die Sitzung
+      # zu spalten — PlexClientIdentity benutzt nur UIDevice, und das gibt es
+      # auf tvOS.
+      - package: FlixyKit
+        product: PlexKit
+      - package: FlixyKit
+        product: JellyfinKit
+      - package: FlixyKit
+        product: FlixyDesign
+      - package: FlixyKit
+        product: FlixyPlayback
+    settings:
+      base:
+        PRODUCT_BUNDLE_IDENTIFIER: com.scarriffleservices.flixy.tv
+        PRODUCT_NAME: Flixy
+        # Nur Apple TV.
+        TARGETED_DEVICE_FAMILY: "3"
+        # Kein AppIcon.icon: Icon Composer deckt iOS, macOS und watchOS ab,
+        # tvOS nicht. Der Name zeigt auf die Brand-Assets-Gruppe im Katalog,
+        # und der Katalog liegt unter FlixyTV/Resources.
+        ASSETCATALOG_COMPILER_APPICON_NAME: "App Icon & Top Shelf Image"
+        CODE_SIGN_STYLE: Automatic
+    info:
+      path: FlixyTV/Info.plist
+      properties:
+        CFBundleDisplayName: Flixy
+        UIUserInterfaceStyle: Dark
+        ITSAppUsesNonExemptEncryption: false
+        # Was hier **nicht** steht, und warum:
+        #
+        # UILaunchScreen — tvOS hat kein Startbild dieser Art.
+        # UISupportedInterfaceOrientations — ein Fernseher dreht sich nicht.
+        # NSSupportsLiveActivities — ActivityKit fehlt im tvOS-SDK.
+        # CFBundleURLTypes — das Schema ist für die Plex-Rückkehr.
+        # UIBackgroundModes: audio — ein Apple TV schickt keine App in den
+        #   Hintergrund, aus dem sie weiterspielen müsste.
+        NSAppTransportSecurity:
+          NSAllowsLocalNetworking: true
+        NSLocalNetworkUsageDescription: >-
+          Flixy benötigt Zugriff auf das lokale Netzwerk, um deinen
+          Jellyfin-Server zu erreichen.
+
  # Nur zum Hinsehen: fährt die App mit der Attrappe in einen bestimmten
  # Zustand und hält sie dort an, damit von außen fotografiert werden kann.
  # Kein Teil der App, wird nie mitgeliefert.