Изменения в системе совместимости (Android 11)

На этой странице описаны все изменения в поведении приложений, которые были добавлены в платформу совместимости в Android 11 (уровень API 30). Используйте этот список вместе с параметрами разработчика и командами ADB для тестирования и отладки вашего приложения при подготовке к работе с Android 11.

ADD_CONTENT_OBSERVER_FLAGS

Идентификатор изменения : 150939131

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Для приложений, ориентированных на Android 11, существует новая перегрузка общедоступного API onChange(boolean, Uri, int) , которая включает аргумент целочисленных flags .

Этот новый метод является общедоступной альтернативой SDK для приложений, которые используют перегруженный метод onChange() не входящий в состав SDK, который включает в себя целочисленный аргумент userId .

ADMIN_APP_PASSWORD_COMPLEXITY

Идентификатор изменения : 123562444

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Для приложений администратора, ориентированных на Android 11, выдавайте ошибку всякий раз, когда приложение устанавливает требование к паролю, которое не соответствует текущему назначенному качеству пароля. Например, если для качества пароля установлено значение DevicePolicyManager.PASSWORD_QUALITY_UNSPECIFIED , приложение не сможет установить минимальную длину пароля. В этом случае, прежде чем пытаться установить минимальную длину пароля, приложение должно сначала вызвать метод setPasswordQuality() и только потом вызывать метод setPasswordMinimumLength() .

Кроме того, когда приложение администратора, предназначенное для Android 11, снижает качество пароля, все существующие требования к паролю, которые больше не применяются, сбрасываются до значений по умолчанию.

APP_DATA_DIRECTORY_ISOLATION

Идентификатор изменения : 143937733

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Приложения, предназначенные для Android 11, больше не могут получать доступ к файлам в каталогах личных данных любого приложения, независимо от целевой версии SDK другого приложения.

Дополнительную информацию см. в разделе Доступ к частным каталогам .

APN_READING_PERMISSION_CHANGE_ID

Идентификатор изменения : 124107808

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Для приложений, ориентированных на Android 11, для доступа к базе данных APN теперь требуется разрешение Manifest.permission.WRITE_APN_SETTINGS .

Дополнительные сведения об этом изменении см. в разделе Ограниченный доступ на чтение к базе данных APN .

BACKGROUND_RATIONALE_CHANGE_ID

Идентификатор изменения : 147316723

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Приложения теперь должны предоставлять веское обоснование каждый раз, когда они запрашивают доступ к местоположению устройства в фоновом режиме.

Чтобы узнать больше об этом изменении, ознакомьтесь с руководством по доступу к фоновому местоположению в Android 11 , в котором обсуждаются изменения конфиденциальности, связанные с местоположением, в Android 11.

CALLBACK_ON_CLEAR_CHANGE

Идентификатор изменения : 119147584

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

При каждом вызове Editor.clear теперь выполняется обратный вызов OnSharedPreferenceChangeListener.onSharedPreferenceChanged с null ключом.

Дополнительные сведения об этом изменении см. в разделе Изменения обратного вызова для OnSharedPreferenceChangeListener .

CALLBACK_ON_MORE_ERROR_CODE_CHANGE

Идентификатор изменения : 130595455

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Коды ошибок теперь расширены для updateAvailableNetworks(List, Executor, Consumer) и setPreferredOpportunisticDataSubscription(int, boolean, Executor, Consumer) .

CALL_BACK_ON_CHANGED_LISTENER_WITH_SWITCHED_OP_CHANGE

Идентификатор изменения : 148180766

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Это небольшое изменение поведения startWatchingMode(String, String, AppOpsManager.OnOpChangedListener) . Перед этим изменением система перезвонила для переключенной операции. После изменения система перезвонит для фактически запрошенной операции или всех включенных операций, если операция не указана.

CAMERA_MICROPHONE_CAPABILITY_CHANGE_ID

