Apps zu Android 14 migrieren

In diesem Dokument finden Sie eine allgemeine Übersicht über typische 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 Ihren Nutzern unter Android 14 eine optimale Nutzererfahrung bietet.

Mit jeder Android-Version führen wir neue Funktionen und Verhaltensänderungen ein, um Android noch hilfreicher, sicherer und leistungsstärker zu machen. 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 für das Open-Source-Projekt für Android (AOSP) veröffentlicht wird. Daher ist es wichtig, dass Ihre Apps bereit sind, wie erwartet funktionieren und idealerweise die neuen Funktionen und APIs nutzen, um das Beste aus der neuen Plattform herauszuholen.

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

  • App-Kompatibilität sicherstellen (bis zur endgültigen Version von Android 14)
  • Auf die neuen Plattformfunktionen und APIs ausrichten (so bald wie möglich nach der endgültigen Version)

Kompatibilität mit Android 14 sicherstellen

Es ist wichtig, die Funktionalität Ihrer bestehenden App mit Android 14 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. Dies 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 14 herunterladen

Flashen Sie ein Android 14-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 ermitteln, in denen Ihre App möglicherweise betroffen ist.

Test

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.

Aktualisieren

Nehmen Sie nur die Codeänderungen vor, die erforderlich sind, um sich an Verhaltens änderungen anzupassen oder Probleme zu beheben. Kompilieren Sie mit demselben API-Level auf das Ihre App ursprünglich ausgerichtet war. Es ist nicht erforderlich, auf Android 14 auszurichten.

Veröffentlichen

Signieren, laden Sie Ihr aktualisiertes Android App Bundle oder APK hoch und veröffentlichen Sie es.

Kompatibilitätstests durchführen

Im Großen und Ganzen ähnelt das Testen der Kompatibilität mit Android 14 dem normalen App-Testen. Dies ist ein guter Zeitpunkt, um die Qualitätsrichtlinien für Apps und die Best Practices für Tests zu prüfen.

Installieren Sie zum Testen Ihre aktuelle veröffentlichte App auf einem Gerät mit Android 14 und arbeiten Sie alle Abläufe und Funktionen durch, um nach Problemen zu suchen. Um Ihnen die Tests zu erleichtern, prüfen Sie die Verhaltensänderungen für alle Apps , die in Android 14 eingeführt wurden und sich auf die Funktionsweise Ihrer App auswirken oder zum Absturz führen können.

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

Testen Sie schließlich die Bibliotheken und SDKs in Ihrer App vollständig, um sicherzustellen, dass sie unter Android 14 wie erwartet funktionieren und die Best Practices für Datenschutz, Leistung, Nutzerfreundlichkeit, Datenverarbeitung und Berechtigungen eingehalten werden. Wenn Sie ein Problem finden, versuchen Sie, auf die neueste Version des SDK zu aktualisieren, oder wenden Sie sich an den SDK-Entwickler.

Wenn Sie mit dem Testen fertig sind und alle Updates vorgenommen haben, empfehlen wir Ihnen, Ihre kompatible App sofort zu veröffentlichen. So können Ihre Nutzer die App frühzeitig testen und ein reibungsloser Übergang für Ihre Nutzer wird sichergestellt, wenn sie auf Android 14 aktualisieren.

Ausrichtung der App aktualisieren und mit neuen APIs erstellen

Nachdem Sie eine kompatible Version Ihrer App veröffentlicht haben, besteht der nächste Schritt darin, die vollständige Unterstützung für Android 14 hinzuzufügen, indem Sie die targetSdkVersion aktualisieren und die neuen APIs und Funktionen in Android 14 nutzen. Sie können diese Updates vornehmen, sobald Sie bereit sind. Beachten Sie dabei die Google Play-Anforderungen für die Ausrichtung auf die neue Plattform.

Wenn Sie die vollständige Unterstützung für Android 14 planen, prüfen Sie die Verhaltensänderungen, die sich auf Apps auswirken, die auf Android 14 ausgerichtet sind. Diese zielgerichteten Verhaltensänderungen können zu funktionalen Problemen führen, die Sie beheben müssen. In einigen Fällen erfordern diese Änderungen erhebliche Entwicklungsarbeit. Daher empfehlen wir, sich so früh wie möglich damit zu befassen und sie zu beheben. Um bestimmte Verhaltensänderungen zu ermitteln, die sich auf Ihre App auswirken, verwenden Sie die Kompatibilitätsschalter, um Ihre App mit ausgewählten aktivierten Änderungen zu testen.

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. Achten Sie darauf, dass Sie ein Android 14-Gerät oder einen Emulator haben.
Aktualisieren Sie Ihre targetSdkVersion und andere Build Konfigurationen.

Verhaltensänderungen prüfen

Prüfen Sie die Verhaltensänderungen, die für Apps gelten, die auf Android 14 ausgerichtet sind. Ermitteln Sie Bereiche, in denen Ihre App möglicherweise betroffen ist, und planen Sie, wie Sie sie unterstützen können.

Auf neue Datenschutzänderungen prüfen

Nehmen Sie die Code- und Architekturänderungen vor, die erforderlich sind, um die Änderungen am Datenschutz für Nutzer in Android 14's zu unterstützen.

Android 14-Funktionen übernehmen

Nutzen Sie die Android 14-APIs, um Ihren Apps neue Funktionen und Funktionen hinzuzufügen. Kompilieren Sie für Android 14 neu.

Test

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

Letztes Update

Sobald die Android 14-APIs endgültig sind, aktualisieren Sie Ihre targetSdkVersion und andere Build-Konfigurationen noch einmal, nehmen Sie alle zusätzlichen Updates vor und testen Sie Ihre App.

Veröffentlichen

Signieren, laden Sie Ihr aktualisiertes Android App Bundle oder APK hoch und veröffentlichen Sie es.

SDK herunterladen, Ausrichtung ändern, mit neuen APIs entwickeln

Um mit dem Testen der vollständigen Android 14-Unterstützung zu beginnen, laden Sie mit der neuesten Vorabversion von Android Studio das Android 14 SDK und alle anderen erforderlichen Tools herunter. Aktualisieren Sie dann die targetSdkVersion und compileSdkVersion Ihrer App und kompilieren Sie die App neu. Weitere Informationen finden Sie im SDK-Einrichtungsleitfaden für Details.

Android 14-App testen

Nachdem Sie die App kompiliert und auf einem Gerät mit Android 14 installiert haben, testen Sie, ob die App ordnungsgemäß funktioniert, wenn sie auf Android 14 ausgerichtet ist. Einige Verhaltensänderungen gelten nur, wenn Ihre App auf die neue Plattform ausgerichtet ist. Daher sollten Sie sich dieseÄnderungen ansehen, bevor Sie beginnen.

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

Prüfen Sie, ob eingeschränkte Nicht-SDK-Schnittstellen verwendet werden, und testen Sie diese. Achten Sie auf Logcat-Warnungen, die auf diese Zugriffe hinweisen, und verwenden Sie die StrictMode-Methode detectNonSdkApiUsage(), um sie programmatisch zu erfassen.

Testen Sie schließlich die Bibliotheken und SDKs in Ihrer App vollständig, um sicherzustellen, dass sie unter Android 14 wie erwartet funktionieren und die Best Practices für Datenschutz, Leistung, Nutzerfreundlichkeit, Datenverarbeitung und Berechtigungen eingehalten werden. Wenn Sie ein Problem finden, versuchen Sie, auf die neueste Version des SDK zu aktualisieren, oder wenden Sie sich an den SDK-Entwickler.

Mit Kompatibilitätsschaltern für Apps testen

Android 14 enthält Kompatibilitätsschalter, mit denen Sie Ihre App einfacher mit zielgerichteten Verhaltensänderungen testen können. Bei einer debugfähigen App können Sie mit den Schaltern Folgendes tun:

  • Zielgerichtete Änderungen testen, ohne die targetSdkVersion der App tatsächlich zu ändern. Mit den Schaltern können Sie bestimmte zielgerichtete Verhaltensänderungen zwingend aktivieren, um die Auswirkungen auf Ihre bestehende App zu bewerten.
  • Tests nur auf bestimmte Änderungen konzentrieren. Anstatt alle zielgerichteten Änderungen gleichzeitig zu beheben, können Sie mit den Schaltern alle zielgerichteten Änderungen deaktivieren, mit Ausnahme derjenigen, die Sie testen möchten.
  • Schalter über adb verwalten. Mit adb-Befehlen können Sie die änderbaren Änderungen in Ihrer automatisierten Testumgebung aktivieren und deaktivieren.
  • Schneller debuggen mit Standard-Änderungs-IDs. Änderbare Änderungen haben jeweils eine eindeutige ID und einen eindeutigen Namen, mit denen Sie die Ursache in der Logausgabe schnell debuggen können.

Die Schalter können hilfreich sein, wenn Sie die Ausrichtung Ihrer App ändern oder aktiv an der Unterstützung für Android 14 arbeiten. Weitere Informationen finden Sie unter Änderungen am Kompatibilitätsframework (Android 14).