API Android 5.0

Уровень API: 21

В Android 5.0 (LOLLIPOP) появились новые функции для пользователей и разработчиков приложений. В этом документе представлены наиболее важные новые API.

Если у вас есть опубликованное приложение, обязательно ознакомьтесь с изменениями в поведении Android 5.0, которые следует учитывать в приложении. Эти изменения могут повлиять на работу приложения на устройствах с Android 5.0, даже если вы не используете новые API или не ориентируетесь на новые функциональные возможности.

Обзор новых функций платформы можно найти в статье Android Lollipop.

Сайт для разработчиков

Чтобы начать разработку приложений для Android 5.0, сначала необходимо скачать Android SDK. Затем с помощью SDK Manager скачайте платформу Android 5.0 SDK и образы системы.

Обновите целевой уровень API

Чтобы оптимизировать приложение для устройств с Android 5.0, задайте для параметра targetSdkVersion значение "21", установите приложение на образ системы Android 5.0, протестируйте его и опубликуйте обновленную версию.

Вы можете использовать API Android 5.0, сохраняя поддержку более ранних версий. Для этого добавьте в код условия, которые проверяют уровень API системы перед выполнением API, не поддерживаемых вашим minSdkVersion. Подробнее о том, как обеспечить обратную совместимость…

Подробнее о том, что такое уровень API…

Важные изменения в работе

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

Подробную информацию вы найдете в статье Изменения в Android 5.0.

Пользовательский интерфейс

Поддержка Material Design

В Android 5.0 добавлена поддержка нового стиля Material Design. Вы можете создавать приложения с визуально динамичным дизайном Material Design и переходами между элементами интерфейса, которые кажутся пользователям естественными. В частности, мы:

  • Тематическое оформление Material Design
  • Посмотреть тени
  • Виджет "RecyclerView"
  • Анимация и стили для графических объектов
  • Анимация Material Design и эффекты перехода между действиями
  • Аниматоры для свойств представления на основе состояния представления
  • Настраиваемые виджеты интерфейса и панели приложений с цветовыми палитрами, которыми вы управляете.
  • Анимированные и неанимированные графические объекты на основе векторной графики XML.

Подробнее о том, как добавить функции Material Design в приложение…

Одновременный показ документов и действий на экране недавних приложений

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

Чтобы вставить логический разрыв, чтобы система рассматривала вашу активность как новую задачу, используйте FLAG_ACTIVITY_NEW_DOCUMENT при запуске активности с помощью startActivity(). Такого же поведения можно добиться, если в манифесте задать для атрибута documentLaunchMode элемента <activity> значение "intoExisting" или "always".

Чтобы не загромождать экран недавних приложений, вы можете задать максимальное количество задач из вашего приложения, которые могут отображаться на этом экране. Для этого задайте атрибут android:maxRecents в элементе <application>. Максимальное значение, которое можно указать, – 50 задач на пользователя (25 для устройств с небольшим объемом ОЗУ).

Задачи на экране недавних приложений можно настроить так, чтобы они сохранялись после перезагрузки. Чтобы управлять сохранением, используйте атрибут android:persistableMode. Вы также можете изменить визуальные свойства действия на экране недавних приложений, например цвет, ярлык и значок действия, вызвав метод setTaskDescription().

Обновления WebView

В Android 5.0 реализация WebView обновлена до Chromium M37, что повышает безопасность и стабильность, а также исправляет ошибки. В строку агента пользователя по умолчанию для WebView на Android 5.0 добавлен номер версии 37.0.0.0.

В этом выпуске представлен класс PermissionRequest, который позволяет приложению предоставлять разрешение WebView на доступ к защищенным ресурсам, таким как камера и микрофон, через веб-API, например getUserMedia(). Чтобы предоставить разрешения для WebView, у приложения должны быть соответствующие разрешения Android для этих ресурсов.

Новый метод onShowFileChooser() позволяет использовать поле ввода в WebView и запускать средство выбора файлов, чтобы выбирать изображения и файлы на устройстве Android.