Идентификатор изменения : 136219221

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Для приложений, предназначенных для Android 11, службы переднего плана получают возможности камеры и микрофона во время использования только тогда, когда R.attr.foregroundServiceType настроен как ServiceInfo.FOREGROUND_SERVICE_TYPE_CAMERA и ServiceInfo.FOREGROUND_SERVICE_TYPE_MICROPHONE соответственно в файле манифеста. В более ранних версиях Android службы переднего плана автоматически получали возможности камеры и микрофона.

Дополнительные сведения об этом изменении см. в разделе Типы служб переднего плана в Android 11 .

CHANGE_BACKGROUND_CUSTOM_TOAST_BLOCK

Идентификатор изменения : 128611929

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Приложения больше не могут публиковать персонализированные тосты в фоновом режиме. Однако приложения по-прежнему могут публиковать всплывающие уведомления с помощью метода Toast.makeText(Context, CharSequence, int) и его вариантов в фоновом режиме.

Дополнительные сведения об этом изменении см. в разделе Пользовательские всплывающие уведомления заблокированы .

CHANGE_RESTRICT_SAW_INTENT

Идентификатор изменения : 135920175

Состояние по умолчанию : это изменение невозможно переключить. Это регистрируется только платформой совместимости.

Намерения, использующие действие android.settings.MANAGE_APP_OVERLAY_PERMISSION и схему URI данных package больше не направляют пользователя на экран конкретного приложения для управления связанными разрешениями. Вместо этого пользователь перенаправляется на экран, где он может управлять всеми приложениями, запросившими разрешение.

CHANGE_TEXT_TOASTS_IN_THE_SYSTEM

Идентификатор изменения : 147798919

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Текстовые всплывающие уведомления теперь отображаются с помощью SystemUI, а не в приложении. Это не позволяет приложениям обходить ограничения на публикацию пользовательских всплывающих уведомлений в фоновом режиме.

DEFAULT_SCOPED_STORAGE

Идентификатор изменения : 149924527

Состояние по умолчанию : включено для всех приложений.

Все приложения, предназначенные для Android 11, теперь по умолчанию используют хранилище с ограниченной областью и больше не могут отказаться от него .

Однако вы можете протестировать свое приложение без ограниченного хранилища, независимо от целевой версии SDK вашего приложения и значений флага манифеста, отключив это изменение.

Чтобы узнать больше об изменениях в хранилище с ограниченной областью в Android 11, см. раздел Хранилище с ограниченной областью на странице об изменениях в хранилище Android в Android 11.

EMPTY_INTENT_ACTION_CATEGORY

Идентификатор изменения : 151163173

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Для приложений, ориентированных на Android 11, система теперь выдает ошибку, если action или category фильтра намерений представляет собой пустую строку. Ошибка в платформе до Android 11 позволяла пройти этот случай без выдачи ошибки. Обратите внимание: сюда не входят случаи, когда атрибут имеет значение NULL или отсутствует, поскольку это всегда приводит к ошибке.

FILTER_APPLICATION_QUERY

Идентификатор изменения : 135549675

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Приложениям теперь необходимо объявить пакеты и намерения, которые они собираются использовать, прежде чем они смогут получить информацию о других приложениях на устройстве. Такие объявления должны быть сделаны с использованием тега <queries> в манифесте приложения.

Чтобы узнать больше о том, как запрашивать другие установленные приложения и взаимодействовать с ними в Android 11, посетите страницу конфиденциальности видимости пакетов .

FORCE_ENABLE_SCOPED_STORAGE

Идентификатор изменения : Значение: 132649864.

Состояние по умолчанию : отключено для всех приложений.

Все приложения, предназначенные для Android 11, теперь по умолчанию используют хранилище с ограниченной областью и больше не могут отказаться от использования хранилища с ограниченной областью .

