Apps zu Android 17 migrieren

In diesem Dokument finden Sie eine Übersicht über die Entwicklungs- und Testmaßnahmen, die Sie ergreifen können, um sich an den Zeitplan für die Veröffentlichung der Android-Plattform anzupassen und eine nahtlose Nutzererfahrung auf Android 17 zu gewährleisten.

Mit jeder Android-Version führen wir neue Funktionen und Verhaltensänderungen ein, um Android noch hilfreicher, sicherer und leistungsfähiger 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) freigegeben 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 besteht aus zwei Phasen, die gleichzeitig ablaufen können:

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

Kompatibilität mit Android 17 sicherstellen

Es ist wichtig, die Funktionalität Ihrer vorhandenen App mit Android 17 zu testen, um Nutzern, die auf die neueste Android-Version umsteigen, 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.

App auf Kompatibilität mit Android 17 testen

Im Großen und Ganzen ähnelt das Testen der Kompatibilität mit Android 17 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 17 und arbeiten Sie die Abläufe und Funktionen durch, um Probleme zu ermitteln. Um Ihre Tests zu konzentrieren, prüfen Sie die Verhaltensänderungen für alle Apps , die in Android 17 eingeführt wurden und sich auf die Funktionsweise Ihrer App auswirken oder zum Absturz Ihrer App 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 17 wie erwartet funktionieren und die Best Practices für Datenschutz, Leistung, Nutzererfahrung, 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 Updates vorgenommen haben, empfehlen wir, 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 ist gewährleistet, wenn sie auf Android 17 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 17 hinzuzufügen, indem Sie die targetSdkVersion aktualisieren und die neuen APIs und Funktionen in Android 17 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 17 planen, prüfen Sie die Verhaltensänderungen, die sich auf Apps auswirken, die auf Android 17 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.

Die folgenden Schritte beschreiben, wie Sie Android 17 vollständig unterstützen.

SDK herunterladen, Ausrichtung ändern, mit neuen APIs entwickeln

Um mit dem Testen der vollständigen Android 17-Unterstützung zu beginnen, laden Sie mit der neuesten Vorabversion von Android Studio das Android 17 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 Leitfaden zur SDK-Einrichtung für Details.

Android 17-App testen

Nachdem Sie die App kompiliert und auf einem Gerät mit Android 17 installiert haben, testen Sie, ob die App ordnungsgemäß funktioniert, wenn sie auf Android 17 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 und suchen nach Problemen. Konzentrieren Sie sich beim Testen auf die Verhaltensänderungen für Apps, die auf Android 17 ausgerichtet sind. Es ist auch 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 17 wie erwartet funktionieren und die Best Practices für Datenschutz, Leistung, Nutzererfahrung, 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 17 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 vorhandene 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. Sie können adb-Befehle verwenden, um die umschaltbaren Änderungen in Ihrer automatisierten Testumgebung zu aktivieren und zu deaktivieren.
• Schneller debuggen mit Standard-Änderungs-IDs. Umschaltbare Ä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 von Android 17 arbeiten. Weitere Informationen finden Sie unter Änderungen am Kompatibilitätsframework (Android 17).