Apps zu Android 14 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 14 sorgt.

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 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 umfasst zwei Phasen, die parallel ablaufen können:

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

Kompatibilität mit Android 14

Es ist wichtig, die Funktionalität deiner vorhandenen App mit Android 14 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, 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 14 installieren

Flashen Sie ein Android 14-System-Image auf Ihr Gerät oder laden Sie ein System-Image 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

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 erforderlich sind, um sich an Verhaltensänderungen anzupassen oder Probleme zu beheben. Kompilieren Sie die App mit derselben API-Ebene neu, auf die Ihre App ursprünglich ausgerichtet war. Sie müssen nicht auf Android 14 ausgerichtet sein.

Veröffentlichen

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

Kompatibilitätstests durchführen

Der Test der Kompatibilität mit Android 14 ähnelt größtenteils normalen App-Tests. Sehen Sie sich die Qualitätsrichtlinien für Apps und die Best Practices für Tests noch einmal an.

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

Prüfe und teste die Verwendung von eingeschränkten Nicht-SDK-Schnittstellen. 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.

Prüfen Sie abschließend die Bibliotheken und SDKs in Ihrer App, um sicherzustellen, dass sie unter Android 14 wie erwartet funktionieren und den Best Practices für Datenschutz, Leistung, UX, Datenhandhabung und Berechtigungen entsprechen. Falls 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 14 aktualisieren.

Ausrichtung der App aktualisieren und neue APIs verwenden

Nachdem Sie eine kompatible Version Ihrer App veröffentlicht haben, ist der nächste Schritt die vollständige Unterstützung von Android 14. Aktualisieren Sie dazu die targetSdkVersion und nutzen Sie die neuen APIs und Funktionen von Android 14. 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.

Bevor Sie eine vollständige Unterstützung von Android 14 planen, sollten Sie sich die Verhaltensänderungen ansehen, die sich auf Apps auswirken, die auf Android 14 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 eine umfassende Weiterentwicklung. Daher empfehlen wir, sich so früh wie möglich darüber zu informieren und sie zu beheben. 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 14 vollständig unterstützen.

Android 14 SDK herunterladen

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

Änderungen am Nutzerverhalten überprüfen

Hier finden Sie Informationen zu den Verhaltensänderungen, die für Apps gelten, die auf Android 14 ausgerichtet sind. Ermittle Bereiche, in denen deine App betroffen sein könnte, und plane, wie du sie unterstützen kannst.

Datenschutzänderungen prüfen

Nehmen Sie Code- und Architekturänderungen vor, die für die Unterstützung der Änderungen am Datenschutz für Nutzer in Android 14 erforderlich sind.

Android 14-Funktionen verwenden

Nutzen Sie Android 14 APIs, um neue Funktionen in Ihre Apps zu bringen. Kompilieren Sie die App noch einmal für Android 14.

Testen

Auf einem Android 14-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 verwenden. Geben Sie Feedback zur Plattform und API. Melden Sie alle Probleme mit Plattformen, APIs oder Drittanbieter-SDKs.

Letzte Aktualisierung

Sobald die Android 14 APIs fertig sind, aktualisieren Sie Ihre targetSdkVersion und andere Build-Konfigurationen noch einmal, nehmen Sie alle erforderlichen Updates 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 14 testen möchten, laden Sie mit der neuesten Vorabversion von Android Studio das Android 14 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 14-App testen

Nachdem Sie die App kompiliert und auf einem Gerät mit Android 14 installiert haben, können Sie mit dem Testen beginnen, um sicherzustellen, dass die App bei Ausrichtung auf Android 14 ordnungsgemäß funktioniert. Einige Verhaltensänderungen gelten nur, wenn Ihre App auf die neue Plattform ausgerichtet ist. Sie sollten sich diese Änderungen 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 Änderungen im Verhalten von Apps, die auf Android 14 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.

Zuletzt solltest du die Bibliotheken und SDKs in deiner App vollständig testen, damit sie wie erwartet unter Android 14 funktionieren und die Best Practices für Datenschutz, Leistung, UX, Datenverarbeitung und Berechtigungen befolgen. 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 14 enthält Kompatibilitätsschalter, mit denen Sie Ihre App einfacher mit gezielten Verhaltensänderungen 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 gezielten Änderungen auf einmal zu bearbeiten, können Sie mit den Ein-/Aus-Schaltflächen alle ausgerichteten Änderungen deaktivieren, mit Ausnahme derer, 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 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 Ihnen dabei helfen, das Targeting Ihrer App zu ändern oder die Unterstützung von Android 14 zu entwickeln. Weitere Informationen finden Sie unter Änderungen am Kompatibilitäts-Framework (Android 14).