Apps zu Android 13 migrieren

Dieses Dokument bietet einen allgemeinen Überblick über die typischen Entwicklungs- und Testphasen, die Ihnen helfen können, einen Plan für die Vorbereitung zu erstellen, der gut auf den Zeitplan für die Plattformversion abgestimmt ist und eine optimale Nutzererfahrung auf Android 13 gewährleistet.

Mit jeder neuen Android-Version führen wir neue Funktionen und Verhaltensänderungen ein, die Android noch hilfreicher, sicherer und leistungsfähiger machen sollen. In vielen Fällen funktioniert Ihre App sofort 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 verwenden, sobald der Quellcode im AOSP (Android Open Source Project) veröffentlicht wird. Daher ist es wichtig, dass Ihre Apps bereit sind, wie erwartet funktionieren und idealerweise neue Funktionen und APIs nutzen, um das Beste aus der neuen Plattform herauszuholen.

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

  • Für App-Kompatibilität sorgen (bis zum finalen Release 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 sicherstellen

Es ist wichtig, die Funktionalität Ihrer vorhandenen App unter Android 13 zu testen, um Nutzern, die auf die neueste Android-Version aktualisieren, eine optimale Nutzererfahrung zu bieten. Einige Plattformänderungen können sich auf das Verhalten Ihrer App auswirken. Daher ist es wichtig, frühzeitig und gründlich zu testen und alle erforderlichen 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. Das kann jedoch davon abhängen, wie Ihre App erstellt wurde und welche Plattformfunktionen sie verwendet.

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

Android 13 herunterladen

Spiele ein Android 13-Systemimage auf dein Gerät oder lade ein Systemimage für den Android-Emulator herunter.

Änderungen ansehen

Sehen Sie sich die Änderungen am Systemverhalten an, um Bereiche zu identifizieren, in denen Ihre App betroffen sein könnte.

Testen

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

Update

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 sie ursprünglich ausgerichtet war. Sie muss nicht auf Android 13 ausgerichtet sein.

Veröffentlichen

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

Kompatibilitätstests durchführen

Die Kompatibilitätstests für Android 13 ähneln größtenteils den normalen App-Tests. Jetzt ist ein guter Zeitpunkt, um sich die Richtlinien zur App-Qualität und die Best Practices für Tests anzusehen.

Installieren Sie dazu Ihre aktuell veröffentlichte App auf einem Gerät mit Android 13 und durchlaufen Sie alle Abläufe und Funktionen, um nach Problemen zu suchen. Damit Sie sich bei Ihren Tests auf das Wesentliche konzentrieren können, sollten Sie sich die Verhaltensänderungen für alle Apps in Android 13 ansehen, die sich auf die Funktionsweise Ihrer App auswirken oder dazu führen können, dass Ihre App abstürzt.

Prüfen und testen Sie auch, ob eingeschränkte Nicht-SDK-Schnittstellen verwendet werden. Sie sollten alle eingeschränkten Schnittstellen, die Ihre App verwendet, durch ein öffentliches SDK oder NDK-Äquivalent ersetzen. Achten Sie auf logcat-Warnungen, die auf diese Zugriffe hinweisen, und verwenden Sie die Methode StrictMode detectNonSdkApiUsage(), um sie programmatisch abzufangen.

Testen Sie die Bibliotheken und SDKs in Ihrer App gründlich, 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 auf die neueste Version des SDK oder wenden Sie sich an den SDK-Entwickler.

Wenn Sie mit dem Testen fertig sind und alle erforderlichen Änderungen vorgenommen haben, empfehlen wir, die kompatible App sofort zu veröffentlichen. So können Ihre Nutzer die App frühzeitig testen und Sie können dafür sorgen, dass die Umstellung auf Android 13 reibungslos verläuft.

Ausrichtung der App aktualisieren und mit neuen APIs erstellen

Nachdem Sie eine kompatible Version Ihrer App veröffentlicht haben, müssen Sie als Nächstes die targetSdkVersion aktualisieren und die neuen APIs und Funktionen in Android 13 nutzen, um vollständige Unterstützung für Android 13 hinzuzufügen. 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 beheben müssen. In einigen Fällen erfordern diese Änderungen einen erheblichen Entwicklungsaufwand. Wir empfehlen daher, sich so früh wie möglich damit auseinanderzusetzen. Mithilfe von Kompatibilitätsschaltern können Sie Ihre App mit ausgewählten Änderungen testen, um bestimmte Verhaltensänderungen zu ermitteln, 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 aktuelle Version der Android Studio-Vorschau, um Apps für Android 13 zu entwickeln. Sie benötigen ein Gerät oder einen Emulator mit Android 13.
Aktualisieren Sie Ihre targetSdkVersion und andere Build-Konfigurationen.

Verhaltensänderungen ansehen

Sehen Sie sich die Verhaltensänderungen an, die für Apps gelten, die auf Android 13 ausgerichtet sind. Identifizieren Sie Bereiche, in denen Ihre App betroffen sein könnte, und planen Sie, wie Sie sie unterstützen können.

Auf neue Änderungen beim Datenschutz prüfen

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

Android 13-Funktionen übernehmen

Nutzen Sie die Android 13-APIs, um Ihren Apps neue Funktionen und Möglichkeiten hinzuzufügen. Kompilieren Sie die App für Android 13 neu.

Testen

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

Letztes Update

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

Veröffentlichen

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

SDK herunterladen, Targeting ändern, mit neuen APIs entwickeln

Wenn Sie mit dem Testen der vollständigen Android 13-Unterstützung beginnen möchten, laden Sie mit der neuesten Preview-Version von Android Studio das Android 13 SDK und alle anderen benötigten Tools herunter. Aktualisieren Sie als Nächstes die targetSdkVersion und compileSdkVersion Ihrer App und kompilieren Sie die App neu. Weitere Informationen finden Sie in der Anleitung zur SDK-Einrichtung.

Android 13-App testen

Nachdem Sie die App kompiliert und auf einem Gerät mit Android 13 installiert haben, beginnen Sie mit dem Testen, um sicherzustellen, dass die App ordnungsgemäß funktioniert, wenn sie auf Android 13 ausgerichtet ist. Einige Verhaltensänderungen gelten nur, wenn Ihre App auf die neue Plattform ausgerichtet ist. Sehen Sie sich diese Änderungen daher an, bevor Sie loslegen.

Wie bei grundlegenden Kompatibilitätstests sollten Sie alle Abläufe und Funktionen durchgehen und nach Problemen suchen. Konzentrieren Sie sich beim Testen auf die Verhaltensänderungen für Apps, die auf Android 13 ausgerichtet sind. Außerdem ist es ein guter Zeitpunkt, deine App anhand der Qualitätsrichtlinien für Apps und der Best Practices für Tests zu prüfen.

Prüfen Sie, ob Verwendungen von eingeschränkten Nicht-SDK-Schnittstellen vorliegen, die für Sie relevant sein könnten, und führen Sie entsprechende Tests durch. Achten Sie auf logcat-Warnungen, die diese Zugriffe hervorheben, und verwenden Sie die StrictMode-Methode detectNonSdkApiUsage(), um sie programmatisch abzufangen.

Testen Sie die Bibliotheken und SDKs in Ihrer App gründlich, 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 auf die neueste Version des SDK oder wenden Sie sich an den SDK-Entwickler.

Mit App-Kompatibilitätsschaltern testen

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

  • Gezielte Änderungen testen, ohne die targetSdkVersion der App tatsächlich zu ändern: Mit den Ein/Aus-Schaltern können Sie bestimmte Änderungen des Zielverhaltens erzwingen, um die Auswirkungen auf Ihre bestehende App zu bewerten.
  • Konzentrieren Sie sich beim Testen nur auf bestimmte Änderungen. Anstatt alle Änderungen auf einmal vornehmen zu müssen, können Sie mit den Ein/Aus-Schaltern alle Änderungen deaktivieren, die Sie nicht testen möchten.
  • Schalter über adb verwalten Mit adb-Befehlen können Sie die umschaltbaren Änderungen in Ihrer automatisierten Testumgebung aktivieren und deaktivieren.
  • Fehler mithilfe von Standard-Änderungs-IDs schneller beheben: Jede umschaltbare Änderung hat eine eindeutige ID und einen eindeutigen Namen, mit denen Sie die Ursache im Log-Output schnell debuggen können.

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