Apps zu Android 13 migrieren

Dieses Dokument bietet einen Überblick über typische Entwicklungs- und Testphasen, damit du einen Plan für deine Bereitschaft erstellen kannst, der gut mit dem Zeitplan für die Veröffentlichung der Plattform übereinstimmt und eine großartige Erfahrung für deine Nutzer unter Android 13 gewährleistet.

Mit jeder Android-Version führen wir neue Funktionen sowie Verhaltensänderungen ein, die Android noch nützlicher, sicherer und leistungsfähiger machen. In vielen Fällen funktioniert Ihre App standardmäßig genau wie erwartet. In anderen Fällen müssen Sie Ihre App jedoch möglicherweise aktualisieren, um sich an die Plattformänderungen anzupassen.

Nutzer können die neue Plattform nutzen, sobald der Quellcode für AOSP (Android Open Source Project) veröffentlicht wurde. Daher ist es wichtig, dass Ihre Apps bereit sind, erwartungsgemäß funktionieren und idealerweise die neuen Funktionen und APIs nutzen, um die neue Plattform optimal zu nutzen.

Eine typische Migration besteht aus zwei Phasen, die gleichzeitig stattfinden können:

  • Sicherstellung der App-Kompatibilität (bis zum endgültigen Release von Android 13)
  • Ausrichtung auf die neuen Plattformfunktionen und APIs (so schnell wie möglich nach dem endgültigen Release)

Kompatibilität mit Android 13 sicherstellen

Es ist wichtig, die Funktionalität deiner vorhandenen App mit Android 13 zu testen, damit die Aktualisierung auf die neueste Android-Version optimal funktioniert. Einige Plattformänderungen können sich auf das Verhalten Ihrer App auswirken. Daher ist es wichtig, frühzeitig und gründlich zu testen und die App gegebenenfalls anzupassen.

In der Regel kannst du deine App anpassen und ein Update veröffentlichen, ohne die targetSdkVersion der App ändern zu müssen. Ebenso solltest du keine neuen APIs verwenden oder die compileSdkVersion der Anwendung ändern müssen. Dies kann jedoch davon abhängen, wie deine App aufgebaut ist und welche Plattformfunktionen sie nutzen.

Bevor du mit dem Testen beginnst, solltest du dich mit den Verhaltensänderungen für alle Anwendungen vertraut machen. Diese Änderungen können sich auf Ihre Anwendung auswirken, auch wenn Sie die targetSdkVersion nicht ändern.

Android 13 herunterladen

Flashen Sie ein Android 13-System-Image auf Ihr Gerät oder laden Sie ein System-Image für den Android-Emulator herunter.

Änderungen prüfen

Sehen Sie sich Änderungen am Systemverhalten an, um herauszufinden, in welchen Bereichen Ihre Anwendung betroffen sein könnte.

Testen

Installiere deine App auf deinem Gerät oder in deinem Emulator und führe Tests durch. Konzentrieren Sie sich auf Änderungen des Systemverhaltens und durcharbeiten Sie alle App-Abläufe.

Aktualisieren

Nehmen Sie nur die Codeänderungen vor, die erforderlich sind, um sich an Verhaltensänderungen anzupassen oder Probleme zu beheben. Kompiliere mit demselben API-Level, auf das deine App ursprünglich ausgerichtet war – eine Ausrichtung auf Android 13 ist nicht erforderlich.

Veröffentlichen

Signiere, lade dein aktualisiertes Android App Bundle oder APK hoch und veröffentliche es.

Kompatibilitätstests durchführen

Das Testen der Kompatibilität mit Android 13 entspricht größtenteils dem Testen gewöhnlicher Apps. Jetzt ist ein guter Zeitpunkt, um die Qualitätsrichtlinien für Apps und die Best Practices für Tests zu lesen.

Installiere zum Testen deine aktuell veröffentlichte App auf einem Gerät mit Android 13 und führe alle Abläufe und Funktionen durch, während du nach Problemen suchst. Damit Sie sich auf Ihre Tests konzentrieren können, lesen Sie sich die Änderungen des Verhaltens für alle Apps in Android 13 durch, die sich auf die Funktionsweise Ihrer App oder zum Absturz Ihrer App auswirken können.