Кроме того, в этом выпуске реализована поддержка открытых стандартов WebAudio, WebGL и WebRTC. Подробнее о новых функциях в этом выпуске читайте в статье WebView для Android.

Запись экрана и демонстрация экрана

Android 5.0 позволяет добавлять в приложение возможности записи и демонстрации экрана с помощью новых API android.media.projection. Эта функция полезна, например, если вы хотите включить демонстрацию экрана в приложении для видеоконференций.

Новый метод createVirtualDisplay() позволяет приложению записывать содержимое основного экрана (по умолчанию) в объект Surface, который затем можно передавать по сети. API позволяет записывать только незащищенный контент экрана, но не системное аудио. Чтобы начать запись экрана, приложение должно запросить разрешение пользователя. Для этого нужно запустить диалоговое окно записи экрана с помощью объекта Intent, полученного через метод createScreenCaptureIntent().

Пример использования новых API можно найти в классе MediaProjectionDemo в примере проекта.

Уведомления

Уведомления на заблокированном экране

На заблокированном экране в Android 5.0 могут показываться уведомления. Пользователи могут выбрать в настройках, разрешить ли показ конфиденциальных данных в уведомлениях на заблокированном экране.

Вы можете указать, какая информация будет видна в уведомлениях, когда устройство заблокировано. Чтобы настроить уровень видимости, вызовите метод setVisibility() и укажите одно из следующих значений:

  • VISIBILITY_PRIVATE – на экране блокировки будет показываться только основная информация, например значок уведомления, а его содержание будет скрыто.
  • VISIBILITY_PUBLIC. Показывает уведомление полностью.
  • VISIBILITY_SECRET – не показывать ничего, даже значок уведомления.

Если выбран уровень VISIBILITY_PRIVATE, вы также можете предоставить отредактированную версию уведомления, в которой скрыты личные данные. Например, приложение для обмена SMS может показывать уведомление "У вас 3 новых текстовых сообщения", но скрывать их содержимое и отправителей. Чтобы показывать альтернативное уведомление, сначала создайте его с помощью Notification.Builder. При создании объекта уведомления для заблокированного экрана прикрепите к нему уведомление для замены с помощью метода setPublicVersion().

Метаданные уведомлений

В Android 5.0 используются метаданные, связанные с уведомлениями приложения, чтобы сортировать уведомления более эффективно. Чтобы задать метаданные, вызовите следующие методы в Notification.Builder при создании уведомления:

  • setCategory() – указывает системе, как обрабатывать уведомления приложения, когда устройство находится в режиме Важные (например, если уведомление сообщает о входящем вызове, мгновенном сообщении или будильнике).
  • setPriority() – указывает, что уведомление более или менее важно, чем обычные уведомления. Уведомления, для которых в поле приоритета задано значение PRIORITY_MAX или PRIORITY_HIGH, появляются в небольшом плавающем окне, если для них также включен звук или вибрация.
  • addPerson() – позволяет добавить одного или нескольких пользователей, связанных с уведомлением. Приложение может использовать этот метод, чтобы сообщить системе, что уведомления от указанных людей нужно группировать или считать более важными.

Графика

Поддержка OpenGL ES 3.1.

В Android 5.0 добавлены интерфейсы Java и встроенная поддержка OpenGL ES 3.1. Основные новые функции, предоставляемые в OpenGL ES 3.1, включают:

  • Вычислительные шейдеры
  • Отдельные объекты шейдеров
  • Команды косвенного рисования
  • Текстуры с множественной выборкой и трафаретные текстуры
  • Улучшения языка шейдеров
  • Расширения для продвинутых режимов смешивания и отладки
  • Обратная совместимость с OpenGL ES 2.0 и 3.0.

Интерфейс Java для OpenGL ES 3.1 на Android предоставляется с помощью GLES31. Если вы используете OpenGL ES 3.1, укажите это в файле манифеста с помощью тега <uses-feature> и атрибута android:glEsVersion. Пример:

<manifest>
    <uses-feature android:glEsVersion="0x00030001" />
    ...
