Отладка приложений в Android EmulatorDebugging on the Android Emulator

Это руководство описывает, как запустить виртуальное устройство в Android Emulator для отладки и тестирования вашего приложения.In this guide, you will learn how to launch a virtual device in the Android Emulator to debug and test your app.

ОбзорOverview

Для имитации разнообразных устройств с Android эмулятор Android Emulator (устанавливаемый с рабочей нагрузкой Разработка мобильных приложений на .NET) можно запускать в различных конфигурациях.The Android Emulator (installed as part of the Mobile development with .NET workload), can be run in a variety of configurations to simulate different Android devices. Каждая из этих конфигураций создается в виде виртуального устройства.Each one of these configurations is created as a virtual device. В этом руководстве вы узнаете, как открыть эмулятор из Visual Studio и запустить приложение на виртуальном устройстве.In this guide, you will learn how to launch the emulator from Visual Studio and run your app in a virtual device. Информацию о настройке Android Emulator и создании виртуальных устройств см. в статье Настройка Android Emulator.For information about configuring the Android Emulator and creating new virtual devices, see Android Emulator Setup.

Использование предварительно настроенного виртуального устройстваUsing a Pre-Configured Virtual Device

В состав Visual Studio входят предварительно настроенные виртуальные устройства, которые отображаются в раскрывающемся меню устройства.Visual Studio includes pre-configured virtual devices that appear in the device drop-down menu. Например, на следующем снимке экрана Visual Studio 2017 доступно несколько предварительно настроенных виртуальных устройств:For example, in the following Visual Studio 2017 screenshot, several pre-configured virtual devices are available:

  • VisualStudio_android-23_arm_phoneVisualStudio_android-23_arm_phone

  • VisualStudio_android-23_arm_tabletVisualStudio_android-23_arm_tablet

  • VisualStudio_android-23_x86_phoneVisualStudio_android-23_x86_phone

  • VisualStudio_android-23_x86_tabletVisualStudio_android-23_x86_tablet

Виртуальные устройстваVirtual devices

