AsyncStream für iOS auf dem Cloud-Mac testen

AsyncStream für iOS auf dem Cloud-Mac testen

AsyncStream für iOS auf dem Cloud-Mac testen

Ihre iOS-Ansicht empfängt Fortschrittsereignisse über AsyncStream. Bei gelegentlichen Aufrufen funktioniert alles, doch bei mehreren Aufrufen kurz hintereinander fehlen Zwischenstände. Nach dem Verlassen der Ansicht arbeitet der zugrunde liegende Listener weiter. Verlängern Sie jetzt nicht einfach die Wartezeiten. Legen Sie auf einem Cloud-Mac von VPSPull die Reihenfolge von Ereignisproduktion und -verbrauch fest und prüfen Sie die Verträge für Pufferung, Abschluss und Bereinigung getrennt. So lässt sich die Ursache leichter eingrenzen als durch wiederholtes Klicken auf dem Remote-Desktop.

Zuerst festlegen, welche Ereignisse verloren gehen dürfen

Bei Fortschrittsangaben genügt meist der aktuelle Stand. Zahlungsbestätigungen oder Protokolle über ausgelieferte Dateien dürfen dagegen nicht einfach verloren gehen. Halten Sie zunächst drei Bedingungen für den Stream fest: Welche Werte müssen ankommen, was soll bei einem Rückstau passieren und wer ist dafür verantwortlich, den Produzenten zu stoppen? Überlassen Sie diese fachlichen Entscheidungen nicht der Standard-Pufferstrategie.

unbounded hält noch nicht konsumierte Elemente vor. Bei dauerhafter Produktion kann der Speicherbedarf jedoch immer weiter wachsen. bufferingNewest(2) behält die neuesten zwei Elemente, bufferingOldest(2) die ältesten zwei noch nicht konsumierten Elemente. Die Kapazität bezeichnet hier die Anzahl der Elemente, nicht die Anzahl der Bytes. Große Objekte können deshalb weiterhin viel Speicher belegen.

Ein begrenzter Puffer ist keine Backpressure. AsyncStream wartet bei yield nicht darauf, dass der Konsument Platz schafft. Wenn die Anwendung eine verlustfreie Übertragung verlangt, sind zusätzliche Bestätigungen, eine Ratenbegrenzung oder ein Persistenzmechanismus nötig.

Testen Sie zunächst mit nur einem Konsumenten. Wenn mehrere Tasks denselben Stream konsumieren, ergibt sich daraus nicht automatisch ein Broadcast-Modell, bei dem jeder Abonnent alle Ereignisse erhält.

Eine Test-Fixture ohne Abhängigkeit vom Scheduler aufbauen

Führen Sie in einem Terminal mit eingerichteter Swift-Toolchain Folgendes aus:

mkdir StreamContract
cd StreamContract
swift package init --type library --name StreamContract
swift --version

Ersetzen Sie den Inhalt der erzeugten Testdatei durch den folgenden XCTest-Test. Die Datei liegt unter Tests/StreamContractTests/StreamContractTests.swift. Falls die generierte Vorlage weitere Testdateien enthält, entfernen Sie zunächst deren Beispieltests, damit keine sachfremden Ergebnisse in den Bericht gelangen.

import XCTest

final class StreamContractTests: XCTestCase {
    func testNewestBufferDrainsAfterFinish() async {
        let pair = AsyncStream<Int>.makeStream(
            bufferingPolicy: .bufferingNewest(2)
        )

        pair.continuation.yield(1)
        pair.continuation.yield(2)

        switch pair.continuation.yield(3) {
        case .dropped(let value):
            XCTAssertEqual(value, 1)
        default:
            XCTFail("Expected the oldest buffered value to be dropped")
        }

        pair.continuation.finish()

        var iterator = pair.stream.makeAsyncIterator()
        let first = await iterator.next()
        let second = await iterator.next()
        let end = await iterator.next()

        XCTAssertEqual(first, 2)
        XCTAssertEqual(second, 3)
        XCTAssertNil(end)

        switch pair.continuation.yield(4) {
        case .terminated:
            break
        default:
            XCTFail("Expected a terminated stream")
        }
    }
}

Führen Sie anschließend swift test aus. Dieser Test produziert zuerst die Werte und konsumiert sie erst danach. Damit erzwingt er den Pufferüberlauf ausdrücklich, ohne die Ausführungsreihenfolge mithilfe von Sleeps erraten zu müssen. Falls die Toolchain kein makeStream bietet, prüfen Sie zunächst die Swift-Version oder beziehen Sie die Continuation über die Initialisierungs-Closure. Entfernen Sie nicht die Assertion zum Pufferüberlauf, nur um den Test „kompatibel“ zu machen.

Verworfene Werte prüfen, nicht nur das Konsumergebnis

Es reicht nicht, lediglich zu prüfen, ob am Ende 2, 3 ankommen. Eine fehlerhafte Implementierung könnte 1 selbst herausfiltern und zufällig dasselbe Ergebnis liefern. Erst der Rückgabewert .dropped von yield bestätigt, dass der Wert tatsächlich durch die Pufferstrategie verworfen wurde.

Kopieren Sie anschließend den Test und stellen Sie ihn auf bufferingOldest(2) um. Der dritte yield-Aufruf muss melden, dass 3 verworfen wurde; konsumiert werden müssen 1, 2. Geben Sie diesen Erwartungen jeweils einen eigenen Testnamen. Passen Sie die erwarteten Ergebnisse innerhalb des Tests nicht an die tatsächliche Ausgabe an.