Однако если ваше приложение по-прежнему предназначено для Android 10 (уровень API 29) или ниже, вы можете протестировать свое приложение с ограниченным хранилищем, независимо от целевой версии SDK вашего приложения и значений флага манифеста, включив это изменение.

Чтобы узнать больше об изменениях в хранилище с ограниченной областью в Android 11, см. раздел Хранилище с ограниченной областью на странице об изменениях в хранилище Android в Android 11.

GET_DATA_CONNECTION_STATE_R_VERSION

Идентификатор изменения : 148535736

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Чтобы проверить версию SDK для PreciseDataConnectionState#getDataConnectionState .

GET_DATA_STATE_R_VERSION

Идентификатор изменения : 148534348

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Чтобы проверить версию SDK для getDataState() .

GET_PROVIDER_SECURITY_EXCEPTIONS

Идентификатор изменения : 150935354

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Для приложений, ориентированных на Android 11 (уровень API 30) или выше, getProvider(String) больше не генерирует никаких исключений безопасности.

GET_TARGET_SDK_VERSION_CODE_CHANGE

Идентификатор изменения : 145147528

Состояние по умолчанию : включено для приложений, ориентированных на Android 10 (уровень API 29) или выше.

Чтобы проверить версию SDK для метода SmsManager.sendResolverResult() .

ГВП_АСАН

Идентификатор изменения : 135634846

Состояние по умолчанию : отключено для всех приложений.

Включает выборочное обнаружение ошибок встроенной памяти в приложениях.

Чтобы узнать больше об этом изменении, см. руководство GWP-ASan .

HIDE_MAXTARGETSDK_P_HIDDEN_APIS

Идентификатор изменения : 149997251

Состояние по умолчанию : включено для приложений, ориентированных на Android 10 (уровень API 29) или выше.

Для приложений, ориентированных на Android 10 (уровень API 29) или выше, удаляет доступ ко всем интерфейсам, не входящим в SDK, которые являются частью списка max-target-p ( greylist-max-p ) для Android 10 (уровень API 29).

HIDE_MAXTARGETSDK_Q_HIDDEN_APIS

Идентификатор изменения : 149994052.

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Для приложений, ориентированных на Android 11 (уровень API 30) или выше, удаляет доступ ко всем интерфейсам, отличным от SDK, которые являются частью списка max-target-q ( greylist-max-q ) для Android 11 (уровень API 30).

Чтобы узнать больше об этом изменении, ознакомьтесь с интерфейсами, не относящимися к SDK, которые теперь заблокированы в Android 11 .

LISTEN_CODE_CHANGE

Идентификатор изменения : 147600208

Состояние по умолчанию : включено для приложений, ориентированных на Android 10 (уровень API 29) или выше.

Чтобы проверить версию SDK для TelephonyManager.listen(PhoneStateListener, int) .

MISSING_APP_TAG

Идентификатор изменения : 150776642

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Для приложений, ориентированных на Android 11, теперь выдается ошибка, если в файле манифеста приложения отсутствует тег application или instrumentation .

NATIVE_HEAP_POINTER_TAGGING

Идентификатор изменения : 135754954

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Для приложений, ориентированных на Android 11, собственное распределение кучи теперь имеет ненулевой тег в самом значимом байте.

Дополнительные сведения см. в разделе Разметка указателей кучи .

PHONE_STATE_LISTENER_LIMIT_CHANGE_ID

Идентификатор изменения : 150880553

Состояние по умолчанию : включено для всех приложений.

Для приложений, ориентированных на Android 11, теперь существует ограничение на количество объектов PhoneStateListener которые любой процесс может зарегистрировать через TelephonyManager.listen(PhoneStateListener, int) . Ограничение по умолчанию — 50, которое может быть изменено при обновлении конфигурации удаленного устройства. Это ограничение обеспечивается с помощью исключения IllegalStateException создаваемого TelephonyManager.listen(PhoneStateListener, int) , когда процесс-нарушитель пытается зарегистрировать слишком много прослушивателей.