Prüfen und testen Sie die Verwendung von eingeschränkten Nicht-SDK-Schnittstellen. Sie sollten jede eingeschränkte Schnittstelle, die Ihre App verwendet, durch ein öffentliches SDK oder ein NDK-Äquivalent ersetzen. Achten Sie auf Logcat-Warnungen, die diese Zugriffe kennzeichnen, und verwenden Sie die StrictMode-Methode detectNonSdkApiUsage(), um sie programmatisch abzufangen.

Teste die Bibliotheken und SDKs in deiner App vollständig, um sicherzustellen, dass sie unter Android 13 wie erwartet funktionieren und die Best Practices für Datenschutz, Leistung, Nutzerfreundlichkeit, Datenverarbeitung und Berechtigungen eingehalten werden. Wenn Sie ein Problem feststellen, aktualisieren Sie das SDK auf die neueste Version oder wenden Sie sich an den SDK-Entwickler.

Wenn Sie die Tests abgeschlossen und Änderungen vorgenommen haben, empfehlen wir, die kompatible App sofort zu veröffentlichen. So können deine Nutzer die App frühzeitig testen und die Umstellung auf Android 13 reibungslos verläuft reibungslos.

Ausrichtung der App aktualisieren und neue APIs verwenden

Sobald du eine kompatible Version deiner App veröffentlicht hast, besteht der nächste Schritt darin, vollständige Unterstützung für Android 13 hinzuzufügen. Dazu musst du die targetSdkVersion aktualisieren und die neuen APIs und Funktionen unter Android 13 nutzen. Du kannst diese Aktualisierungen vornehmen, sobald du bereit bist. Beachte dabei die Google Play-Anforderungen für die Ausrichtung auf die neue Plattform.

Während du deine Arbeit planst, Android 13 vollständig zu unterstützen, solltest du dir die Änderungen des Verhaltens mit Auswirkungen auf Apps, die auf Android 13 ausgerichtet sind, ansehen. Diese Zielverhaltensänderungen können zu funktionalen Problemen führen, die Sie beheben müssen. In einigen Fällen erfordern diese Änderungen umfangreiche Entwicklungen. Daher empfehlen wir, sich so früh wie möglich mit diesen Änderungen vertraut zu machen und entsprechende Maßnahmen zu ergreifen. Mithilfe der Kompatibilitätseinstellungen können Sie bestimmte Verhaltensänderungen ermitteln, die sich auf Ihre Anwendung auswirken. Testen Sie sie dazu mit den aktivierten ausgewählten Änderungen.

In den folgenden Schritten wird beschrieben, wie Android 13 vollständig unterstützt wird.

Android 13 SDK herunterladen

Installiere für die Entwicklung mit Android 13 die neueste Version der Android Studio-Vorschau. Du benötigst ein Android 13-Gerät oder einen Emulator.
targetSdkVersion und andere Build-Konfigurationen aktualisieren.

Änderungen im Verhalten prüfen

Sieh dir die Änderungen am Verhalten von Apps an, die auf Android 13 ausgerichtet sind. Identifizieren Sie Bereiche, in denen Ihre Anwendung möglicherweise betroffen ist, und planen Sie, wie Sie diese unterstützen können.

Auf neue Datenschutzänderungen prüfen

Nimm Änderungen am Code und an der Architektur vor, die erforderlich sind, um die Änderungen zum Datenschutz für Nutzer von Android 13 zu unterstützen.

Android 13-Funktionen einführen

Profitieren Sie von den Android 13 APIs, um neue Funktionen für Ihre Apps bereitzustellen. Kompiliere für Android 13 neu.

Testen

Auf einem Android 13-Gerät oder -Emulator testen. Konzentrieren Sie sich auf Bereiche, in denen sich Verhaltensänderungen auf Ihre Anwendung auswirken könnten. Testen Sie Funktionen, die neue APIs verwenden. Feedback zu Plattform und API geben Probleme mit der Plattform, API oder SDKs von Drittanbietern melden.

Letztes Update

Sobald die Android 13 APIs fertig sind, aktualisiere targetSdkVersion und andere Build-Konfigurationen noch einmal, nimm weitere Updates vor und teste deine App.

