Apps zu Android 13 migrieren

Dieses Dokument bietet einen allgemeinen Überblick über typische Entwicklungs- und Testphasen, mit denen Sie einen Bereitschaftsplan erstellen können, der gut mit dem Zeitplan für die Plattformveröffentlichung übereinstimmt und eine hervorragende Nutzererfahrung unter Android 13 ermöglicht.

Mit jeder Android-Version führen wir neue Funktionen und Verhaltensänderungen ein, um Android hilfreicher, sicherer und leistungsfähiger zu machen. In vielen Fällen funktioniert Ihre App direkt nach der Installation genau wie erwartet. In anderen Fällen müssen Sie Ihre App möglicherweise aktualisieren, um sie an die Plattformänderungen anzupassen.

Nutzer können die neue Plattform nutzen, sobald der Quellcode für das Android Open Source Project (AOSP) freigegeben wird. Daher ist es wichtig, dass Ihre Apps bereit sind, wie erwartet funktionieren und idealerweise neue Funktionen und APIs nutzen, um die neue Plattform optimal zu nutzen.

Eine typische Migration umfasst zwei Phasen, die parallel ablaufen können:

  • Für App-Kompatibilität sorgen (bis zur finalen Version von Android 13)
  • Ausrichtung auf die neuen Plattformfunktionen und APIs (so bald wie möglich nach der endgültigen Veröffentlichung)

Kompatibilität mit Android 13

Es ist wichtig, die Funktionalität Ihrer vorhandenen App mit Android 13 zu testen, damit Nutzer, die auf die neueste Android-Version aktualisieren, eine optimale Nutzererfahrung haben. Einige Plattformänderungen können sich auf das Verhalten Ihrer App auswirken. Daher ist es wichtig, frühzeitig und gründlich zu testen und gegebenenfalls Anpassungen an Ihrer App vorzunehmen.

In der Regel können Sie Ihre App anpassen und ein Update veröffentlichen, ohne die targetSdkVersion der App ändern zu müssen. Ebenso sollten Sie keine neuen APIs verwenden oder die compileSdkVersion der App ändern müssen. Dies kann jedoch von der Art und Weise abhängen, wie Ihre App erstellt wurde, und von den verwendeten Plattformfunktionen.

Bevor Sie mit den Tests beginnen, sollten Sie sich mit den Änderungen am Verhalten für alle Apps vertraut machen. Diese Änderungen können sich auf Ihre App auswirken, auch wenn Sie die targetSdkVersion nicht ändern.

Android 13 erhalten

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

Änderungen prüfen

Prüfen Sie die Änderungen am Systemverhalten, um Bereiche zu identifizieren, in denen sich Ihre App möglicherweise auswirken könnte.

Testen

Installieren Sie Ihre App auf Ihrem Gerät oder Emulator und führen Sie Tests durch. Konzentrieren Sie sich auf Änderungen am Systemverhalten und arbeiten Sie alle App-Abläufe durch.

Aktualisieren

Nehmen Sie nur die Codeänderungen vor, die erforderlich sind, um sich an Verhaltensänderungen anzupassen oder Probleme zu beheben. Kompilieren Sie die App mit demselben API-Level neu, auf das Ihre App ursprünglich ausgerichtet war. Sie müssen sie nicht auf Android 13 ausrichten.

Veröffentlichen

Signieren, hochladen und veröffentlichen Sie Ihr aktualisiertes Android App Bundle oder APK.

Kompatibilitätstests durchführen

Im Großen und Ganzen ähnelt der Kompatibilitätstest mit Android 13 dem normalen App-Test. Sehen Sie sich die Qualitätsrichtlinien für Apps und die Best Practices für Tests noch einmal an.

Installieren Sie zum Testen Ihre aktuell veröffentlichte App auf einem Gerät mit Android 13 und prüfen Sie alle Abläufe und Funktionen auf Probleme. Damit Sie Ihre Tests besser ausrichten können, sollten Sie sich die Verhaltensänderungen für alle Apps ansehen, die in Android 13 eingeführt wurden und sich auf die Funktionsweise Ihrer App auswirken oder zu Abstürzen führen können.