Как правило, для тестирования и отладки приложения для телефона следует выбрать виртуальное устройство VisualStudio_android-23_x86_phone.Typically, you would select the VisualStudio_android-23_x86_phone virtual device to test and debug a phone app. Если одно из этих предварительно настроенных виртуальных устройств соответствует вашим требованиям (т. е. соответствует целевому уровню API приложения), перейдите к разделу Запуск эмулятора, чтобы приступить к запуску приложения в эмуляторе.If one of these pre-configured virtual devices meets your requirements (i.e., matches your app's target API level), skip to Launching the Emulator to begin running your app in the emulator. (Если вы еще не знакомы с уровнями API Android, см. сведения в статье Основные сведения об уровнях API Android.)(If you are not yet familiar with Android API levels, see Understanding Android API Levels.)

Если в проекте Xamarin.Android используется уровень целевой платформы, несовместимый с доступными виртуальными устройствами, непригодные для использования виртуальные устройства отображаются в разделе Неподдерживаемые устройства раскрывающегося меню.If your Xamarin.Android project is using a Target Framework level that is incompatible with the available virtual devices, the drop-down menu lists the unusable virtual devices under Unsupported Devices. Например, для следующего проекта целевой платформой является Android Nougat 7.1 (API 25), которая несовместима с указанными в этом примере виртуальными устройствами Android 6.0:For example, the following project has a Target Framework set to Android 7.1 Nougat (API 25), which is incompatible with the Android 6.0 virtual devices that are listed in this example:

Несовместимое виртуальное устройствоIncompatible virtual device

Чтобы изменить минимальную версию Android в соответствии с уровнем API доступных виртуальных устройств, щелкните Изменить минимальную целевую версию Android.You can click Change Minimum Android Target to change the project's Minimum Android Version so that it matches the API level of the available virtual devices. Кроме того, с помощью Android Device Manager можно создать виртуальные устройства, которые поддерживают целевой уровень API.Alternately, you can use the Android Device Manager to create new virtual devices that support your target API level. Перед настройкой виртуальных устройств для нового уровня API сначала нужно установить соответствующие образы системы для этого уровня API (см. раздел Настройка пакета SDK для Android для Xamarin.Android).Before you can configure virtual devices for a new API level, you must first install the corresponding system images for that API level (see Setting up the Android SDK for Xamarin.Android).

Изменение виртуальных устройствEditing Virtual Devices

Для изменения (или создания) виртуальных устройств нужно использовать Android Device Manager.To modify virtual devices (or to create new ones), you must use the Android Device Manager.

Запуск эмулятораLaunching the Emulator

В верхней части Visual Studio находится раскрывающееся меню для выбора режима Отладка или Выпуск.Near the top of Visual Studio, there is a drop-down menu that can be used to select Debug or Release mode. При выборе режима Отладка отладчик подключается в процессу приложения, выполняемому в эмуляторе, после запуска приложения.Choosing Debug causes the debugger to attach to the application process running inside the emulator after the app starts. При выборе режима Выпуск отладчик отключается (однако вы все равно можете запустить приложение и использовать операторы журнала для отладки).Choosing Release mode disables the debugger (however, you can still run the app and use log statements for debug). После выбора виртуального устройства в раскрывающемся меню устройств выберите режим Отладка или Выпуск, а затем нажмите кнопку "Воспроизведение", чтобы запустить приложение:After you have chosen a virtual device from the device drop-down menu, select either Debug or Release mode, then click the Play button to run the application:

После запуска эмулятора Xamarin.Android развернет в нем приложение.After the emulator starts, Xamarin.Android will deploy the app to the emulator. Эмулятор выполняет приложение с настроенным образом виртуального устройства.The emulator runs the app with the configured virtual device image. Ниже приведен пример снимка экрана Android Emulator.An example screenshot of the Android Emulator is displayed below. В данном примере в эмуляторе выполняется пустое приложение MyApp:In this example, the emulator is running a blank app called MyApp:

Эмулятор, выполняющий пустое приложение

Эмулятор можно оставить в рабочем режиме. Необязательно завершать его работу и ожидать его перезапуска при каждом запуске приложения.The emulator may be left running: it is not necessary to shut it down and wait for it to restart each time the app is launched. При первом запуске приложения Xamarin.Android в эмуляторе устанавливается общая среда выполнения Xamarin.Android для целевого уровня API, после чего устанавливается приложение.The first time a Xamarin.Android app is run in the emulator, the Xamarin.Android shared runtime for the targeted API level is installed, followed by the application. Установка среды выполнения может занять несколько минут.The runtime installation may take a few moments, so please be patient. Установка среды выполнения происходит только при первом развертывании приложения Xamarin.Android в эмуляторе –, последующие развертывания выполняются быстрее, поскольку в эмулятор копируется только приложение.Installation of the runtime takes place only when the first Xamarin.Android app is deployed to the emulator – subsequent deployments are faster because only the app is copied to the emulator.

Быстрая загрузкаQuick Boot

Более новые версии Android Emulator поддерживают быструю загрузку, которая запускает эмулятор за несколько секунд.Newer versions of the Android Emulator include a feature called Quick Boot that launches the emulator in only a few seconds. При закрытии эмулятора она создает моментальный снимок состояния виртуального устройства, чтобы его можно было быстро восстановить при перезапуске.When you close the emulator, it takes a snapshot of the virtual device state so that it can be quickly restored from that state when it is restarted. Чтобы воспользоваться этой функцией, необходимо следующее:To access this feature, you will need the following:

  • Android Emulator версии 27.0.2 или более позднейAndroid Emulator version 27.0.2 or later
  • Android SDK Tools версии 26.1.1 или более позднейAndroid SDK Tools version 26.1.1 or later

После установки указанных выше версий эмулятора и средств SDK функция быстрой загрузки включена по умолчанию.When the above-listed versions of the emulator and SDK tools are installed, the Quick Boot feature is enabled by default.

Первый холодный запуск виртуального устройства выполняется без повышения производительности, так как моментальный снимок еще не создан:The first cold boot of the virtual device takes place without a speed improvement because a snapshot has not yet been created:

Снимок экрана холодного запуска

При выходе из эмулятора функция быстрой загрузки сохраняет его состояние в моментальном снимке:When you exit out of the emulator, Quick Boot saves the state of the emulator in a snapshot:

Сохранение состояния при завершении работы

Впоследствии виртуальное устройство запускается гораздо быстрее, так как эмулятор просто восстанавливает состояние, актуальное на момент завершения работы.Subsequent virtual device starts are much faster because the emulator simply restores the state at which you closed the emulator.

Загрузка состояния при перезапуске

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

Советы и способы решения распространенных проблем в эмуляторе см. в разделе Устранение неполадок Android Emulator.For tips and workarounds for common emulator problems, see Android Emulator Troubleshooting.

СводкаSummary

Это руководство описывает процесс настройки Android Emulator для запуска и тестирования приложений Xamarin.Android.This guide explained the process for configuring the Android Emulator to run and test Xamarin.Android apps. В нем рассмотрены шаги по запуску эмулятора с использованием предварительно настроенных виртуальных устройств и приведены действия по развертыванию приложения в эмуляторе из Visual Studio.It described the steps for launching the emulator using pre-configured virtual devices, and it provided the steps for deploying an application to the emulator from Visual Studio.

Дополнительные сведения об использовании Android Emulator см. в следующих разделах для разработчиков под Android.For more information about using the Android Emulator, see the following Android Developer topics: