import XCTest /// Fährt die App in die Zustände, über die geredet wird, und legt Bilder davon ab. /// /// Der Grund für diese Datei ist ein wiederkehrender Fehler: Aussagen über das /// Aussehen waren Vermutungen, weil niemand hinsehen konnte. Der Simulator /// kennt keinen Befehl fürs Antippen, und dieses Xcode bringt kein /// Simulator-Fenster mehr mit, das sich fernsteuern ließe. Ein UI-Test kann /// beides — tippen und fotografieren. /// /// Die Bilder landen im Dokumentenordner des Testläufers, der vom Rechner aus /// über `simctl get_app_container` erreichbar ist. Anhänge im Ergebnisbündel /// wären der vorgesehene Weg, müssten aber erst wieder herausgeschält werden. /// /// Die Inhalte kommen aus `Tools/JellyfinStub` — kein echter Server, kein /// echtes Konto, kein echter Token. final class LayoutSnapshots: XCTestCase { override func setUp() { continueAfterFailure = false } /// `XCUIScreen` fotografiert in der Lage des **Geräts**, nicht in der der /// Oberfläche — im Querformat kommt das Bild dann hochkant und um /// neunzig Grad gedreht heraus, und jedes Maß daran ist falsch herum. /// Die App selbst fotografiert richtig herum. private func shoot(_ app: XCUIApplication, _ name: String) { let data = app.screenshot().pngRepresentation let folder = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0] try? data.write(to: folder.appendingPathComponent("\(name).png")) } /// Das Umschalten zwischen Seitenleiste und Leiste oben. /// /// Beim Umschalten steht die Leiste kurz falsch, bevor sie sich fängt. /// Fotografiert wird in Serie, weil genau der Zwischenzustand gesucht ist /// und ein einzelnes Bild danach nichts zeigt. /// Eine Unterseite der Einstellungen. /// /// Sie wird über einen gewöhnlichen Verweis geschoben und nicht über eine /// angemeldete Route — genau dort fehlte der Platz für die Seitenleiste, /// und die Beschriftungen lagen hinter ihr. func testPushedSettingsScreen() throws { let app = XCUIApplication() app.launchArguments = [ "-HaloStubServer", "http://127.0.0.1:8096", "-halo.navigation.placement", "sidebar", ] app.launch() XCUIDevice.shared.orientation = .landscapeLeft XCTAssertTrue(app.staticTexts["Weiterschauen"].waitForExistence(timeout: 20)) app.buttons["Einstellungen"].firstMatch.tap() Thread.sleep(forTimeInterval: 2) shoot(app, "30-einstellungen") let server = app.buttons["Server"].firstMatch if server.waitForExistence(timeout: 5) { server.tap() Thread.sleep(forTimeInterval: 2) shoot(app, "31-server") } } func testSidebarToggle() throws { let app = XCUIApplication() // Die Stellung der Leiste wird gespeichert, und ein voriger Lauf hat // sie womöglich umgestellt. Ein Startargument überschreibt sie, damit // jeder Lauf beim selben Bild anfängt. app.launchArguments = [ "-HaloStubServer", "http://127.0.0.1:8096", "-halo.navigation.placement", "sidebar", ] app.launch() XCUIDevice.shared.orientation = .landscapeLeft XCTAssertTrue(app.staticTexts["Weiterschauen"].waitForExistence(timeout: 20)) Thread.sleep(forTimeInterval: 2) shoot(app, "10-seitenleiste") // Über die Beschriftung gesucht, nicht über die Stellung: „der zweite // Knopf" war einmal der Umschalter und nach einem Umbau die Kontozeile, // und der Test öffnete fortan das Kontomenü. let toggle = app.buttons["Navigation nach oben"] XCTAssertTrue(toggle.waitForExistence(timeout: 5)) toggle.tap() for step in 0..<8 { shoot(app, String(format: "11-umschalten-%d", step)) Thread.sleep(forTimeInterval: 0.1) } Thread.sleep(forTimeInterval: 2) shoot(app, "12-oben") } /// Dasselbe auf einem schmalen Bildschirm, hochkant. /// /// Eigener Test, weil dort alles anders ist: keine Seitenleiste, die /// Leiste unten, und der Aufmacher hochkant statt 16:9. func testPhoneHome() throws { let app = XCUIApplication() app.launchArguments = ["-HaloStubServer", "http://127.0.0.1:8096"] app.launch() XCTAssertTrue(app.staticTexts["Weiterschauen"].waitForExistence(timeout: 20)) Thread.sleep(forTimeInterval: 3) shoot(app, "20-iphone") } func testHomeAndDetail() throws { let app = XCUIApplication() // Die Stellung der Leiste wird gespeichert, und ein voriger Lauf hat // sie womöglich umgestellt. Ein Startargument überschreibt sie, damit // jeder Lauf beim selben Bild anfängt. app.launchArguments = [ "-HaloStubServer", "http://127.0.0.1:8096", "-halo.navigation.placement", "sidebar", ] app.launch() XCUIDevice.shared.orientation = .landscapeLeft // Die Startseite muss stehen, bevor fotografiert wird — sonst ist auf // dem Bild nur der Ladekreis. XCTAssertTrue(app.staticTexts["Weiterschauen"].waitForExistence(timeout: 20)) Thread.sleep(forTimeInterval: 3) shoot(app, "01-start-oben") // Der Aufmacher wechselt nach sieben Sekunden. Kurz davor anfangen // und in Serie fotografieren: nur so ist der Übergang selbst zu sehen // und nicht bloß sein Ergebnis. Thread.sleep(forTimeInterval: 4.2) for step in 0..<6 { shoot(app, String(format: "02-wechsel-%d", step)) Thread.sleep(forTimeInterval: 0.12) } Thread.sleep(forTimeInterval: 2) shoot(app, "03-danach") // Und gescrollt: dort zieht alles an der Seitenleiste vorbei, und was // dabei durch sie hindurch zu sehen ist, entscheidet, ob sie ruhig // wirkt oder unruhig. // Ein gezogener Strich statt `swipeUp`: der Aufmacher fängt Wischgesten // ab, und `app.scrollViews.firstMatch` ist die **waagerechte** Reihe, // nicht die Seite. Gezogen wird deshalb tief unten, wo nur die Seite // selbst zuhört. func scroll() { // Mitten auf dem Aufmacher anfassen, nicht darunter: dort schluckte // seine Wischgeste das Scrollen, und genau das soll sie nicht mehr. let from = app.coordinate(withNormalizedOffset: CGVector(dx: 0.6, dy: 0.55)) let to = app.coordinate(withNormalizedOffset: CGVector(dx: 0.6, dy: 0.35)) from.press(forDuration: 0.05, thenDragTo: to) Thread.sleep(forTimeInterval: 1.5) } scroll() shoot(app, "04-gescrollt") scroll() shoot(app, "05-gescrollt-weiter") } }