</manifest>

Дополнительную информацию об использовании OpenGL ES, в том числе о том, как проверить поддерживаемую устройством версию OpenGL ES во время выполнения, можно найти в руководстве по OpenGL ES API.

Android Extension Pack

В дополнение к OpenGL ES 3.1 в этом выпуске представлен пакет расширений с интерфейсами Java и встроенной поддержкой расширенных графических функций. Android обрабатывает эти расширения как единый пакет. Если расширение ANDROID_extension_pack_es31a присутствует, приложение может считать, что все расширения в пакете присутствуют, и включить функции языка шейдинга с помощью одной инструкции #extension.

Пакет расширений поддерживает:

  • Обязательная поддержка фрагментных шейдеров для буферов хранения шейдеров, изображений и атомарных операций (в OpenGL ES 3.1 поддержка фрагментных шейдеров необязательна).
  • Тесселяция и геометрические шейдеры
  • Формат сжатия текстур ASTC (LDR)
  • Интерполяция и затенение для каждого образца
  • Разные режимы смешивания для каждого цветового вложения в буфере кадров.

Интерфейс Java для пакета расширений предоставляется с помощью GLES31Ext. В манифесте приложения можно указать, что оно должно устанавливаться только на устройства, поддерживающие пакет расширения. Пример:

<manifest>
    <uses-feature android:name="android.hardware.opengles.aep"
        android:required="true" />
    ...
</manifest>

Мультимедиа

Camera API для расширенных возможностей камеры.

В Android 5.0 представлен новый API android.hardware.camera2, который упрощает фотосъемку и обработку изображений. Теперь вы можете программно получить доступ к камерам, доступным в системе, с помощью getCameraIdList() и подключиться к определенному устройству с помощью openCamera(). Чтобы начать съемку, создайте объект CameraCaptureSession и укажите объекты Surface, которым нужно отправлять снимки. CameraCaptureSession можно настроить так, чтобы она делала одиночные снимки или серию фотографий.

Чтобы получать уведомления о новых снимках, реализуйте прослушиватель CameraCaptureSession.CaptureCallback и задайте его в запросе на съемку. Теперь, когда система выполнит запрос на фотосъемку, ваш прослушиватель CameraCaptureSession.CaptureCallback получит вызов onCaptureCompleted(), который предоставит вам метаданные фотосъемки в CaptureResult.

Класс CameraCharacteristics позволяет приложению определять, какие функции камеры доступны на устройстве. Свойство INFO_SUPPORTED_HARDWARE_LEVEL объекта представляет уровень функциональности камеры.

  • Все устройства поддерживают как минимум уровень аппаратного обеспечения INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY, возможности которого примерно эквивалентны возможностям устаревшего API Camera.
  • Устройства, поддерживающие уровень аппаратного обеспечения INFO_SUPPORTED_HARDWARE_LEVEL_FULL, позволяют вручную управлять съемкой и постобработкой, а также снимать изображения с высоким разрешением и частотой кадров.

Чтобы узнать, как использовать обновленный API Camera, ознакомьтесь с примерами реализации Camera2Basic и Camera2Video в этом выпуске.

Воспроизведение аудио

В этом выпуске AudioTrack произошли следующие изменения:

  • Теперь ваше приложение может предоставлять аудиоданные в формате с плавающей запятой (ENCODING_PCM_FLOAT). Это позволяет расширить динамический диапазон, повысить точность и увеличить запас по уровню. Арифметика с плавающей запятой особенно полезна при промежуточных вычислениях. Конечные точки воспроизведения используют целочисленный формат для аудиоданных и меньшую глубину цвета. (В Android 5.0 некоторые части внутреннего конвейера ещё не поддерживают числа с плавающей запятой.)
  • Теперь ваше приложение может предоставлять аудиоданные в виде ByteBuffer в том же формате, что и MediaCodec.
  • Параметр WRITE_NON_BLOCKING может упростить буферизацию и многопоточность для некоторых приложений.

