Подсистема Windows для Android™️

Подсистема Windows для Android™️ позволяет устройству Windows 11 запускать приложения для Android, доступные в Amazon Appstore. Android является товарным знаком Google LLC. Это руководство поможет разработчикам, которые заинтересованы в создании приложений для настольных устройств Windows и оптимизации работы с операционной системой Windows.

Чтобы приложение Android было доступно на устройствах Windows 11, вам нужно сделать следующее:

Для получения дополнительных сведений или поддержки:

Это руководство поможет вам протестировать и отладить приложение Android в Windows:

Предварительная версия программы

Программа по ознакомлению с предварительной версией Подсистемы Windows для Android™️ позволяет пользователям получать предварительные сборки Подсистемы Windows для Android™ и Amazon Appstore в Windows. Дополнительные сведения см. на странице цен на программу предварительной версии.

Настройка среды разработки

Чтобы протестировать приложение Android в среде компьютера Windows, нужно выполнить некоторые действия.

Предварительные требования

Подсистема Windows для Android сейчас предоставляется в общедоступной предварительной версии в Windows 11.

При этом устройство должно соответствовать определенным требованиям: Требования к устройствам.

Установка Amazon Appstore

Microsoft Store автоматически установит подсистему Windows для Android в фоновом режиме при выполнении любого из следующих двух действий пользователя:

  1. Установка Amazon Appstore из Microsoft Store. Щелкните Получить, чтобы начать установку приложения.
  2. Установка приложения Android из Microsoft Store в первый раз; при этом также будет выполнена установка Amazon Appstore.

Затем приложение Amazon Appstore, содержащее каталог проверенных приложений Android, и приложение "Параметры" подсистемы Windows для Android появятся в меню Windows 11 и будут доступны для поиска.

Снимок экрана: страница Microsoft Store с кнопкой

Примечание

Amazon Appstore на Windows (обязательный компонент для запуска приложений Android на Windows 11) в настоящее время доступно только в США.

Приложение "Параметры" подсистемы Windows для Android™️

Чтобы открыть приложение "Параметры" подсистемы Windows для Android, выберите Пуск > Все приложения > Параметры подсистемы Windows для Android™️. Дополнительные сведения о конкретных возможностях приложения "Параметры" см. в статье Управление параметрами для мобильных приложений в Windows.

Снимок экрана: параметры приложения Latte

Вопросы, связанные с совместимостью ввода для устройств Windows

Есть несколько уникальных методов ввода, для поддержки которых, вероятно, понадобится обновить код приложения Android, предназначенный для портативных устройств, чтобы обеспечить совместимость при выполнении на настольном устройстве Windows с помощью Amazon Appstore.

Ввод с клавиатуры

При использовании полей ввода текста, обрабатываемых методом ввода с помощью виртуальной экранной клавиатуры (IME), например EditText, приложения должны работать ожидаемым образом. (Класс EditText в документации Android.)

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

Например, некоторые игры наряду с сенсорным входом могут уже поддерживать перемещение с помощью клавиатуры — с использованием клавиш w,a, s и d.

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

  • клавиша ВВОД;
  • навигация с помощью клавиш со стрелками и клавиши TAB;
  • изменение цвета выделения выбранного элемента;
  • сочетания клавиш с использованием CTRL.

Дополнительные сведения о том, как оптимизировать эти сценарии ввода с клавиатуры на настольных устройствах, см. в документации Android:

Ввод с помощью мыши

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

  • Щелчок правой кнопкой мыши
  • всплывающие подсказки и текст, отображающийся при наведении указателя мыши;
  • эффекты при наведении указателя мыши;
  • действия колесика мыши;
  • Перетаскивание

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

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

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

Минимальные требования к экрану

В Windows 11 применяются минимальные требования к экрану: разрешение 720p (1280x720) и размер экрана больше 22,86 см (9 дюймов).

Леттербоксинг и пилларбоксинг

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

Пример леттербоксинга и пилларбоксинга с пустыми прямоугольниками, которые выравнивают окно по центру

Дополнительные рекомендации по изменению размера

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

  • начальный размер при запуске;
  • размеры окна;
    • границы содержимого;
    • произвольное изменение размера;
  • Ориентация экрана

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

Тестирование и отладка

Для тестирования и отладки приложения на устройстве Windows 11 с помощью Подсистемы Windows для Android необходимо выполнить описанные ниже подготовительные действия.

Включение режима разработчика в приложении "Параметры" для Windows

Сначала включите режим разработчика в приложении "Параметры" для Windows. Есть три способа включения режима разработчика:

  • Откройте приложение "Параметры" Подсистемы Windows для Android. После открытия приложения включите режим разработчика.
  • В Windows Search выполните поиск по фразе Developer Settings.
  • Выберите "Параметры" > "Конфиденциальность и безопасность" > "Разработчикам" > "Режим разработчика".

