Apps zu Android 13 migrieren

Dieses Dokument bietet einen allgemeinen Überblick über typische Entwicklungs- und Testphasen, mit denen du einen Plan für die Bereitschaft erstellen kannst, der gut auf den Releasezeitplan der Plattform abgestimmt ist und für eine optimale Nutzung von Android 13 sorgt.

Mit jedem Release von Android führen wir neue Funktionen ein und ändern das Verhalten, um Android noch hilfreicher, sicherer und leistungsfähiger zu machen. In vielen Fällen funktioniert Ihre Anwendung von Anfang an genau wie erwartet. In anderen Fällen müssen Sie sie möglicherweise aktualisieren, um sie an die Plattformänderungen anzupassen.

Nutzer können die neue Plattform erhalten, sobald der Quellcode für AOSP (Android Open Source Project) veröffentlicht wurde. Daher ist es wichtig, dass Ihre Anwendungen bereit sind, für Nutzer 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:

  • App-Kompatibilität sicherstellen (ab der endgültigen Version von Android 13)
  • Ausrichtung auf die neuen Plattformfunktionen und APIs (so bald 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, um für Nutzer, die auf die neueste Android-Version aktualisieren, eine optimale Nutzung zu gewährleisten. Einige Plattformänderungen können sich auf das Verhalten Ihrer App auswirken. Daher ist es wichtig, Ihre App frühzeitig und gründlich zu testen und bei Bedarf Anpassungen vorzunehmen.

In der Regel kannst du deine App anpassen und ein Update veröffentlichen, ohne die targetSdkVersion der App ändern zu müssen. Außerdem solltest du in der Regel weder neue APIs verwenden noch die compileSdkVersion der App ändern. Dies kann jedoch davon abhängen, wie deine App aufgebaut ist und welche Plattformfunktionen sie verwendet.

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 installieren

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

Änderungen überprü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 arbeiten Sie alle Anwendungsablä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. 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

Der Test der Kompatibilität mit Android 13 ähnelt größtenteils dem eines gewöhnlichen App-Tests. Jetzt ist ein guter Zeitpunkt, um die Qualitätsrichtlinien für Apps und die Best Practices für Tests durchzulesen.

Installiere zum Testen deine aktuell veröffentlichte App auf einem Gerät mit Android 13 und erledige alle Abläufe und Funktionen, während du nach Problemen suchst. 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.

Überprüfe und teste außerdem 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 hervorheben, und verwenden Sie die StrictMode-Methode detectNonSdkApiUsage(), um sie programmatisch abzufangen.

Zuletzt solltest du die Bibliotheken und SDKs in deiner App vollständig testen, damit sie wie erwartet unter Android 13 funktionieren und die Best Practices für Datenschutz, Leistung, UX, Datenverarbeitung und Berechtigungen befolgen. Falls ein Problem auftritt, aktualisieren Sie das SDK auf die neueste Version oder wenden Sie sich an den SDK-Entwickler.

Wenn du die Tests abgeschlossen und Aktualisierungen vorgenommen hast, empfehlen wir dir, deine kompatible App sofort zu veröffentlichen. So können deine Nutzer die App frühzeitig testen und eine reibungslose Umstellung für sie bei der Aktualisierung auf Android 13 gewährleisten.

Ausrichtung der App aktualisieren und neue APIs verwenden

Nachdem du eine kompatible Version deiner App veröffentlicht hast, besteht der nächste Schritt darin, Android 13 vollständig zu unterstützen. Dazu musst du die targetSdkVersion aktualisieren und die neuen APIs und Funktionen in Android 13 nutzen. Du kannst diese Änderungen vornehmen, sobald du bereit bist. Beachte dabei die Google Play-Anforderungen für die Ausrichtung auf die neue Plattform.

Bevor Sie eine vollständige Unterstützung von Android 13 planen, sollten Sie sich die Verhaltensänderungen ansehen, die sich auf Apps auswirken, die auf Android 13 ausgerichtet sind. Diese zielgerichteten Verhaltensänderungen können zu Funktionsproblemen führen, die Sie dann beheben müssen. In einigen Fällen erfordern diese Änderungen eine umfassende Weiterentwicklung. Daher empfehlen wir, sich so früh wie möglich darüber zu informieren und sie zu beheben. Wenn Sie bestimmte Verhaltensänderungen ermitteln möchten, die sich auf Ihre App auswirken, testen Sie Ihre App mithilfe der Kompatibilitäts-Ein/Aus-Schaltfläche mit aktivierten ausgewählten Änderungen.

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

Android 13 SDK herunterladen

Installiere die neueste Version der Android Studio-Vorschau, um Builds mit Android 13 zu erstellen. Du benötigst ein Android 13-Gerät oder einen Emulator.
Aktualisieren Sie Ihre targetSdkVersion- und andere Build-Konfigurationen.

Änderungen im Verhalten überprüfen

Sehen Sie sich die Verhaltensänderungen für Apps an, die auf Android 13 ausgerichtet sind. Ermittle Bereiche, in denen deine App betroffen sein könnte, und plane, wie du sie unterstützen kannst.

Datenschutzänderungen prüfen

Code- und Architekturänderungen vornehmen, die zur Unterstützung der Änderungen am Datenschutz für Nutzer 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 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 App auswirken könnten. Testen Sie Funktionen, die neue APIs nutzen. Geben Sie Feedback zu Plattform und API. Probleme mit Plattform, APIs oder SDKs von Drittanbietern melden

Letzte Aktualisierung

Sobald die Android 13 APIs fertig sind, aktualisieren Sie Ihre targetSdkVersion und andere Build-Konfigurationen noch einmal, nehmen Sie zusätzliche Aktualisierungen vor und testen Sie Ihre App.

Veröffentlichen

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

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 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, sollten Sie testen, ob die App bei der 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.

Wie bei einfachen Kompatibilitätstests solltest du alle Abläufe und Funktionen durchgehen, um nach Problemen zu suchen. Konzentrieren Sie sich bei Ihren Tests auf die Änderungen im Verhalten von 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.

Sehen Sie sich die Verwendung von eingeschränkten Nicht-SDK-Schnittstellen an, die möglicherweise zutreffen, und testen Sie sie. Achten Sie auf Logcat-Warnungen, die diese Zugriffe hervorheben, und verwenden Sie die StrictMode-Methode detectNonSdkApiUsage(), um sie programmatisch abzufangen.

Zuletzt solltest du die Bibliotheken und SDKs in deiner App vollständig testen, damit sie wie erwartet unter Android 13 funktionieren und die Best Practices für Datenschutz, Leistung, UX, Datenverarbeitung und Berechtigungen befolgen. Falls 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 Ein-/Aus-Schaltflächen für die Kompatibilität, mit denen du deine App mit gezielten Verhaltensänderungen einfacher testen kannst. Bei Debug-fähigen Apps 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 die Aktivierung bestimmter gezielter Verhaltensänderungen erzwingen, um die Auswirkungen auf Ihre vorhandene Anwendung zu bewerten.
  • Konzentrieren Sie sich beim Testen ausschließlich auf bestimmte Änderungen. Mit den Ein-/Aus-Schaltflächen können Sie alle Zieländerungen deaktivieren, mit Ausnahme derer, die Sie testen möchten.
  • Ein/Aus-Schaltfläche über ADB verwalten Mit ADB-Befehlen können Sie die ein- und ausschaltbaren Änderungen in Ihrer automatisierten Testumgebung aktivieren und deaktivieren.
  • Beschleunigen Sie die Fehlerbehebung mit Standard-Änderungs-IDs. 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 Ihnen bei der Vorbereitung auf eine Änderung des Targetings Ihrer App oder bei der Entwicklung der Unterstützung für Android 13 helfen. Weitere Informationen finden Sie unter Änderungen am Kompatibilitäts-Framework (Android 13).