Управление воспроизведением медиаконтента

Используйте новые API уведомлений и мультимедиа, чтобы системный интерфейс получал информацию о воспроизведении медиаконтента и мог извлекать и показывать обложки альбомов. Управлять воспроизведением медиаконтента в интерфейсе и сервисе стало проще благодаря новым классам MediaSession и MediaController.

Новый класс MediaSession заменяет устаревший класс RemoteControlClient и предоставляет единый набор методов обратного вызова для обработки элементов управления транспортом и кнопок мультимедиа. Если ваше приложение воспроизводит медиаконтент и работает на платформе Android TV или Wear, используйте класс MediaSession, чтобы управлять воспроизведением с помощью тех же методов обратного вызова.

Теперь вы можете создать собственное приложение для управления медиаконтентом с помощью нового класса MediaController. Этот класс обеспечивает потокобезопасный способ отслеживания и управления воспроизведением медиаконтента из процесса пользовательского интерфейса приложения. При создании контроллера укажите объект MediaSession.Token, чтобы приложение могло взаимодействовать с заданным MediaSession. С помощью методов MediaController.TransportControls вы можете отправлять команды, такие как play(), stop(), skipToNext() и setRating(), чтобы управлять воспроизведением медиаконтента в этом сеансе. С помощью контроллера вы также можете зарегистрировать объект MediaController.Callback, чтобы отслеживать метаданные и изменения состояния сеанса.

Кроме того, вы можете создавать расширенные уведомления, которые позволяют управлять воспроизведением, связанным с сеансом мультимедиа, с помощью нового класса Notification.MediaStyle.

Просмотр медиаконтента

В Android 5.0 приложения могут просматривать библиотеку медиаконтента другого приложения с помощью нового API android.media.browse. Чтобы сделать медиаконтент доступным в приложении, расширьте класс MediaBrowserService. Ваша реализация MediaBrowserService должна предоставлять доступ к MediaSession.Token, чтобы приложения могли воспроизводить медиаконтент, предоставляемый через ваш сервис.

Для взаимодействия с сервисом просмотра медиафайлов используйте класс MediaBrowser. При создании экземпляра MediaBrowser укажите название компонента для MediaSession. Используя этот экземпляр браузера, приложение может подключиться к связанному сервису и получить объект MediaSession.Token для воспроизведения контента, доступного через этот сервис.

Хранилище

Выбор каталога

В Android 5.0 расширены возможности Storage Access Framework. Теперь пользователи могут выбирать целое поддерево каталогов, предоставляя приложениям доступ для чтения и записи ко всем содержащимся в нем документам без необходимости подтверждения для каждого элемента.

Чтобы выбрать поддерево каталога, создайте и отправьте намерение OPEN_DOCUMENT_TREE. Система показывает все экземпляры DocumentsProvider, которые поддерживают выбор поддерева, позволяя пользователю просматривать и выбирать каталог. Возвращенный URI представляет доступ к выбранному поддереву. Затем вы можете использовать buildChildDocumentsUriUsingTree() и buildDocumentUriUsingTree() вместе с query(), чтобы изучить поддерево.

Новый метод createDocument() позволяет создавать документы и каталоги в любом месте поддерева. Для управления существующими документами используйте renameDocument() и deleteDocument(). Прежде чем выполнять вызовы, проверьте, поддерживает ли их поставщик, с помощью COLUMN_FLAGS.

Если вы реализуете DocumentsProvider и хотите поддерживать выбор поддерева, реализуйте isChildDocument() и включите FLAG_SUPPORTS_IS_CHILD в COLUMN_FLAGS.

В Android 5.0 также появились новые каталоги для отдельных пакетов в общем хранилище, в которые приложение может помещать медиафайлы для включения в MediaStore. Новый метод getExternalMediaDirs() возвращает пути к этим каталогам на всех общих устройствах хранения данных. Как и в случае с getExternalFilesDir(), вашему приложению не нужны дополнительные разрешения для доступа к возвращенным путям. Платформа периодически сканирует эти каталоги на наличие новых медиафайлов, но вы также можете использовать MediaScannerConnection, чтобы явно сканировать новый контент.

