Flixy heißt ab hier Halo

Reine Umbenennung, kein Verhalten geändert — bewusst als eigener Commit,
damit „umbenannt" und „umgebaut" im Nachhinein auseinanderzuhalten sind.

712 mal `Flixy`, 778 mal `flixy`, 7 mal `FLIXY` in 169 Dateien, dazu 25
Pfade. Ziele: `Halo`, `HaloTV`, `HaloTopShelf`, `HaloUITests`, `HaloKit` mit
`HaloDesign`, `HaloDownloads`, `HaloPlayback` und `HaloProbe`. `MediaKit`,
`JellyfinKit` und `DownloadWidget` tragen den Namen nicht und bleiben.

`docs/superpowers/specs/` ist ausgenommen. Datierte Entwurfsdokumente sind
ein Protokoll getroffener Entscheidungen; sie nachträglich umzuschreiben
hiesse, die Vergangenheit zu glätten.

**Die Bundle-ID wandert mit** — ausdrücklich so gewollt, mit bekanntem Preis:
`com.scarriffleservices.halo` ist für iOS eine *andere* App. Die installierte
Fassung bleibt daneben stehen, mit Downloads und Anmeldung in ihrem Container;
Halo startet leer. Einmal neu anmelden, heruntergeladene Folgen einmal neu
laden. Dasselbe gilt für die App-Gruppe, die sich TV-App und Top Shelf teilen.

**Eine Folge davon, die beim Entscheiden noch nicht auf dem Tisch lag:** der
Aufräumschritt aus dem vorigen Commit kommt an die alten Plex-Token nicht mehr
heran. Der Schlüsselbund grenzt nach Team und Bundle-Kennung ab — was unter
`…flixy` liegt, ist für `…halo` unerreichbar. Erledigt wird es trotzdem, nur
anders: **die alte App löschen.** iOS räumt deren Schlüsselbund-Einträge beim
Deinstallieren mit ab. Der Code bleibt stehen, weil er für jeden Stand vor
dieser Umbenennung richtig ist und im Jahr einen Startvergleich kostet.

Die Projektdatei ist aus `project.yml` neu erzeugt, der alte Ordner gelöscht
statt umbenannt — sie steht ohnehin nicht im Repo.

Das Verzeichnis des Repos selbst heißt weiter `Flixy`; das umzubenennen ist
ein Handgriff ausserhalb des Projekts.

