Phase 0: Projektgerüst, Design-Tokens und Navigation
Legt das Fundament für den Plex-Client an: - XcodeGen-Projekt nach dem Muster von Onyx (com.scarriffleservices, strict concurrency, Projektdatei nicht eingecheckt) - FlixyKit mit vier Modulen: PlexKit, FlixyDesign, FlixyPlayback, FlixyDownloads. macOS steht als Plattform mit drin, damit die Logik-Tests ohne Simulator laufen. - FlixyDesign: dunkle Farb-Tokens, Schriftskala, Poster- und Querformat-Kacheln, Aufmacher-Bild. Die Akzentfarbe fließt über die Umgebung und wird per WCAG-Rechnung lesbar gehalten. - PlexKit: Kopfzeilen-Identität, Transport-Protokoll, Fehlerarten und die Medienmodelle samt nachsichtigem Decoder. - FlixyPlayback: VideoPlayerEngine-Protokoll und PlaybackDecider — die eine Funktion, an der Phase 2 das Transcoding andockt. - Ausfahrbare Seitenleiste auf dem iPhone, Split-View auf dem iPad. - 45 Tests, alle grün. VLCKit 4.0.0-a24 ist vorab geprüft: baut über SPM unter Swift 6 mit strict concurrency. Die iOS-Slice ist mit 239 MB allerdings gewichtig, deshalb bekommt sie in Phase 1 ein eigenes Target. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Guido
Claude Opus 5
@@ -0,0 +1,100 @@
|
||||
import Foundation
|
||||
#if canImport(UIKit)
|
||||
import UIKit
|
||||
#endif
|
||||
|
||||
/// Wer wir gegenüber Plex sind.
|
||||
///
|
||||
/// Plex verlangt bei jeder Anfrage eine Handvoll `X-Plex-*`-Kopfzeilen. Die
|
||||
/// wichtigste ist `X-Plex-Client-Identifier`: darüber erkennt der Server das
|
||||
/// Gerät wieder. Ändert sie sich, gilt die App als neues Gerät — die
|
||||
/// Anmeldung ist futsch und in der Geräteliste des Kontos sammelt sich Müll
|
||||
/// an. Deshalb wird sie einmal erzeugt und dann festgehalten.
|
||||
public struct PlexClientIdentity: Sendable, Equatable {
|
||||
public let product: String
|
||||
public let version: String
|
||||
public let clientIdentifier: String
|
||||
public let platform: String
|
||||
public let platformVersion: String
|
||||
public let device: String
|
||||
public let deviceName: String
|
||||
|
||||
public init(
|
||||
product: String,
|
||||
version: String,
|
||||
clientIdentifier: String,
|
||||
platform: String,
|
||||
platformVersion: String,
|
||||
device: String,
|
||||
deviceName: String
|
||||
) {
|
||||
self.product = product
|
||||
self.version = version
|
||||
self.clientIdentifier = clientIdentifier
|
||||
self.platform = platform
|
||||
self.platformVersion = platformVersion
|
||||
self.device = device
|
||||
self.deviceName = deviceName
|
||||
}
|
||||
|
||||
/// Die Kopfzeilen für eine Anfrage — ohne Token, das kommt je nach Ziel
|
||||
/// (plex.tv oder Server) aus einer anderen Quelle.
|
||||
public var headers: [String: String] {
|
||||
[
|
||||
"X-Plex-Product": product,
|
||||
"X-Plex-Version": version,
|
||||
"X-Plex-Client-Identifier": clientIdentifier,
|
||||
"X-Plex-Platform": platform,
|
||||
"X-Plex-Platform-Version": platformVersion,
|
||||
"X-Plex-Device": device,
|
||||
"X-Plex-Device-Name": deviceName,
|
||||
// Ohne diese Zeile antwortet Plex in XML. Die Modelle hier sind auf
|
||||
// JSON ausgelegt, also fragen wir es ausdrücklich an.
|
||||
"Accept": "application/json",
|
||||
]
|
||||
}
|
||||
}
|
||||
|
||||
extension PlexClientIdentity {
|
||||
private static let storageKey = "flixy.plex.clientIdentifier"
|
||||
|
||||
/// Baut die Kennung für das laufende Gerät und merkt sich die Client-ID.
|
||||
///
|
||||
/// `@MainActor`, weil `UIDevice.current` dort beheimatet ist. Das mit
|
||||
/// `assumeIsolated` zu umgehen wäre ein Absturz mit Anlauf — die Kennung
|
||||
/// wird ohnehin einmal beim Start gebaut.
|
||||
@MainActor
|
||||
public static func current(
|
||||
product: String,
|
||||
version: String,
|
||||
defaults: UserDefaults = .standard
|
||||
) -> PlexClientIdentity {
|
||||
let identifier: String
|
||||
if let stored = defaults.string(forKey: storageKey) {
|
||||
identifier = stored
|
||||
} else {
|
||||
identifier = UUID().uuidString
|
||||
defaults.set(identifier, forKey: storageKey)
|
||||
}
|
||||
|
||||
#if canImport(UIKit)
|
||||
let systemVersion = UIDevice.current.systemVersion
|
||||
let model = UIDevice.current.model
|
||||
let name = UIDevice.current.name
|
||||
#else
|
||||
let systemVersion = ProcessInfo.processInfo.operatingSystemVersionString
|
||||
let model = "Unknown"
|
||||
let name = ProcessInfo.processInfo.hostName
|
||||
#endif
|
||||
|
||||
return PlexClientIdentity(
|
||||
product: product,
|
||||
version: version,
|
||||
clientIdentifier: identifier,
|
||||
platform: "iOS",
|
||||
platformVersion: systemVersion,
|
||||
device: model,
|
||||
deviceName: name
|
||||
)
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,39 @@
|
||||
import Foundation
|
||||
|
||||
/// Was beim Sprechen mit Plex schiefgehen kann.
|
||||
///
|
||||
/// Bewusst grob geschnitten: die Oberfläche muss unterscheiden können, ob sie
|
||||
/// zur Anmeldung zurückschicken (`unauthorized`), einen Wiederholen-Knopf
|
||||
/// zeigen (`transport`) oder einen Fehler melden soll. Feinere Abstufungen
|
||||
/// hätten kein anderes Verhalten zur Folge.
|
||||
public enum PlexError: Error, Sendable, Equatable {
|
||||
/// Token fehlt oder wurde am Server zurückgezogen.
|
||||
case unauthorized
|
||||
/// Angefragte Ressource gibt es nicht — etwa ein gelöschter Titel.
|
||||
case notFound
|
||||
/// Der Server hat geantwortet, aber mit einem Fehlerstatus.
|
||||
case server(status: Int)
|
||||
/// Verbindung kam nicht zustande. Der Grund steht als Text drin, damit die
|
||||
/// Fehlermeldung konkret werden kann statt „Etwas ist schiefgelaufen".
|
||||
case transport(description: String)
|
||||
/// Antwort kam an, ließ sich aber nicht lesen. Fast immer ein Zeichen
|
||||
/// dafür, dass ein Feld in einer neueren Plex-Version anders heißt.
|
||||
case decoding(description: String)
|
||||
/// Es war kein Weg zum Server erreichbar — weder lokal noch über plex.tv.
|
||||
case noReachableConnection
|
||||
|
||||
/// Ob ein erneuter Versuch überhaupt Aussicht auf Erfolg hat. Steuert, ob
|
||||
/// die Oberfläche einen Wiederholen-Knopf anbietet.
|
||||
public var isRetryable: Bool {
|
||||
switch self {
|
||||
case .transport, .noReachableConnection:
|
||||
true
|
||||
case .server(let status):
|
||||
// 5xx ist ein Serverproblem und kann vorübergehen; 4xx liegt an
|
||||
// der Anfrage und wird beim zweiten Mal genauso scheitern.
|
||||
status >= 500
|
||||
case .unauthorized, .notFound, .decoding:
|
||||
false
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,38 @@
|
||||
import Foundation
|
||||
|
||||
/// Übersetzt eine HTTP-Antwort in entweder Nutzdaten oder einen `PlexError`.
|
||||
public enum PlexResponse {
|
||||
public static func validate(
|
||||
data: Data,
|
||||
response: URLResponse
|
||||
) throws(PlexError) -> Data {
|
||||
guard let http = response as? HTTPURLResponse else {
|
||||
throw .transport(description: "Antwort war keine HTTP-Antwort")
|
||||
}
|
||||
|
||||
switch http.statusCode {
|
||||
case 200..<300:
|
||||
return data
|
||||
case 401, 403:
|
||||
throw .unauthorized
|
||||
case 404:
|
||||
throw .notFound
|
||||
default:
|
||||
throw .server(status: http.statusCode)
|
||||
}
|
||||
}
|
||||
|
||||
public static func decode<T: Decodable>(
|
||||
_ type: T.Type,
|
||||
from data: Data
|
||||
) throws(PlexError) -> T {
|
||||
do {
|
||||
return try JSONDecoder().decode(type, from: data)
|
||||
} catch {
|
||||
// Der Fehlertext von `DecodingError` nennt den Schlüsselpfad. Das
|
||||
// ist beim Nachziehen einer geänderten Plex-Version Gold wert,
|
||||
// deshalb wird er mitgeschleppt statt verschluckt.
|
||||
throw .decoding(description: String(describing: error))
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,71 @@
|
||||
import Foundation
|
||||
|
||||
/// Der schmale Spalt, durch den PlexKit ans Netz kommt.
|
||||
///
|
||||
/// Alles darüber kennt nur dieses Protokoll. Dadurch laufen die Tests gegen
|
||||
/// aufgezeichnete Antworten statt gegen einen echten Server — und zwar ohne
|
||||
/// `URLProtocol`-Verrenkungen, die bei paralleler Testausführung erfahrungs-
|
||||
/// gemäß ins Rutschen kommen.
|
||||
public protocol PlexTransport: Sendable {
|
||||
func data(for request: URLRequest) async throws -> (Data, URLResponse)
|
||||
}
|
||||
|
||||
extension URLSession: PlexTransport {}
|
||||
|
||||
/// Eine Anfrage an Plex, unabhängig davon, an welchen Host sie geht.
|
||||
///
|
||||
/// Plex nimmt den Token wahlweise als Kopfzeile oder als Abfrageparameter.
|
||||
/// Hier steht er in der Kopfzeile — sonst landet er in jedem Protokoll und in
|
||||
/// jedem Absturzbericht, der URLs mitschreibt.
|
||||
public struct PlexRequest: Sendable, Equatable {
|
||||
public enum Method: String, Sendable { case get = "GET", post = "POST", put = "PUT", delete = "DELETE" }
|
||||
|
||||
public var method: Method
|
||||
public var path: String
|
||||
public var query: [URLQueryItem]
|
||||
public var additionalHeaders: [String: String]
|
||||
|
||||
public init(
|
||||
method: Method = .get,
|
||||
path: String,
|
||||
query: [URLQueryItem] = [],
|
||||
additionalHeaders: [String: String] = [:]
|
||||
) {
|
||||
self.method = method
|
||||
self.path = path
|
||||
self.query = query
|
||||
self.additionalHeaders = additionalHeaders
|
||||
}
|
||||
|
||||
/// Setzt die Anfrage gegen einen Host zusammen.
|
||||
public func urlRequest(
|
||||
baseURL: URL,
|
||||
identity: PlexClientIdentity,
|
||||
token: String?
|
||||
) throws(PlexError) -> URLRequest {
|
||||
guard var components = URLComponents(
|
||||
url: baseURL.appending(path: path),
|
||||
resolvingAgainstBaseURL: false
|
||||
) else {
|
||||
throw .transport(description: "Ungültige Basisadresse: \(baseURL)")
|
||||
}
|
||||
components.queryItems = query.isEmpty ? nil : query
|
||||
|
||||
guard let url = components.url else {
|
||||
throw .transport(description: "Anfrage ließ sich nicht zusammensetzen: \(path)")
|
||||
}
|
||||
|
||||
var request = URLRequest(url: url)
|
||||
request.httpMethod = method.rawValue
|
||||
for (field, value) in identity.headers {
|
||||
request.setValue(value, forHTTPHeaderField: field)
|
||||
}
|
||||
for (field, value) in additionalHeaders {
|
||||
request.setValue(value, forHTTPHeaderField: field)
|
||||
}
|
||||
if let token {
|
||||
request.setValue(token, forHTTPHeaderField: "X-Plex-Token")
|
||||
}
|
||||
return request
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user