Беспроводные сети и подключение

Несколько сетевых подключений

В Android 5.0 представлены новые API для работы с несколькими сетями, которые позволяют приложению динамически сканировать доступные сети с определенными возможностями и устанавливать с ними соединение. Эта функция полезна, если вашему приложению требуется специализированная сеть, например SUPL, MMS или сеть оператора связи, или если вы хотите отправлять данные с помощью определенного типа транспортного протокола.

Чтобы выбрать сеть и подключиться к ней динамически из приложения, выполните следующие действия:

  1. Создайте ConnectivityManager.
  2. Используйте класс NetworkRequest.Builder, чтобы создать объект NetworkRequest и указать функции сети и тип транспорта, которые нужны вашему приложению.
  3. Чтобы выполнить поиск подходящих сетей, вызовите requestNetwork() или registerNetworkCallback() и передайте объект NetworkRequest и реализацию ConnectivityManager.NetworkCallback. Используйте метод requestNetwork(), если хотите переключаться на подходящую сеть сразу после ее обнаружения. Если вы хотите только получать уведомления о найденных сетях, используйте метод registerNetworkCallback().

Когда система обнаруживает подходящую сеть, она подключается к ней и вызывает обратный вызов onAvailable(). Вы можете использовать объект Network из обратного вызова, чтобы получить дополнительную информацию о сети или направить трафик в выбранную сеть.

Bluetooth с низким энергопотреблением

В Android 4.3 появилась поддержка Bluetooth с низким энергопотреблением (Bluetooth LE) в центральной роли. В Android 5.0 устройство Android может выступать в качестве периферийного устройства Bluetooth LE. Приложения могут использовать эту возможность, чтобы сообщать о своем присутствии устройствам поблизости. Например, вы можете создавать приложения, которые позволяют устройству функционировать в качестве шагомера или монитора здоровья и передавать свои данные на другое устройство Bluetooth LE.

Новые API android.bluetooth.le позволяют приложениям транслировать объявления, сканировать ответы и устанавливать соединения с устройствами Bluetooth LE поблизости. Чтобы использовать новые функции рекламы и сканирования, добавьте в манифест разрешение BLUETOOTH_ADMIN. Когда пользователи скачивают или обновляют ваше приложение в Google Play, им предлагается предоставить ему следующее разрешение: "Информация о подключении Bluetooth. Позволяет приложению управлять Bluetooth, в том числе передавать данные на устройства Bluetooth поблизости и получать информацию о них".

Чтобы начать передачу данных по Bluetooth LE и сделать приложение видимым для других устройств, вызовите startAdvertising() и передайте реализацию класса AdvertiseCallback. Объект обратного вызова получает отчет об успешном или неудачном выполнении операции рекламы.

В Android 5.0 появился класс ScanFilter, который позволяет приложению искать только нужные типы устройств. Чтобы начать поиск устройств Bluetooth LE, вызовите startScan() и передайте список фильтров. В вызове метода также необходимо предоставить реализацию ScanCallback, чтобы сообщать об обнаружении объявления Bluetooth LE.

Улучшения NFC

В Android 5.0 добавлены следующие улучшения, позволяющие более широко и гибко использовать NFC:

  • Функция Android Beam теперь доступна в меню Поделиться.
  • Приложение может вызвать Android Beam на устройстве пользователя, чтобы поделиться данными, вызвав invokeBeam(). Это позволяет пользователю не прикладывать устройство к другому устройству с поддержкой NFC для завершения передачи данных.
  • Вы можете использовать новый метод createTextRecord(), чтобы создать запись NDEF, содержащую текстовые данные в кодировке UTF-8.
  • Если вы разрабатываете платежное приложение, то теперь можете динамически регистрировать идентификатор приложения NFC (AID), вызывая registerAidsForService(). Вы также можете использовать setPreferredService(), чтобы задать предпочтительный сервис эмуляции карт, который должен использоваться, когда определенное действие находится на переднем плане.