Prüfen und testen Sie außerdem, ob eingeschränkte Nicht-SDK-Schnittstellen verwendet werden. Sie sollten alle eingeschränkten APIs in Ihrer App durch ein öffentliches SDK oder ein NDK-Äquivalent ersetzen. Achten Sie auf Logcat-Warnungen, die diese Zugriffe hervorheben, und verwenden Sie die StrictMode-Methode detectNonSdkApiUsage(), um sie programmatisch zu erfassen.

Testen Sie abschließend die Bibliotheken und SDKs in Ihrer App vollständig, um sicherzustellen, dass sie unter Android 13 wie erwartet funktionieren und die Best Practices für Datenschutz, Leistung, UX, Datenhandhabung und Berechtigungen einhalten. Wenn ein Problem auftritt, aktualisieren Sie das SDK auf die neueste Version oder wenden Sie sich an den SDK-Entwickler.

Wenn Sie die Tests abgeschlossen und alle erforderlichen Änderungen vorgenommen haben, empfehlen wir Ihnen, Ihre kompatible App sofort zu veröffentlichen. So können Ihre Nutzer die App frühzeitig testen und Sie sorgen für einen reibungslosen Übergang, wenn sie auf Android 13 aktualisieren.

Targeting der App aktualisieren und mit neuen APIs erstellen

Nachdem Sie eine kompatible Version Ihrer App veröffentlicht haben, ist der nächste Schritt, die volle Unterstützung für Android 13 hinzuzufügen. Aktualisieren Sie dazu die targetSdkVersion und nutzen Sie die neuen APIs und Funktionen von Android 13. Sie können diese Änderungen vornehmen, sobald Sie bereit sind. Beachten Sie dabei die Google Play-Anforderungen für die Ausrichtung auf die neue Plattform.

Wenn Sie Ihre Arbeit planen, um Android 13 vollständig zu unterstützen, sollten Sie sich die Verhaltensänderungen ansehen, die sich auf Apps auswirken, die auf Android 13 ausgerichtet sind. Diese gezielten Verhaltensänderungen können zu Funktionsproblemen führen, die Sie dann beheben müssen. In einigen Fällen erfordern diese Änderungen erhebliche Entwicklungsarbeit. Wir empfehlen Ihnen daher, sich so früh wie möglich darüber zu informieren und sie zu berücksichtigen. Mithilfe der Kompatibilitätsschalter können Sie Ihre App mit aktivierten Änderungen testen, um bestimmte Verhaltensänderungen zu identifizieren, die sich auf Ihre App auswirken.

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

Android 13 SDK herunterladen

Installieren Sie die neueste Version der Android Studio-Vorabversion, um mit Android 13 zu entwickeln. Sie benötigen ein Gerät oder einen Emulator mit Android 13.
Aktualisieren Sie Ihre targetSdkVersion- und andere Buildkonfigurationen.

Verhaltensänderungen überprüfen

Hier finden Sie Informationen zu den Verhaltensänderungen, die für Apps gelten, die auf Android 13 ausgerichtet sind. Ermitteln Sie Bereiche, in denen Ihre App möglicherweise betroffen ist, und planen Sie, wie Sie sie unterstützen können.

Neue Datenschutzänderungen prüfen

Nehmen Sie die erforderlichen Code- und Architekturänderungen vor, um die Änderungen am Datenschutz für Nutzer in Android 13 zu unterstützen.

Android 13-Funktionen verwenden

Mit den APIs von Android 13 können Sie Ihren Apps neue Funktionen hinzufügen. Kompilieren Sie die App neu für Android 13.

Testen

Testen Sie auf einem Android 13-Gerät oder -Emulator. Konzentrieren Sie sich auf Bereiche, in denen sich Verhaltensänderungen auf Ihre App auswirken könnten. Testen Sie Funktionen, die neue APIs verwenden. Geben Sie Feedback zur Plattform und API. Melden Sie alle Probleme mit Plattformen, APIs oder Drittanbieter-SDKs.

Letzte Aktualisierung