PREVENT_META_REFLECTION_BLACKLIST_ACCESS

Идентификатор изменения : 142365358

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Приложения, предназначенные для Android 11, больше не могут использовать дополнительный уровень отражения для доступа к интерфейсам, не входящим в SDK, которые ограничены.

PROCESS_CAPABILITY_CHANGE_ID

Идентификатор изменения : 136274596

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Для приложений, ориентированных на Android 11, флаг Context.BIND_INCLUDE_CAPABILITIES теперь можно использовать для передачи возможностей во время использования из клиентского процесса в связанную службу.

REMOVE_ANDROID_TEST_BASE

Идентификатор изменения : 133396946

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Для приложений, предназначенных для Android 11, библиотека android.test.base была удалена, если приложение не зависит от android.test.runner (поскольку оно зависит от классов из библиотеки android.test.base ).

REQUEST_ACCESSIBILITY_BUTTON_CHANGE

Идентификатор изменения : 136293963

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Для служб доступности, ориентированных на Android 11, флаг FLAG_REQUEST_ACCESSIBILITY_BUTTON теперь должен быть указан в файле метаданных службы доступности. В противном случае флаг игнорируется.

Дополнительные сведения об этом изменении см. в разделе «Объявление использования кнопки специальных возможностей в файле метаданных» .

RESOURCES_ARSC_COMPRESSED

Идентификатор изменения : 132742131

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Приложения, предназначенные для Android 11 (уровень API 30), невозможно установить, если они содержат сжатый файл resources.arsc или если этот файл не выровнен по 4-байтовой границе.

Дополнительные сведения об этом изменении см. в разделе Сжатые файлы ресурсов .

RESTRICT_STORAGE_ACCESS_FRAMEWORK

Идентификатор изменения : 141600225

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Если ваше приложение предназначено для Android 11 и использует Storage Access Framework (SAF) , вы больше не сможете получить доступ к определенным каталогам с помощью действий намерения ACTION_OPEN_DOCUMENT и ACTION_OPEN_DOCUMENT_TREE . Чтобы узнать больше об этих изменениях, см. раздел «Ограничения доступа к документам» на странице, где обсуждаются обновления конфиденциальности, связанные с хранилищем в Android 11.

SELINUX_LATEST_CHANGES

Идентификатор изменения : 143539591

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Это изменение ограничивает доступ приложений к домену untrusted_app_R-targetSDk SELinux. Это одно из фундаментальных изменений в платформе совместимости, которое позволяет приложениям переключать другие изменения, контролируемые targetSdkVersion без изменения targetSDKVersion своего приложения. По этой причине не следует отключать это изменение для приложения, предназначенного для Android 11, иначе приложение не будет работать.

Это изменение не повлияет на приложения, использующие общий идентификатор пользователя.

THROW_SECURITY_EXCEPTIONS

Идентификатор изменения : 147340954

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

До Android 11 исключение SecurityException вызывалось только API-интерфейсами setEnabled в случае ошибки разрешения. В Android 11 это уже не так, и SecurityException может быть выдано по любому количеству причин, ни одна из которых не известна вызывающей стороне.

Чтобы сохранить существующее поведение API, если для приложения, не предназначенного для Android 11, происходит сбой устаревшего разрешения или сбой принудительного применения субъекта, исключение принудительно преобразуется в IllegalStateException , существовавшее в источнике до Android 11.

USE_SET_LOCATION_ENABLED

Идентификатор изменения : 117835097

Состояние по умолчанию : включено для приложений, ориентированных на Android 11 (уровень API 30) или выше.

Приложения администратора, предназначенные для Android 11, больше не могут использовать DevicePolicyManager.setSecureSetting(ComponentName, String, String) для изменения устаревшего параметра Settings.Secure.LOCATION_MODE . Вместо этого им следует использовать DevicePolicyManager.setLocationEnabled(ComponentName, boolean) .