Änderungen am Kompatibilitäts-Framework (Android 11)

Auf dieser Seite werden alle Verhaltensänderungen beschrieben, die sich auf Apps auswirken und dem Kompatibilitäts-Framework in Android 11 (API-Ebene 30) hinzugefügt wurden. Verwenden Sie diese Liste in Verbindung mit den Entwickleroptionen und ADB-Befehlen, um Ihre App zu testen und zu debuggen, während Sie sich auf Android 11 vorbereiten.

ADD_CONTENT_OBSERVER_FLAGS

Änderungs-ID: 150939131

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Für Apps, die auf Android 11 ausgerichtet sind, gibt es eine neue öffentliche API-Überladung onChange(boolean, Uri, int), die ein ganzzahliges flags-Argument enthält.

Diese neue Methode ist eine öffentliche SDK-Alternative für Apps, die die nicht-SDK-überladene Methode onChange() mit einem Ganzzahlargument userId verwenden.

ADMIN_APP_PASSWORD_COMPLEXITY

Änderungs-ID: 123562444

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Bei Administrator-Apps, die auf Android 11 ausgerichtet sind, muss ein Fehler ausgegeben werden, wenn eine App eine Passwortanforderungen festlegt, die für die aktuell zugewiesene Passwortqualität nicht relevant ist. Wenn die Passwortqualität beispielsweise auf DevicePolicyManager.PASSWORD_QUALITY_UNSPECIFIED festgelegt ist, kann eine App keine Mindestpasswortlänge festlegen. In diesem Fall sollte die App, bevor sie versucht, die Mindestpasswortlänge festzulegen, zuerst die Methode setPasswordQuality() und dann die Methode setPasswordMinimumLength() aufrufen.

Wenn eine Administrator-App, die auf Android 11 ausgerichtet ist, die Passwortqualität senkt, werden alle vorhandenen Passwortanforderungen, die nicht mehr gelten, auf die Standardwerte zurückgesetzt.

APP_DATA_DIRECTORY_ISOLATION

Änderungs-ID: 143937733

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Apps, die auf Android 11 ausgerichtet sind, können nicht mehr auf Dateien in privaten Datenverzeichnissen irgendeiner App zugreifen, unabhängig von der Ziel-SDK-Version der anderen App.

Weitere Informationen finden Sie unter Zugriff auf private Verzeichnisse.

APN_READING_PERMISSION_CHANGE_ID

Änderungs-ID: 124107808

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Für Apps, die auf Android 11 ausgerichtet sind, ist für den Zugriff auf die APN-Datenbank jetzt die Berechtigung Manifest.permission.WRITE_APN_SETTINGS erforderlich.

Weitere Informationen zu dieser Änderung finden Sie unter Eingeschränkter Lesezugriff auf die APN-Datenbank.

BACKGROUND_RATIONALE_CHANGE_ID

Änderungs-ID: 147316723

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Apps müssen jetzt jedes Mal einen gültigen Grund angeben, wenn sie im Hintergrund Zugriff auf den Standort des Geräts anfordern.

Weitere Informationen zu dieser Änderung finden Sie in der Anleitung zum Zugriff auf den Standort im Hintergrund in Android 11. Dort werden auch die Datenschutzänderungen im Zusammenhang mit dem Standort in Android 11 erläutert.

CALLBACK_ON_CLEAR_CHANGE

Änderungs-ID: 119147584

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Jedes Mal, wenn Editor.clear aufgerufen wird, wird jetzt ein Rückruf an OnSharedPreferenceChangeListener.onSharedPreferenceChanged mit einem null-Schlüssel gesendet.

Weitere Informationen zu dieser Änderung finden Sie unter Änderungen am Rückruf für OnSharedPreferenceChangeListener.

CALLBACK_ON_MORE_ERROR_CODE_CHANGE

Änderungs-ID: 130595455

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Die Fehlercodes wurden jetzt für updateAvailableNetworks(List, Executor, Consumer) und setPreferredOpportunisticDataSubscription(int, boolean, Executor, Consumer) erweitert.

CALL_BACK_ON_CHANGED_LISTENER_WITH_SWITCHED_OP_CHANGE

Änderungs-ID: 148180766

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Dies ist eine kleine Verhaltensänderung bei startWatchingMode(String, String, AppOpsManager.OnOpChangedListener). Vor dieser Änderung wurde das System für die umgeleitete Operation zurückgerufen. Nach der Änderung wird das System für die tatsächlich angeforderte Operation oder für alle umgeleiteten Operationen zurückgerufen, wenn keine Operation angegeben ist.