Подключение к Подсистеме Windows для Android для отладки

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

  1. Запустите приложение Android, установленное с помощью Amazon Appstore.

  2. Вы можете подключиться с adb connect с помощью следующей команды (необходимо установить adb):

    adb connect 127.0.0.1:58526
    

Подключение к тестовому устройству

Чтобы подключиться к тестовому устройству (с установленной Подсистемой Windows для Android) в той же сети, что и устройство Windows или Mac:

  1. На тестовом устройстве (где установлена Подсистема Windows для Android) откройте окно PowerShell и найдите IP-адрес тестового устройства, выполнив команду:

    ipconfig
    
  2. С помощью терминала устройства отладки, где установлены Android Studio и пакет SDK для Android (Mac или Windows), введите команду:

    adb connect <TEST DEVICE IP ADDRESS>:58526
    

<TEST DEVICE IP ADDRESS> можно найти в выходных данных ipconfig на тестовом устройстве. Вы также можете развертывать и отлаживать приложения с помощью Android Studio.

Сведения об использовании Android Debug Bridge (ADB) для подключения рабочей станции разработчика непосредственно к устройству Android, чтобы установить пакеты и оценить изменения, см. в статье Android Debug Bridge в документации Android Open Source Project.

Отладка приложения

Хотя приложения нужно устанавливать с помощью Amazon Appstore, отладка приложения Android на устройстве Windows возможна с помощью APK (пакет приложений Android) и ADB (Android Debug Bridge).

Чтобы выполнить отладку APK с помощью ADB:

  1. Выполните описанные выше действия по подключению к виртуальной машине Подсистемы Windows для Android.

  2. Установите APK, выполнив adb install: adb install app-debug .apk.

    Ожидаемые выходные данные:

    Performing Streamed Install
    Success
    
  3. В меню уведомлений Windows появится уведомление об установке приложения. Выберите приложение, чтобы запустить его.

Создание универсальных пакетов APK

Подсистема Windows для Android использует технологию Intel Bridge для эмуляции приложений ARM на процессорах на базе архитектуры x86. Приложения ARM изначально работают на процессорах на базе ARM. Использование уровня эмуляции приводит к снижению производительности. Для обеспечения оптимальной производительности отправьте приложение для архитектур x86–64 и ARM64.

Жизненный цикл виртуальной машины

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

Виртуальная машина, на которой запущены приложения с помощью Подсистемы Windows для Android, может находиться в одном из трех состояний:

  1. Запущен
  2. Спящий режим — активируется после отсутствия активности приложения в течение 3 минут, деактивируется при выполнении пользователем действия или при появлении уведомления от приложения.
  3. Не запущена — активируется после отсутствия активности приложения в течение 7 минут,

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

Схема жизненного цикла виртуальной машины, отображающая режимы

Свойства виртуальной машины

Ниже перечислены свойства виртуальной машины Подсистемы Windows для Android. Не рекомендуется прописывать в коде эти значения, так как это может привести к несовместимости в будущем.

Свойство Значение
Build.MANUFACTURER Microsoft Corporation
Build.MODEL Подсистема для Android
Build.VERSION.SDK_INT 30
Build.BOARD Windows

Безопасность

Подсистема Windows для Android выполняет шифрование для каждого файла, на основе программного обеспечения.

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

Разработчики, которые выполнят запрос getSecurityLevel, получат SECURITY_LEVEL_SW_SECURE_CRYPTO. Дополнительные сведения о getSecurityLevel см. в справочнике по API Android.

Удаление Подсистемы Windows для Android

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

  • При удалении Amazon Appstore будет удалена Подсистема Windows для Android и все остальные приложения для Android.
  • При удалении приложения из Amazon Appstore будет удалено только это приложение (как и в случае приложений для Windows).
  • При удалении подсистемы Windows для Android будет удалено приложение Amazon Appstore и все приложения для Android.

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

При возникновении проблем, связанных с Amazon Appstore на Windows, выполните следующие действия по устранению неполадок:

  1. Выберите Windows Search на панели задач Windows.
  2. Выполните поиск по запросу Amazon Appstore и щелкните правой кнопкой мыши значок Amazon AppStore.
  3. Выберите в раскрывающемся списке "Параметры приложения".
  4. Выберите "Хранилище и кэш" и щелкните "Очистить хранилище" и "Очистить кэш".
  5. Вернитесь и выберите "Принудительно остановить".
  6. Закройте окно параметров Amazon Appstore.
  7. Запустите Amazon AppStore заново.

Чтобы изучить дополнительные действия по устранению неполадок, связанные с приложением "Параметры" подсистемы Windows для Android, или узнать, как оставить отзыв с помощью Центра отзывов, см. статью Устранение неполадок с мобильными приложениями в Windows и часто задаваемые вопросы.

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

Примечание

В настоящее время подсистема Windows для Android не поддерживает функции Bluetooth, такие как поиск устройств BLE.

Дополнительные ресурсы