Project Volta

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

Планирование заданий

В Android 5.0 появился новый API JobScheduler, который позволяет оптимизировать время работы от батареи, определяя задания, которые система должна выполнять асинхронно в более позднее время или при определенных условиях (например, когда устройство заряжается). Планирование заданий полезно в следующих ситуациях:

  • В приложении есть задачи, не связанные с взаимодействием с пользователем, которые можно отложить.
  • Приложение выполняет задачи, которые лучше делать, когда устройство подключено к сети.
  • Приложению требуется доступ к сети или подключение по Wi-Fi.
  • В приложении есть несколько задач, которые вы хотите запускать в виде пакета по регулярному расписанию.

Единица работы инкапсулируется объектом JobInfo. Этот объект задает критерии планирования.

Используйте класс JobInfo.Builder, чтобы настроить выполнение запланированной задачи. Вы можете запланировать выполнение задачи при определенных условиях, например:

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

Например, вы можете добавить следующий код, чтобы задача выполнялась в безлимитной сети:

Kotlin

val uploadTask: JobInfo = JobInfo.Builder(
        jobId,
        serviceComponent /* JobService component */
).run {
    setRequiredNetworkType(JobInfo.NETWORK_TYPE_UNMETERED)
    build()
}
val jobScheduler = context.getSystemService(Context.JOB_SCHEDULER_SERVICE) as JobScheduler
jobScheduler.schedule(uploadTask)

Java

JobInfo uploadTask = new JobInfo.Builder(jobId,
                                         serviceComponent /* JobService component */)
        .setRequiredNetworkCapabilities(JobInfo.NETWORK_TYPE_UNMETERED)
        .build();
JobScheduler jobScheduler =
        (JobScheduler) context.getSystemService(Context.JOB_SCHEDULER_SERVICE);
jobScheduler.schedule(uploadTask);

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

Пример использования JobScheduler API можно найти в образце реализации JobSchedulerSample в этом выпуске.

Инструменты разработчика для анализа энергопотребления

Новая команда dumpsys batterystats генерирует интересные статистические данные об использовании батареи на устройстве, упорядоченные по уникальному идентификатору пользователя (UID). В статистику входят:

  • История событий, связанных с батареей
  • Общая статистика по устройству.
  • Приблизительное энергопотребление на UID и системный компонент
  • Задержка в миллисекундах на пакет для каждого приложения
  • Агрегированная статистика по UID системы
  • Агрегированная статистика по UID приложений

Используйте параметр --help, чтобы узнать о различных вариантах настройки выходных данных. Например, чтобы вывести статистику использования батареи для определенного пакета приложения с момента последней зарядки устройства, выполните следующую команду:

$ adb shell dumpsys batterystats --charged <package-name>

Вы можете использовать инструмент Battery Historian для вывода команды dumpsys, чтобы создать HTML-визуализацию событий, связанных с питанием, из журналов. Эта информация поможет вам понять и диагностировать любые проблемы, связанные с батареей.

Android на работе и в учебных заведениях

Управляемая синхронизация

В Android 5.0 появились новые функции для запуска приложений в корпоративной среде. Администратор устройства может инициировать процесс управляемой инициализации, чтобы добавить на устройство отдельный управляемый профиль, если у пользователя уже есть личный аккаунт. Приложения, связанные с управляемыми профилями, отображаются вместе с неуправляемыми приложениями на панели запуска, экране недавних приложений и в уведомлениях.

Чтобы запустить процесс управляемой инициализации, отправьте ACTION_PROVISION_MANAGED_PROFILE в Intent. Если вызов выполнен успешно, система активирует обратный вызов onProfileProvisioningComplete(). Затем вызовите метод setProfileEnabled(), чтобы включить управляемый профиль.

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

Если вы разрабатываете приложение для запуска, то можете использовать новый класс LauncherApps, чтобы получить список действий, которые может запустить текущий пользователь и связанные с ним управляемые профили. Панель запуска может визуально выделять управляемые приложения, добавляя к их значкам рабочий значок. Чтобы получить значок со значком, вызовите getUserBadgedIcon().