CAMERA_MICROPHONE_CAPABILITY_CHANGE_ID

Änderungs-ID: 136219221

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Bei Apps, die für Android 11 bestimmt sind, erhalten Dienste im Vordergrund nur Kamera- und Mikrofonfunktionen, während sie verwendet werden, wenn die R.attr.foregroundServiceType in der Manifestdatei als ServiceInfo.FOREGROUND_SERVICE_TYPE_CAMERA bzw. ServiceInfo.FOREGROUND_SERVICE_TYPE_MICROPHONE konfiguriert ist. In früheren Android-Versionen erhielten Dienste im Vordergrund automatisch Kamera- und Mikrofonfunktionen.

Weitere Informationen zu dieser Änderung finden Sie unter Arten von Diensten im Vordergrund unter Android 11.

CHANGE_BACKGROUND_CUSTOM_TOAST_BLOCK

ID der Änderung: 128611929

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Apps können keine benutzerdefinierten Benachrichtigungen mehr im Hintergrund posten. Apps können jedoch weiterhin Toasts mit der Methode Toast.makeText(Context, CharSequence, int) und ihren Varianten im Hintergrund posten.

Weitere Informationen zu dieser Änderung finden Sie unter Benutzerdefinierte Toast-Anzeigen werden blockiert.

CHANGE_RESTRICT_SAW_INTENT

Änderungs-ID: 135920175

Standardstatus: Diese Änderung kann nicht deaktiviert werden. Sie wird nur vom Kompatibilitäts-Framework protokolliert.

Bei Intents mit der Aktion android.settings.MANAGE_APP_OVERLAY_PERMISSION und dem Daten-URI-Schema package werden Nutzer nicht mehr zu einem app-spezifischen Bildschirm weitergeleitet, auf dem sie die zugehörige Berechtigung verwalten können. Stattdessen werden Nutzer zu einem Bildschirm weitergeleitet, auf dem sie alle Apps verwalten können, die die Berechtigung angefordert haben.

CHANGE_TEXT_TOASTS_IN_THE_SYSTEM

Änderungs-ID: 147798919

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Text-Toasts werden jetzt von der SystemUI statt innerhalb der App gerendert. So wird verhindert, dass Apps die Einschränkungen beim Posten benutzerdefinierter Toasts im Hintergrund umgehen.

DEFAULT_SCOPED_STORAGE

Änderungs-ID: 149924527

Standardstatus: Aktiviert für alle Apps.

Alle Apps, die auf Android 11 ausgerichtet sind, verwenden jetzt standardmäßig den speicherortspezifischen Speicher und können ihn nicht mehr deaktivieren.

Sie können Ihre App jedoch ohne Speicher mit begrenztem Zugriff testen, unabhängig von der Ziel-SDK-Version und den Manifest-Flag-Werten Ihrer App. Deaktivieren Sie dazu einfach diese Änderung.

Weitere Informationen zu den Änderungen am Speicher mit Begrenzung in Android 11 finden Sie auf der Seite zu den Änderungen am Android-Speicher in Android 11 im Abschnitt Speicher mit Begrenzung.

EMPTY_INTENT_ACTION_CATEGORY

Änderungs-ID: 151163173

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Bei Apps, die auf Android 11 ausgerichtet sind, löst das System jetzt einen Fehler aus, wenn action oder category eines Intent-Filters ein leerer String ist. Ein Fehler in der Plattform vor Android 11 ermöglichte es, dass dieser Fall ohne Fehlermeldung durchlief. Dies gilt nicht für den Fall, dass das Attribut null oder fehlt, da in diesem Fall immer ein Fehler auftritt.

FILTER_APPLICATION_QUERY

Änderungs-ID: 135549675

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Apps müssen jetzt die Pakete und Intents angeben, die sie verwenden möchten, bevor sie Details zu anderen Apps auf einem Gerät abrufen können. Solche Erklärungen müssen im Manifest der App mit dem <queries>-Tag erfolgen.

Weitere Informationen dazu, wie Sie in Android 11 andere installierte Apps abfragen und mit ihnen interagieren können, finden Sie auf der Datenschutzseite zur Paketsichtbarkeit.

FORCE_ENABLE_SCOPED_STORAGE

Änderungs-ID: Wert: 132649864

Standardstatus: Deaktiviert für alle Apps.

Alle Apps, die auf Android 11 ausgerichtet sind, verwenden jetzt standardmäßig den speicherortspezifischen Speicher und können ihn nicht mehr deaktivieren.

