Halo heisst ab hier Flaro — die Marke stand im Weg

Der Upload zu App Store Connect scheiterte am Namen. „Halo" ist eine
eingetragene Marke von Microsoft; im App Store heisst zwar keine App exakt
so, aber reservierte und markenrechtlich belegte Namen tauchen in keiner
Suche auf. Der einzige verlässliche Test war die Eingabe dort, und die ging
daneben.

**Der Name wurde diesmal vorher geprüft.** Zwanzig Kandidaten gegen den
deutschen und amerikanischen App Store, auf exakte Treffer und auf ähnliche
Namen. „Kavo" wäre dieselbe Wand gewesen — exakt belegt in beiden Stores, in
Deutschland von KaVo Dental GmbH. „Flare" ist mit 42 ähnlichen Apps je Store
der am dichtesten besetzte Name der ganzen Runde. **Flaro** ist in beiden
frei und liest sich als eigenes Wort, nicht als Flare mit Tippfehler.

Das bleibt eine Store-Suche und keine Markenrecherche — reservierte Namen
ohne veröffentlichte App sieht sie nicht. Aber es ist mehr Prüfung, als beim
letzten Mal stattfand.

---

2160 Textvorkommen in 273 Dateien, 49 Pfade. Betroffen ist diesmal auch der
Server: `Flaro.Api`, `Flaro.Core`, `Flaro.Data`, `Flaro.Media`,
`Flaro.Metadata`, `FlaroContext`, `FlaroPaths`, `flaro.db`, die Variablen
`FLARO_DATA`, `FLARO_CACHE`, `FLARO_TRANSCODE`, `FLARO_WRITE_SIDECARS`, und
das Image.

**Vor dem Ersetzen geprüft**, ob „halo" irgendwo als Teil eines anderen
Wortes steckt — und ob es im TMDB-Token vorkommt. Tat es nicht; ein blindes
Ersetzen hätte den sonst zerlegt.

`docs/superpowers/specs/` bleibt wie beim letzten Mal unangetastet: datierte
Entwurfsdokumente sind ein Protokoll getroffener Entscheidungen. Das
Server-Dokument hat stattdessen einen Nachtrag bekommen, damit es niemanden
in die Irre führt.

**Die Bundle-ID wandert mit**, zum zweiten Mal an einem Tag:
`com.scarriffleservices.flaro`. Wer die vorige Fassung installiert hat, hat
jetzt zwei Karteileichen auf dem Gerät — beide löschen, dann ist Ruhe.

308 Server-Tests grün, 368 im Swift-Paket, null Warnungen. iOS und tvOS
bauen, das Image baut, und ein frischer Container läuft durch Einrichtung
und Anmeldung.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Scarriffle
2026-10-03 19:38:27 +02:00
co-authored by Claude Opus 5
parent f98b995050
commit a7cf6c5def
390 changed files with 2078 additions and 2069 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.flaro</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>Flaro</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.flaro"
/// Muss mit `CFBundleURLSchemes` in der Info.plist des Fernseh-Ziels
/// übereinstimmen.
static let scheme = "flaro"
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
}
}