Чтобы узнать, как использовать новые функции, ознакомьтесь с BasicManagedProfileпримером реализации в этом выпуске.

Владелец устройства

В Android 5.0 появилась возможность развертывать приложение владельца устройства. Владелец устройства – это особый тип администратора устройства, который может создавать и удалять дополнительных пользователей, а также настраивать глобальные параметры на устройстве. Приложение владельца устройства может использовать методы класса DevicePolicyManager для точного управления конфигурацией, безопасностью и приложениями на управляемых устройствах. У устройства может быть только один активный владелец.

Чтобы развернуть и активировать владельца устройства, необходимо выполнить передачу данных NFC из приложения для программирования на устройство, пока оно находится в ненастроенном состоянии. При этом передается та же информация, что и в интенте инициализации, описанном в разделе Управляемая инициализация.

Блокировка в приложении

В Android 5.0 представлен новый API для блокировки в приложении, который позволяет временно запретить пользователям выходить из задачи или прерывать ее уведомлениями. Например, это может быть полезно, если вы разрабатываете образовательное приложение для проведения важных экзаменов на Android, приложение для одной цели или приложение для киоска. Когда приложение активирует блокировку в приложении, пользователи не могут видеть уведомления, получать доступ к другим приложениям или возвращаться на главный экран, пока приложение не выйдет из этого режима.

Есть два способа включить блокировку в приложении:

  • Вручную. Пользователи могут включить блокировку в приложении в разделе Настройки > Безопасность > Блокировка в приложении и выбрать задачи, которые нужно закрепить, нажав на зеленый значок булавки на экране недавних приложений.
  • Программно. Чтобы активировать блокировку в приложении программно, вызовите startLockTask() из приложения. Если запрашивающее приложение не является владельцем устройства, пользователю будет предложено подтвердить действие. Приложение владельца устройства может вызвать метод setLockTaskPackages(), чтобы разрешить закрепление приложений без подтверждения пользователя.

Когда блокировка задач активна, происходит следующее:

  • Строка состояния пуста, а уведомления и информация о статусе скрыты.
  • Кнопки "Домой" и "Недавние приложения" скрыты.
  • Другие приложения не могут запускать новые действия.
  • Текущее приложение может запускать новые действия, если при этом не создаются новые задачи.
  • Когда блокировка в приложении вызывается владельцем устройства, пользователь остается заблокированным в вашем приложении, пока приложение не вызовет stopLockTask().
  • Если блокировка в приложении активирована другим приложением, которое не является владельцем устройства, или непосредственно пользователем, пользователь может выйти из режима блокировки, удерживая кнопки "Назад" и "Недавние".

Фреймворк печати

Отрисовывать PDF как растровое изображение

Теперь вы можете преобразовывать страницы PDF-документов в растровые изображения для печати с помощью нового класса PdfRenderer. Необходимо указать ParcelFileDescriptor, в котором можно выполнять поиск (то есть к контенту можно получить произвольный доступ), в который система записывает контент для печати. Приложение может получить страницу для рендеринга с помощью openPage(), а затем вызвать render(), чтобы преобразовать открытый объект PdfRenderer.Page в битовую карту. Вы также можете задать дополнительные параметры, если хотите преобразовать в растровое изображение только часть документа (например, чтобы реализовать мозаичный рендеринг для увеличения масштаба документа).

Пример использования новых API можно найти в PdfRendererBasic.

Система

Статистика использования приложений

Теперь вы можете получить доступ к истории использования приложений на устройстве Android с помощью нового API android.app.usage. Этот API предоставляет более подробную информацию об использовании, чем устаревший метод getRecentTasks(). Чтобы использовать этот API, сначала необходимо объявить разрешение "android.permission.PACKAGE_USAGE_STATS" в манифесте. Пользователь также должен разрешить доступ для этого приложения в разделе Настройки > Безопасность > Приложения с доступом к данным об использовании.

