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, die Leistung für Nutzer wie erwartet ist und sie idealerweise neue Funktionen und APIs nutzen, um die neue Plattform optimal zu nutzen.

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

  • Für App-Kompatibilität sorgen (bis zur Veröffentlichung der 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 dem Testen beginnen, sollten Sie sich 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 erhalten

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

Änderungen prüfen

Prüfe die Änderungen im Systemverhalten, um festzustellen, in welchen Bereichen deine App betroffen sein könnte.

Testen

Installiere deine App auf deinem Gerät oder Emulator und führe Tests durch. Konzentrieren Sie sich auf Änderungen am Systemverhalten und gehen Sie alle App-Abläufe durch.

Aktualisieren

Nehmen Sie nur die Codeänderungen vor, die zur Anpassung an Verhaltensänderungen oder zur Behebung von Problemen erforderlich sind. 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 du dich auf deine Tests konzentrieren kannst, solltest du dir die Verhaltensänderungen für alle Apps in Android 13 durchlesen, die sich auf die Funktionsweise deiner App auswirken oder zum Absturz der App führen können.

Prüfen und testen Sie außerdem, ob eingeschränkte Nicht-SDK-Schnittstellen verwendet werden. 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 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 spezifische 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 Build-Konfigurationen.

Änderungen am Nutzerverhalten ü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 Code- und Architekturänderungen vor, die für die Unterstützung der Änderungen am Datenschutz von Android 13 erforderlich sind.

Android 13-Funktionen einführen

Nutze die Android 13 APIs, um neue Funktionen in deine Apps zu bringen. 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 nutzen. 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 herunterladen, Targeting ändern, neue APIs verwenden

Wenn Sie mit dem Testen der vollständigen Android 13-Unterstützung beginnen möchten, verwenden Sie die neueste Vorschauversion von Android Studio. Laden Sie dann das Android 13 SDK und alle anderen erforderlichen Tools herunter. Aktualisieren Sie als Nächstes die targetSdkVersion und die compileSdkVersion Ihrer App und kompilieren Sie die App neu. Weitere Informationen finden Sie im SDK-Einrichtungsleitfaden.

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 werden nur angewendet, wenn Ihre App auf die neue Plattform ausgerichtet ist. Sie sollten sich also vorab über die Änderungen informieren.

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. Außerdem solltest du deine App anhand der Qualitätsrichtlinien für Apps und Best Practices für Tests prüfen.

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.

Mit 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 debugbaren App können Sie mit den Ein-/Aus-Schaltflächen Folgendes tun:

  • Zielgerichtete Änderungen testen, ohne die targetSdkVersion der App tatsächlich 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 Mit ADB-Befehlen können Sie die ein- und ausschaltbaren Änderungen in Ihrer automatisierten Testumgebung aktivieren und deaktivieren.
  • Mithilfe von Standard-Änderungs-IDs schneller Fehler beheben Umschaltbare Änderungen haben jeweils eine eindeutige ID und einen eindeutigen Namen, mit denen Sie die Ursache in der Logausgabe 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).