Sobald die Android 13 APIs fertig sind, aktualisieren Sie Ihre targetSdkVersion und andere Build-Konfigurationen noch einmal, nehmen Sie alle erforderlichen Änderungen vor und testen Sie Ihre App.

Veröffentlichen

Signieren, hochladen und veröffentlichen Sie Ihr aktualisiertes Android App Bundle oder APK.

SDK abrufen, Targeting ändern, mit neuen APIs erstellen

Wenn Sie die vollständige Unterstützung von Android 13 testen möchten, laden Sie mit der neuesten Vorabversion von Android Studio das Android 13 SDK und alle anderen erforderlichen Tools herunter. Aktualisieren Sie als Nächstes die targetSdkVersion und compileSdkVersion Ihrer App und kompilieren Sie die App noch einmal. Weitere Informationen finden Sie im Leitfaden zur SDK-Einrichtung.

Android 13-App testen

Nachdem Sie die App kompiliert und auf einem Gerät mit Android 13 installiert haben, können Sie mit dem Testen beginnen, um sicherzustellen, dass die App bei Ausrichtung auf Android 13 ordnungsgemäß funktioniert. Einige Verhaltensänderungen gelten nur, wenn Ihre App auf die neue Plattform ausgerichtet ist. Sie sollten sich diese Änderungen daher ansehen, bevor Sie beginnen.

Gehen Sie wie bei den grundlegenden Kompatibilitätstests alle Abläufe und Funktionen durch und suchen Sie nach Problemen. Konzentrieren Sie sich bei Ihren Tests auf die Verhaltensänderungen für Apps, die auf Android 13 ausgerichtet sind. Prüfen Sie auch, ob Ihre App die Qualitätsrichtlinien für Apps und die Best Practices für Tests erfüllt.

Prüfen und testen Sie die Verwendung von eingeschränkten Nicht-SDK-Schnittstellen, die möglicherweise gelten. Achten Sie auf Logcat-Warnungen, die diese Zugriffe hervorheben, und verwenden Sie die StrictMode-Methode detectNonSdkApiUsage(), um sie programmatisch zu erfassen.

Testen Sie abschließend die Bibliotheken und SDKs in Ihrer App vollständig, um sicherzustellen, dass sie unter Android 13 wie erwartet funktionieren und die Best Practices für Datenschutz, Leistung, UX, Datenhandhabung und Berechtigungen einhalten. Wenn ein Problem auftritt, aktualisieren Sie das SDK auf die neueste Version oder wenden Sie sich an den SDK-Entwickler.

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

Android 13 enthält Kompatibilitätsschalter, mit denen Sie Ihre App mit gezielten Verhaltensänderungen einfacher testen können. Bei einer debuggbaren App können Sie mit den Ein-/Aus-Schaltflächen Folgendes tun:

  • Zielgerichtete Änderungen testen, ohne die targetSdkVersion der App zu ändern Mit den Ein-/Aus-Schaltflächen können Sie bestimmte Änderungen am Verhalten erzwingen, um die Auswirkungen auf Ihre vorhandene App zu bewerten.
  • Konzentrieren Sie sich bei Ihren Tests nur auf bestimmte Änderungen. Anstatt alle Änderungen auf einmal anpassen zu müssen, können Sie mit den Ein-/Aus-Schaltflächen alle Änderungen deaktivieren, mit Ausnahme derjenigen, die Sie testen möchten.
  • Schalter über adb verwalten Mithilfe von adb-Befehlen können Sie die umschaltbaren Änderungen in Ihrer automatisierten Testumgebung aktivieren und deaktivieren.
  • Mithilfe von Standard-Änderungs-IDs schneller Fehler beheben Ein-/Aus-Änderungen haben jeweils eine eindeutige ID und einen Namen, mit denen Sie die Ursache in der Protokollausgabe schnell beheben können.

Die Ein-/Aus-Schaltflächen können hilfreich sein, wenn Sie das Targeting Ihrer App ändern oder die Android 13-Unterstützung entwickeln. Weitere Informationen finden Sie unter Änderungen am Kompatibilitäts-Framework (Android 13).