Система собирает данные об использовании для каждого приложения, агрегируя их по дням, неделям, месяцам и годам. Максимальный срок хранения данных в системе:

  • Ежедневные данные: 7 дней.
  • Еженедельные данные: 4 недели.
  • Ежемесячные данные: 6 месяцев.
  • Годовые данные: 2 года.

Для каждого приложения система записывает следующие данные:

  • время последнего использования приложения;
  • Общая продолжительность времени, в течение которого приложение находилось на переднем плане за этот интервал времени (по дням, неделям, месяцам или годам).
  • Временная метка, указывающая, когда компонент (определяемый по названию пакета и действия) переместился на передний или задний план в течение дня.
  • Временная метка, фиксирующая изменение конфигурации устройства (например, изменение ориентации устройства из-за поворота).

Тестирование и специальные возможности

Тестирование и улучшение специальных возможностей

В Android 5.0 добавлены следующие возможности для тестирования и специальные возможности:

  • Новые методы getWindowAnimationFrameStats() и getWindowContentFrameStats() собирают статистику кадров для анимации окон и контента. Эти методы позволяют писать инструментальные тесты, чтобы проверять, достаточно ли часто приложение обновляет кадры для обеспечения плавности.
  • Новый метод executeShellCommand() позволяет выполнять команды оболочки из инструментального теста. Выполнение команды аналогично запуску adb shell с хоста, подключенного к устройству, что позволяет использовать инструменты на основе оболочки, такие как dumpsys, am, content и pm.
  • Сервисы специальных возможностей и инструменты тестирования, использующие Accessibility API (например, UiAutomator), теперь могут получать подробную информацию о свойствах окон на экране, с которыми могут взаимодействовать зрячие пользователи. Чтобы получить список объектов AccessibilityWindowInfo, вызовите новый метод getWindows().
  • Новый класс AccessibilityNodeInfo.AccessibilityAction позволяет определять стандартные или настраиваемые действия, которые будут выполняться с объектом AccessibilityNodeInfo. Новый класс AccessibilityNodeInfo.AccessibilityAction заменяет API, связанные с действиями, которые ранее находились в AccessibilityNodeInfo.
  • Android 5.0 обеспечивает более точный контроль над синтезом речи в приложении. Новый класс Voice позволяет приложению использовать голосовые профили, связанные с определенными региональными настройками, рейтингом качества и задержки, а также параметрами, специфичными для механизма синтеза речи.

Способы ввода

Упрощенное переключение между языками ввода

Начиная с Android 5.0 пользователи могут переключаться между всеми редакторами методов ввода (IME), поддерживаемыми платформой. Переключение между ними выполняется с помощью специального действия (обычно это нажатие на значок глобуса на экранной клавиатуре). Это изменение в поведении реализовано методом shouldOfferSwitchingToNextInputMethod().

Кроме того, теперь фреймворк проверяет, есть ли в следующем редакторе метод ввода механизм переключения (и, следовательно, поддерживает ли этот редактор метод ввода переключение на следующий редактор метод ввода). Редактор метода ввода с механизмом переключения не будет переключаться на редактор метода ввода без такого механизма. Это изменение реализовано с помощью метода switchToNextInputMethod().

Пример использования обновленных API для переключения IME можно найти в обновленном примере реализации экранной клавиатуры в этом выпуске. Подробнее о том, как реализовать переключение между редакторами методов ввода…

Объявления в манифесте

Обязательные функции, которые нужно декларировать

Теперь в элементе <uses-feature> поддерживаются перечисленные ниже значения. Это позволяет гарантировать, что ваше приложение будет установлено только на устройствах, которые поддерживают необходимые для его работы функции.

Разрешения пользователей

Теперь в элементе <uses-permission> поддерживается следующее разрешение, которое позволяет объявить, какие разрешения требуются приложению для доступа к определенным API.

  • BIND_DREAM_SERVICE. Если целевой уровень API – 21 или выше, это разрешение требуется для сервиса Daydream, чтобы к нему могла подключаться только система.