Wenn Ihre App jedoch weiterhin auf Android 10 (API-Level 29) oder niedriger ausgerichtet ist, können Sie sie mit beschränktem Speicherplatz testen, unabhängig von der Ziel-SDK-Version und den Manifest-Flag-Werten Ihrer App. Aktivieren Sie dazu einfach diese Änderung.

Weitere Informationen zu den Änderungen am Speicher mit Begrenzung in Android 11 finden Sie auf der Seite zu den Änderungen am Android-Speicher in Android 11 im Abschnitt Speicher mit Begrenzung.

GET_DATA_CONNECTION_STATE_R_VERSION

Änderungs-ID: 148535736

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

So prüfen Sie die SDK-Version für PreciseDataConnectionState#getDataConnectionState:

GET_DATA_STATE_R_VERSION

Änderungs-ID: 148534348

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

So prüfen Sie die SDK-Version für getDataState():

GET_PROVIDER_SECURITY_EXCEPTIONS

Änderungs-ID: 150935354

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Bei Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind, werden keine Sicherheitsausnahmen mehr geworfen. getProvider(String)

GET_TARGET_SDK_VERSION_CODE_CHANGE

Änderungs-ID: 145147528

Standardstatus: Aktiviert für Apps, die auf Android 10 (API-Level 29) oder höher ausgerichtet sind.

So prüfen Sie die SDK-Version für die SmsManager.sendResolverResult()-Methode:

GWP_ASAN

Änderungs-ID: 135634846

Standardstatus: Deaktiviert für alle Apps.

Aktiviert die Stichprobenerhebung von Fehlern im nativen Arbeitsspeicher in Apps.

Weitere Informationen zu dieser Änderung finden Sie im GWP-ASan-Leitfaden.

HIDE_MAXTARGETSDK_P_HIDDEN_APIS

Änderungs-ID: 149997251

Standardstatus: Aktiviert für Apps, die auf Android 10 (API-Level 29) oder höher ausgerichtet sind.

Bei Apps, die auf Android 10 (API-Level 29) oder höher ausgerichtet sind, wird der Zugriff auf alle nicht SDK-spezifischen Schnittstellen entfernt, die Teil der max-target-p (greylist-max-p)-Liste für Android 10 (API-Level 29) sind.

HIDE_MAXTARGETSDK_Q_HIDDEN_APIS

Änderungs-ID: 149994052

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Bei Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind, wird der Zugriff auf alle nicht SDK-spezifischen Schnittstellen entfernt, die Teil der max-target-q (greylist-max-q)-Liste für Android 11 (API-Level 30) sind.

Weitere Informationen zu dieser Änderung finden Sie unter Nicht-SDK-Schnittstellen, die jetzt in Android 11 blockiert sind.

LISTEN_CODE_CHANGE

Änderungs-ID: 147600208

Standardstatus: Aktiviert für Apps, die auf Android 10 (API-Level 29) oder höher ausgerichtet sind.

So prüfen Sie die SDK-Version für TelephonyManager.listen(PhoneStateListener, int):

MISSING_APP_TAG

Änderungs-ID: 150776642

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Bei Apps, die auf Android 11 ausgerichtet sind, wird jetzt ein Fehler ausgegeben, wenn in der Manifestdatei einer App das application- oder instrumentation-Tag fehlt.

NATIVE_HEAP_POINTER_TAGGING

Änderungs-ID: 135754954

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Bei Apps, die auf Android 11 ausgerichtet sind, haben native Heap-Zuweisungen jetzt ein Tag mit einem Wert ungleich 0 im höchstwertigen Byte.

Weitere Informationen finden Sie unter Heap-Pointer-Tagging.

PHONE_STATE_LISTENER_LIMIT_CHANGE_ID

Änderungs-ID: 150880553

Standardstatus: Aktiviert für alle Apps.

Bei Apps, die auf Android 11 ausgerichtet sind, ist die Anzahl der PhoneStateListener-Objekte, die ein Prozess über TelephonyManager.listen(PhoneStateListener, int) registrieren kann, jetzt begrenzt. Die Standardbegrenzung ist 50. Sie kann durch Updates der Remote-Gerätekonfiguration geändert werden. Dieses Limit wird mit einer IllegalStateException erzwungen, die von TelephonyManager.listen(PhoneStateListener, int) geworfen wird, wenn der betreffende Prozess versucht, einen zu vielen Listener zu registrieren.

PREVENT_META_REFLECTION_BLACKLIST_ACCESS

Änderungs-ID: 142365358

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Apps, die auf Android 11 ausgerichtet sind, können nicht mehr eine zusätzliche Reflexionsebene verwenden, um auf eingeschränkte Nicht-SDK-Schnittstellen zuzugreifen.