Ergänzen Sie außerdem einen Grenzfall: Bei einer Kapazität von null und ohne wartenden Konsumenten wird das mit yield übergebene Element verworfen. Ein Puffer mit Kapazität null garantiert keine synchrone Übergabe. Startet der Test den Konsumenten vorab, braucht er ein Synchronisationssignal, das dessen bereits begonnenes Warten bestätigt. Andernfalls hängt das Ergebnis vom Task-Scheduling ab.

Bei echten Objekten genügt es, stabile Ereignis-IDs festzuhalten. Schreiben Sie nicht die vollständige Nutzlast ins Log. Bei großen Daten reichen die ID, die Anzahl verworfener Elemente und die Pufferstrategie für die Analyse aus.

finish, Abbruch und vorzeitigen Ausstieg getrennt prüfen

finish() bedeutet, dass keine neuen Elemente mehr angenommen werden. Bereits gepufferte Elemente werden dadurch nicht sofort verworfen. Der obige Test prüft bewusst, dass zunächst 2, 3 vollständig gelesen werden und next erst danach nil zurückgibt. Ein yield nach dem Abschluss muss dagegen .terminated liefern.

Bauen Sie für den Abbruchtest eine eigene Fixture: Lassen Sie den konsumierenden Task auf next warten, brechen Sie ihn ab und warten Sie anschließend auf sein Ende. Erfassen Sie onTermination mit einem threadsicheren Zähler oder einer Test-Expectation. Prüfen Sie, dass der Terminierungsgrund ein Abbruch ist und der zugrunde liegende Listener angehalten wurde. Ein begrenztes Timeout verhindert lediglich, dass der Test hängen bleibt; es ist kein Nachweis fachlicher Korrektheit.

Ein vorzeitiger Ausstieg braucht einen klaren Verantwortlichen

Ein break innerhalb der Schleife beendet nur die Schleife. Solange andere Objekte den Stream oder die Continuation halten, lässt sich daraus nicht schließen, dass der Listener freigegeben wurde. Stellen Sie am Adapter ein explizites stop bereit, das vom Verantwortlichen für die Ansicht oder den Dienst aufgerufen wird, und prüfen Sie anschließend die Anzahl der Abmeldungen.

onTermination kann in einem nebenläufigen Kontext ausgeführt werden. Der von der Bereinigungs-Closure erfasste Zustand muss daher nebenläufige Zugriffe sicher unterstützen. Ändern Sie keine UI-Objekte direkt, auf die ausschließlich vom Hauptthread aus zugegriffen werden darf. Rufen Sie außerdem nicht finish auf, während Sie eine interne Sperre halten, wenn der Terminierungs-Callback anschließend dieselbe Sperre anfordert.

Mit einer Fehlermatrix abschließen statt länger zu warten

Behalten Sie am Ende mindestens vier Arten von Abnahmeprüfungen bei: Der Puffer für die neuesten Werte verdrängt alte Werte, der Puffer für die ältesten Werte weist neue Werte zurück, ein regulärer Abschluss leert den Puffer und nach einem Abbruch stoppt die Produktion. Prüfen Sie in jeder Kategorie die Werte, den Abschlusszustand und die Anzahl der Bereinigungen. So vermeiden Sie, dass Tests bestehen, während Ressourcen weiterhin aktiv sind.

Erzeugen Sie danach mit einem simulierten Listener eine Race Condition beim Stoppen: Lösen Sie nach stop noch einen weiteren Callback aus. Der Adapter muss ihn sicher ignorieren oder terminated erhalten; er darf kein fachliches Ereignis doppelt zustellen. Auch wiederholte stop-Aufrufe müssen idempotent bleiben und dürfen denselben Listener-Handle nicht mehrfach abmelden.

Dokumentieren Sie bei der Abgabe auch die Toolchain-Version, den Testbefehl und die Namen fehlgeschlagener Testfälle. Wenn die Tests mit fester Reihenfolge stabil laufen, in der echten Ansicht aber weiterhin Ereignisse fehlen, prüfen Sie als Nächstes den Adapter der Ereignisquelle und die Verarbeitungsgeschwindigkeit des Konsumenten. Ist bereits die Fixture instabil, korrigieren Sie zuerst die Synchronisation. Verstecken Sie Race Conditions nicht hinter längeren Sleeps.

Häufig gestellte Fragen

Wartet der Produzent bei bufferingNewest auf den Verbraucher?

Nein. Ein voller Puffer verdrängt einen älteren Wert; yield meldet den Verlust, wartet aber nicht. Begrenzte, verlustfreie Übertragung braucht eine zusätzliche Bestätigung oder Flusssteuerung.

Gibt break den Listener sofort frei?

Nicht zwingend. Stream und Continuation können weiterhin referenziert sein. Der Besitzer sollte einen expliziten Stopp anbieten; Abbruch, Stopp und regulärer Abschluss werden getrennt getestet.

Workflow auf einem dedizierten Mac testen

Prüfen Sie zuerst Modell, Standort und Mietdauer und testen Sie Ihren Workflow anschließend tageweise. Maßgeblich ist der aktuelle Verfügbarkeitsstatus in der Konsole.