Tutorial: Grauer Bildschirm beim Start der Airports-App auf dem iPad beheben

Melden

Auf dem iPad nutzt die Airports-App ein angepasstes Split-View-Layout (Spaltenansicht), um den größeren Bildschirm optimal auszunutzen. In bestimmten Situationen kann es beim Start dazu kommen, dass die App lediglich einen leeren, grauen Bildschirm anzeigt.

Dieses Problem tritt meist auf, wenn das System versucht, eine Detailansicht zu laden, für die noch keine Daten ausgewählt wurden, oder wenn die Ausrichtung (Portrait/Landscape) beim Initialisieren fehlschlägt.

In diesem Tutorial erfährst du, wie sich dieser Fehler sowohl als Endanwender schnell umgehen lässt als auch wie er als Entwickler im Code behoben wird.


Teil 1: Schnelle Lösungen für Nutzer

Wenn du die Airports-App auf deinem iPad nutzt und der Bildschirm grau bleibt, helfen folgende Schritte:

1. Ausrichtung des iPads ändern (Bildschirm drehen)

Der schnellste Workaround:

  • Halte das iPad fest und drehe es um 90 Grad (vom Hochformat ins Querformat oder umgekehrt).
  • Durch den Wechsel der Display-Dimensionen wird das Layout gezwungen, sich neu zu berechnen (View Layout Refresh). Das Menü bzw. die Flughafenliste wird dadurch meist sofort sichtbar.

2. Schließen der App erzwingen

Ein fehlerhafter Zwischenspeicher kann den Start blockieren:

  1. Wische vom unteren Bildschirmrand nach oben und halte kurz an, um den App-Umschalter zu öffnen.
  2. Wische die Karte der Airports-App nach oben weg.
  3. Tippe erneut auf das App-Symbol, um sie sauber neu zu starten.

3. Split-Screen / Multitasking zurücksetzen

Falls die App im Multitasking-Modus (Split View oder Slide Over) gestartet wurde:

  • Ziehe den Trennstrich ganz an den Bildschirmrand, um die App im Vollbildmodus auszuführen.

Teil 2: Lösung für Entwickler (SwiftUI / UIKit)

Ursache für den grauen Bildschirm ist fast immer ein nicht initialisierter Detail-View in einem NavigationSplitView (SwiftUI) oder UISplitViewController (UIKit). Auf dem iPad wird standardmäßig eine zweispaltige Ansicht erwartet. Bleibt die rechte Spalte leer oder wartet auf eine Auswahl (nil), zeigt iPadOS lediglich den grauen Standard-Hintergrund an.

Behebung in SwiftUI

Stelle sicher, dass im NavigationSplitView immer eine Standard-Detailansicht (Fallback) definiert ist, falls noch kein Flughafen ausgewählt wurde.

Problembehafteter Code:

NavigationSplitView {
    AirportListView(selectedAirport: $selectedAirport)
} detail: {
    if let airport = selectedAirport {
        AirportDetailView(airport: airport)
    }
    // Fehlt der 'else'-Fall, bleibt der Bildschirm beim ersten Start grau!
}

Korrigierter Code:

NavigationSplitView {
    AirportListView(selectedAirport: $selectedAirport)
} detail: {
    if let airport = selectedAirport {
        AirportDetailView(airport: airport)
    } else {
        // Fallback: Zeigt einen Hinweis statt einer grauen Fläche
        ContentUnavailableView(
            "Kein Flughafen ausgewählt",
            systemImage: "airplane",
            description: Text("Wähle einen Flughafen aus der Liste aus.")
        )
    }
}

Behebung in UIKit (UISplitViewController)

Wenn das Layout mit UIKit umgesetzt wurde, muss das Verhalten für den kompakten Modus bzw. die primäre Spalte festgelegt werden:

  1. Präferenz für Spaltenanzeige setzen: Stelle sicher, dass die Sidebar auf dem iPad standardmäßig eingeblendet wird:

    splitViewController.preferredDisplayMode = .oneBesideSecondary
  2. Delegate-Methode implementieren: Verhindere, dass eine leere Detailansicht den Startbildschirm dominiert:

    extension SplitViewController: UISplitViewControllerDelegate {
        func splitViewController(
            _ svc: UISplitViewController,
            topColumnForCollapsingToProposedTopColumn proposedTopColumn: UIColumn
        ) -> UIColumn {
            // Zeigt auf kompakten Layouts immer zuerst die Liste
            return .primary
        }
    }

Zusammenfassung

  • Für Anwender: Ein kurzes Drehen des iPads löst das Problem in der Regel sofort, da die Benutzeroberfläche neu gezeichnet wird.
  • Für Entwickler: Der graue Bildschirm lässt sich dauerhaft vermeiden, indem man dem iPad-Layout immer einen definierten Fallback-Zustand für die Detailansicht mitgibt.
0