PROCESS_CAPABILITY_CHANGE_ID

Änderungs-ID: 136274596

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Bei Apps, die auf Android 11 ausgerichtet sind, kann das Flag Context.BIND_INCLUDE_CAPABILITIES jetzt verwendet werden, um Funktionen, die gerade verwendet werden, vom Clientprozess an einen gebundenen Dienst weiterzuleiten.

REMOVE_ANDROID_TEST_BASE

Änderungs-ID: 133396946

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Bei Apps, die auf Android 11 ausgerichtet sind, wurde die android.test.base-Bibliothek entfernt, wenn die App nicht von android.test.runner abhängig ist, da sie von Klassen aus der android.test.base-Bibliothek abhängig ist.

REQUEST_ACCESSIBILITY_BUTTON_CHANGE

Änderungs-ID: 136293963

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Für Bedienungshilfen, die auf Android 11 ausgerichtet sind, muss das Flag FLAG_REQUEST_ACCESSIBILITY_BUTTON jetzt in der Metadatendatei der Bedienungshilfe angegeben werden. Andernfalls wird das Flag ignoriert.

Weitere Informationen zu dieser Änderung finden Sie unter Verwendung der Schaltfläche „Bedienungshilfen“ in der Metadatendatei angeben.

RESOURCES_ARSC_COMPRESSED

Änderungs-ID: 132742131

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Apps, die auf Android 11 (API-Level 30) ausgerichtet sind, können nicht installiert werden, wenn sie eine komprimierte resources.arsc-Datei enthalten oder diese Datei nicht auf eine 4-Byte-Grenze ausgerichtet ist.

Weitere Informationen zu dieser Änderung finden Sie unter Komprimierte Ressourcendateien.

RESTRICT_STORAGE_ACCESS_FRAMEWORK

Änderungs-ID: 141600225

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Wenn Ihre App auf Android 11 ausgerichtet ist und das Storage Access Framework (SAF) verwendet, können Sie nicht mehr über die Intent-Aktionen ACTION_OPEN_DOCUMENT und ACTION_OPEN_DOCUMENT_TREE auf bestimmte Verzeichnisse zugreifen. Weitere Informationen zu diesen Änderungen finden Sie auf der Seite zu den Datenschutzaktualisierungen im Zusammenhang mit dem Speicher in Android 11 im Abschnitt Einschränkungen für den Dokumentzugriff.

SELINUX_LATEST_CHANGES

Änderungs-ID: 143539591

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Durch diese Änderung wird der Zugriff von Apps auf die SELinux-Domain „untrusted_app_R-targetSDk“ eingeschränkt. Dies ist eine der grundlegenden Änderungen am Kompatibilitäts-Framework, die es Apps ermöglicht, andere Änderungen zu aktivieren, die durch targetSdkVersion eingeschränkt sind, ohne die targetSDKVersion der App zu ändern. Aus diesem Grund sollten Sie diese Änderung für eine App, die auf Android 11 ausgerichtet ist, nicht deaktivieren. Andernfalls funktioniert die App nicht.

Diese Änderung hat keine Auswirkungen auf Apps, die eine gemeinsame Nutzer-ID verwenden.

THROW_SECURITY_EXCEPTIONS

Änderungs-ID: 147340954

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

Vor Android 11 wurde SecurityException nur von setEnabled APIs bei einem Berechtigungsfehler geworfen. Unter Android 11 ist das nicht mehr der Fall. Ein SecurityException kann aus einer Vielzahl von Gründen ausgelöst werden, die dem Aufrufer nicht angezeigt werden.

Um das bestehende API-Verhalten beizubehalten, wird bei einem Fehler bei der alten Berechtigung oder bei der Durchsetzung von Akteuren für eine App, die nicht auf Android 11 ausgerichtet ist, die Ausnahme in eine IllegalStateException gezwungen, die vor Android 11 in der Quelle vorhanden war.

USE_SET_LOCATION_ENABLED

Änderungs-ID: 117835097

Standardstatus: Aktiviert für Apps, die auf Android 11 (API-Level 30) oder höher ausgerichtet sind.

In Administrator-Apps, die auf Android 11 ausgerichtet sind, kann die Einstellung Settings.Secure.LOCATION_MODE nicht mehr über DevicePolicyManager.setSecureSetting(ComponentName, String, String) geändert werden. Stattdessen sollte DevicePolicyManager.setLocationEnabled(ComponentName, boolean) verwendet werden.