Veröffentlichen

Signiere, lade dein aktualisiertes Android App Bundle oder APK hoch und veröffentliche es.

SDK herunterladen, Targeting ändern, mit neuen APIs entwickeln

Wenn du mit dem Testen der vollständigen Unterstützung von Android 13 beginnen möchtest, verwende die neueste Vorabversion von Android Studio, um das Android 13 SDK und alle anderen benötigten Tools herunterzuladen. Aktualisieren Sie dann targetSdkVersion und compileSdkVersion Ihrer App und kompilieren Sie die App neu. Weitere Informationen finden Sie im SDK-Einrichtungsleitfaden.

Android 13-App testen

Nachdem du die App kompiliert und auf einem Gerät mit Android 13 installiert hast, solltest du mit den Tests beginnen, um sicherzustellen, dass die App korrekt funktioniert, wenn sie auf Android 13 ausgerichtet ist. Einige Verhaltensänderungen gelten nur, wenn deine App auf die neue Plattform ausgerichtet ist. Daher solltest du diese Änderungen zuerst prüfen.

Gehen Sie wie bei einfachen Kompatibilitätstests alle Abläufe und Funktionalitäten durch, um nach Problemen zu suchen. Konzentriere dich bei deinen Tests auf die Änderungen des Verhaltens bei Apps, die auf Android 13 ausgerichtet sind. Außerdem sollten Sie prüfen, ob Ihre App die Qualitätsrichtlinien für Apps und die Best Practices für Tests erfüllt.

Prüfen Sie die Verwendung von eingeschränkten Nicht-SDK-Schnittstellen und prüfen Sie diese, falls zutreffend. Achten Sie auf Logcat-Warnungen, die diese Zugriffe kennzeichnen, und verwenden Sie die StrictMode-Methode detectNonSdkApiUsage(), um sie programmatisch abzufangen.

Teste die Bibliotheken und SDKs in deiner App vollständig, um sicherzustellen, dass sie unter Android 13 wie erwartet funktionieren und die Best Practices für Datenschutz, Leistung, Nutzerfreundlichkeit, Datenverarbeitung und Berechtigungen eingehalten werden. Wenn Sie ein Problem feststellen, aktualisieren Sie das SDK auf die neueste Version oder wenden Sie sich an den SDK-Entwickler.

Mit Ein-/Aus-Schaltflächen für die App-Kompatibilität testen

Android 13 umfasst Ein-/Aus-Schaltflächen für die Kompatibilität, mit denen du deine App mit gezielten Verhaltensänderungen einfacher testen kannst. Bei einer Debug-fähigen App können Sie mit den Ein-/Aus-Schaltflächen Folgendes tun:

  • Testen Sie gezielte Änderungen, ohne die targetSdkVersion der App tatsächlich zu ändern. Mithilfe der Ein-/Aus-Schaltflächen können Sie die Aktivierung bestimmter Änderungen des zielgerichteten Verhaltens erzwingen, um die Auswirkungen auf Ihre vorhandene App zu bewerten.
  • Konzentrieren Sie sich bei Ihren Tests nur auf bestimmte Änderungen. Mit den Ein-/Aus-Schaltflächen müssen Sie nicht alle gewünschten Änderungen gleichzeitig vornehmen, sondern alle zielgerichteten Änderungen mit Ausnahme der Änderungen deaktivieren, die Sie testen möchten.
  • Ein-/Aus-Schaltflächen über ADB verwalten: Mit ADB-Befehlen können Sie die ein- und schaltbaren Änderungen in Ihrer automatisierten Testumgebung aktivieren und deaktivieren.
  • Schnellere Fehlerbehebung mit Standardänderungs-IDs: Die ein-/ausschaltbaren Änderungen haben jeweils eine eindeutige ID und einen eindeutigen Namen, mit dem Sie schnell die Ursache in der Logausgabe beheben können.

Die Ein-/Aus-Schaltflächen können dir helfen, wenn du das Targeting deiner App änderst oder dich in der aktiven Entwicklung für die Unterstützung von Android 13 entwickelst. Weitere Informationen finden Sie unter Änderungen am Kompatibilitäts-Framework (Android 13).