368 Tests grün. iOS und tvOS bauen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Scarriffle
2026-10-03 11:12:32 +02:00
co-authored by Claude Opus 5
parent 2fcf6821c8
commit 4b9a1e7b67
280 changed files with 1456 additions and 1456 deletions
+10
View File
@@ -0,0 +1,10 @@
<?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>com.apple.security.application-groups</key>
<array>
<string>group.com.scarriffleservices.halo</string>
</array>
</dict>
</plist>
+34
View File
@@ -0,0 +1,34 @@
<?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>Halo</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>CFBundleShortVersionString</key>
<string>1.0</string>
<key>CFBundleVersion</key>
<string>1</string>
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsLocalNetworking</key>
<true/>
</dict>
<key>NSExtension</key>
<dict>
<key>NSExtensionPointIdentifier</key>
<string>com.apple.tv-top-shelf</string>
<key>NSExtensionPrincipalClass</key>
<string>$(PRODUCT_MODULE_NAME).TopShelfProvider</string>
</dict>
</dict>
</plist>
+24
View File
@@ -0,0 +1,24 @@
import Foundation
/// Die beiden Zeichenketten, auf die sich App und Regal einigen müssen.
///
/// An **einer** Stelle, weil ein Tippfehler hier nichts abstürzen lässt: das
/// Regal bliebe einfach leer, oder ein Druck täte nichts, und beides sieht
/// aus wie „geht halt nicht" statt wie ein Fehler.
enum TopShelfIdentity {
/// Muss mit `TopShelfWriter.group` und beiden Entitlement-Dateien
/// übereinstimmen.
static let group = "group.com.scarriffleservices.halo"
/// Muss mit `CFBundleURLSchemes` in der Info.plist des Fernseh-Ziels
/// übereinstimmen.
static let scheme = "halo"
static func playURL(for id: String) -> URL {
URL(string: "\(scheme)://play/\(id)") ?? URL(string: "\(scheme)://")!
}
static func detailURL(for id: String) -> URL {
URL(string: "\(scheme)://item/\(id)") ?? URL(string: "\(scheme)://")!
}
}
+70
View File
@@ -0,0 +1,70 @@
import Foundation
import MediaKit
import TVServices
/// Das Regal über der App im tvOS-Menü.
///
/// **Was hier nicht passiert.** Kein Netzabruf, keine Anmeldung, kein
/// Blättern. tvOS ruft diese Erweiterung auf, während jemand im Menü über der
/// App steht, und bricht sie ab, wenn sie zu lange braucht. Alles, was sie
/// zeigt, hat die App beim letzten Öffnen abgelegt — eine Datei, ein
/// `JSONDecoder`, fertig.
///
/// **Und was sie nicht weiss.** Sie kennt weder Server noch Token. Die
/// Bildadressen im Abzug tragen den Zugangsschlüssel bereits, weil Jellyfin
/// ihn für Bilder verlangt; damit muss diese Erweiterung nie etwas erfragen.
final class TopShelfProvider: TVTopShelfContentProvider {
/// **Mit Rückruf statt `async`.** Die asynchrone Fassung verlangt einen
/// `Sendable`-Rückgabewert, und `TVTopShelfContent` ist keiner — die
/// Objekte gehören UIKit. Der Rückruf hat diese Anforderung nicht, und
/// hier gibt es ohnehin nichts zu warten: eine Datei lesen und
/// entschlüsseln.
override func loadTopShelfContent(
completionHandler: @escaping ((any TVTopShelfContent)?) -> Void
) {
completionHandler(inhalt())
}
private func inhalt() -> (any TVTopShelfContent)? {
guard let abzug = TopShelfStore.read(group: TopShelfIdentity.group),
!abzug.sections.isEmpty
else {
// Nichts abgelegt — die App war noch nie offen oder der Server
// hat nie geantwortet. Dann bleibt es beim Icon; das ist
// ehrlicher als eine leere Reihe mit Überschrift.
return nil
}
let abschnitte = abzug.sections.map { abschnitt in
let inhalte = abschnitt.entries.map(item(from:))
let reihe = TVTopShelfItemCollection(items: inhalte)
reihe.title = abschnitt.title
return reihe
}
return TVTopShelfSectionedContent(sections: abschnitte)
}
private func item(from eintrag: TopShelfSnapshot.Entry) -> TVTopShelfSectionedItem {
let element = TVTopShelfSectionedItem(identifier: eintrag.id)
element.title = eintrag.title
// **Hochkant.** Dieselbe Form wie die Plakate in der App; ein
// 16:9-Bild in einem Hochkantrahmen zeigt einen zufälligen
// Ausschnitt und ist zum Wiedererkennen wertlos.
element.imageShape = .poster
if let adresse = eintrag.imageURL {
element.setImageURL(adresse, for: .screenScale1x)
element.setImageURL(adresse, for: .screenScale2x)
}
if let fortschritt = eintrag.progress {
element.playbackProgress = fortschritt
}
// **Abspielen, nicht nur öffnen.** Wer im Menü über einem angefangenen
// Film steht und drückt, will weiterschauen — nicht erst eine
// Detailseite sehen. Die App entscheidet dann, was „abspielen" hier
// heisst: bei einer Serie die nächste ungesehene Folge.
element.playAction = TVTopShelfAction(url: TopShelfIdentity.playURL(for: eintrag.id))
element.displayAction = TVTopShelfAction(url: TopShelfIdentity.detailURL(for: eintrag.id))
return element
}
}