Troubleshooting the Visual Studio Emulator for AndroidTroubleshooting the Visual Studio Emulator for Android

이 항목에는 Android용 Visual Studio 에뮬레이터를 사용하는 동안 발생할 수 있는 문제를 해결하는 데 도움이 되는 정보가 들어 있습니다.This topic contains information to help you resolve issues that you may experience when you're using the Visual Studio Emulator for Android.

경고

에뮬레이터가 설치되면 설치 프로그램은 소프트웨어 실행을 위한 필수 구성 요소를 확인합니다.When the emulator is installed, the setup program checks the prerequisites for running the software. 필수 구성 요소가 없는 경우 경고가 표시되지만 설치에 꼭 필요한 것은 아닙니다.It displays warnings if the prerequisites are not present, but it does not require them for installation.

이 항목에는 다음과 같은 섹션이 포함되어 있습니다.This topic contains the following sections.

시작하기 전에Before you start

문제 해결을 시작하기 전에 다음 항목을 검토하는 것이 유용할 수 있습니다.Before you begin troubleshooting, it may be useful to review the following topics:

에뮬레이터 설치 실패Emulator fails to install

Hyper-V를 설치하지 않은 경우 에뮬레이터를 설치하려고 할 때 다음과 같은 메시지가 나타납니다.If you don't have Hyper-V installed, you will see the following message when you try to install the emulator. HyperV를 지원하는 컴퓨터가 있어야 하고 HyperV를 사용하도록 설정해야 합니다.You must have a machine that supports HyperV and it must be enabled.

Android_Emu_Install_IssueAndroid_Emu_Install_Issue

참고

이 메시지는 Android용 Visual Studio 에뮬레이터 및 Windows Phone 에뮬레이터 모두에 적용됩니다.This message applies both to the Visual Studio Emulator for Android and the Windows Phone Emulator. Windows 8.1 및 Windows 10에서 에뮬레이터를 지원합니다.Windows 8.1 and Windows 10 support the emulator.

이 메시지가 표시되는 경우 System Requirements for the Visual Studio Emulator for Android 에서 에뮬레이터를 실행할 수 있는지 여부를 확인하세요.If you see this message, check the System Requirements for the Visual Studio Emulator for Android to see whether you can run the emulator.

도메인 또는 회사 네트워크의 네트워크 대상에 연결할 수 없음Cannot connect to network destinations on a domain or corporate network

Android용 Visual Studio 에뮬레이터는 네트워크에서 자체 IP 주소를 가진 별도 장치도 나타납니다.The Visual Studio Emulator for Android appears on the network as a separate device with its own IP address. 이 에뮬레이터는 Windows 도메인에 연결되지 않고 호스트 컴퓨터와 도메인 또는 작업 그룹 자격 증명을 공유하지 않습니다.It is not joined to a Windows domain and it does not share domain or workgroup credentials with the host computer.

네트워크에 기본 네트워크 및 인터넷 연결을 위한 도메인 또는 작업 그룹 권한 부여가 필요한 경우 IT 관리자에게 예외에 대해 문의합니다.If your network requires domain or workgroup authorization for basic network and Internet connectivity, contact your IT administrator for an exception. 이 예외를 사용하여 개발 컴퓨터는 경계 시스템으로 작동할 수 있고 에뮬레이터와 같은 도메인에 연결되지 않은 네트워크 장치에서의 연결을 허용할 수 있습니다.This exception allows your development computer to serve as a boundary machine and to accept connections from non-domain-joined network devices like the emulator.

Android용 Visual Studio 에뮬레이터는 또한 고유한 MAC 주소 집합을 사용합니다.The Visual Studio Emulator for Android also uses its own set of MAC addresses. 에뮬레이터에서 네트워크 또는 인터넷 리소스에 액세스할 수 없으면 IT 관리자에게 에뮬레이터의 MAC 주소가 네트워크에서 허가되었는지 확인합니다.If you can't access network or Internet resources from the emulator, check with your IT administrator to make sure that the emulator's MAC addresses have been authorized on your network.

에뮬레이터의 MAC 주소를 보려면To view the emulator's MAC addresses

  1. 에뮬레이터를 시작합니다.Launch the emulator.

  2. 에뮬레이터 도구 모음에서 펼침 단추(>>)를 클릭하여 추가 도구 창을 엽니다.On the emulator toolbar, click the chevron button (>>) to open the Additional Tools window.

  3. 추가 도구 창에서 네트워크 탭을 클릭합니다.In the Additional Tools window, click the Network tab.

  4. 네트워크 페이지에서 실제 주소 항목을 찾습니다.On the Network page, locate the Physical address entries.

네트워크 설정에 수동 구성이 필요할 때 네트워크 대상에 연결할 수 없음Cannot connect to network destinations when network settings require manual configuration

에뮬레이터에서 네트워크 대상에 연결하려면 네트워크가 다음 요구 사항을 충족해야 합니다.To connect to network destinations from the emulator, your network must meet the following requirements:

  • DHCP.DHCP. 에뮬레이터는 네트워크에서 자체 IP 주소를 갖는 별도의 장치로 구성되므로 DHCP가 필요합니다.The emulator requires DHCP because it configures itself as a separate device on the network with its own IP address.

  • 자동으로 구성된 DNS 및 게이트웨이 설정.Automatically configured DNS and gateway settings. 에뮬레이터에 대해 DNS 및 게이트웨이 설정을 수동으로 구성할 수 없습니다.It's not possible to configure DNS and gateway settings manually for the emulator.

    네트워크에 수동으로 구성된 설정이 필요한 경우 IT 관리자에게 에뮬레이터에 대한 네트워크 연결을 설정하는 방법을 확인합니다.If your network requires manually configured settings, check with your IT administrator to determine how you can enable network connectivity for the emulator.

에뮬레이터가 느려지기 시작하거나, 시간 초과로 인해 시작되지 못하거나, 앱 배포가 실패함Emulator starts slowly, fails to start due to a timeout, or app deployment fails

특정 상황에서 에뮬레이터는 시작하는 데 몇 분 정도 소요되거나 시간 초과로 인해 시작되지 않습니다.Under certain conditions, the emulator takes several minutes to start or fails to start due to a timeout. 에뮬레이터를 시작하지 못하면 다음 메시지가 나타납니다. App deployment failed. Please try again.When the emulator fails to start, you see the following message: App deployment failed. Please try again. 이 오류는 다음과 같은 상황에서 발생할 수 있습니다.The following conditions can result in this error.

  • 부팅 가능 VHD에서 Android용 Visual Studio 에뮬레이터를 실행하고 있습니다.Running the Visual Studio Emulator for Android from a bootable VHD. 이 구성은 지원되지 않습니다.This configuration is not supported.

  • 하드 드라이브에 결함이 있습니다.A faulty hard drive. chkdsk 프로그램 실행을 고려합니다.Consider running the chkdsk program.

  • 하드 드라이브에 조각 모음이 필요합니다.A hard drive that needs to be defragmented. 드라이브 조각 모음을 고려합니다.Consider defragmenting the drive.

  • 하드 드라이브가 거의 가득 찼습니다.A hard drive that is almost full. 드라이브의 사용 가능한 공간을 확인합니다.Check the space available on the drive.

  • 실행 중인 다른 응용 프로그램으로 인해 메모리가 부족합니다.Not enough memory is available because of other running applications. 메모리를 소비하는 응용 프로그램의 수를 줄이거나 메모리 양을 늘립니다.Reduce the number of applications that are consuming memory or increase the amount of memory.

  • 일반적으로 시스템의 성능 저하는 다양한 요인에 의해 발생할 수 있습니다.Generally, any factor that is contributing to poor performance on the system. 제어판의 성능 정보 및 도구 페이지에서 찾을 수 있는 Windows 체험 지수에서 항목별 점수가 가장 낮은 구성 요소의 문제부터 해결합니다.Begin troubleshooting with the component that has the lowest subscore in the Windows Experience Index, which you can find on the Performance Information and Tools page of Control Panel.

에뮬레이터 시작 실패Emulator fails to start

에뮬레이터가 기존에 작동했지만 지금은 작동하지 않는 경우 다음 작업을 수행합니다.If the emulator was working previously, but does not work now, go through the following tasks. 에뮬레이터를 처음으로 사용하는 경우 이 단계를 시도하기 전에 Emulator fails to start (first use) 를 참조하세요.If you are using the emulator for the first time, see Emulator fails to start (first use) before you try these steps.

  • 에뮬레이터의 다른 Hyper-V 인스턴스를 제거합니다.Remove any other Hyper-V instances of the emulator.

    1. Visual Studio를 닫습니다.Close Visual Studio.

    2. Hyper-V 관리자를 열고 이미 실행 중이지만 손상된 상태일 수 있는 에뮬레이터(가상 컴퓨터)의 Hyper-V 인스턴스를 모두 중지합니다.Open Hyper-V Manager and stop any Hyper-V instances of the Emulator (Virtual Machines) that are already running and possibly in a corrupt state.

    3. Hyper-V 관리자에서 다른 에뮬레이터 VM을 삭제합니다.In Hyper-V Manager, delete any other emulator VMs.

    4. 컴퓨터를 다시 부팅합니다.Reboot your machine.

  • 4GB 이상의 시스템 메모리가 있는지와 이 메모리가 다른 리소스 집약적 프로그램 및 프로세스에서 사용되고 있지 않은지 확인합니다. 예를 들어 브라우저 창을 닫아 봅니다.Make sure you have at least 4GB system memory and that it is not being consumed by other resource-intensive programs and processes (for example, try closing any browser windows).

  • Hyper-V 관리자에 가상 스위치 관리자를 열고 네트워크 스위치가 2개 있고, 첫 번째는 내부 스위치, 두 번째는 외부 스위치인지 확인합니다.In Hyper-V Manager, open the Virtual Switch Manager and check to see that you have two network switches; verify that the first one is the internal switch and the second is external.

    Android_Emu_V_Switch_ManAndroid_Emu_V_Switch_Man

    설치가 잘못되고 Windows 10을 사용 중인 경우 netcfg – d 명령을 사용하여 네트워크 장치를 다시 설치할 수 있습니다(섹션 6).If the setup is incorrect and you are using Windows 10, you might try to Reinstall network devices using netcfg -d command (section 6).

  • 이러한 단계로도 문제가 해결되지 않으면 Emulator fails to start (first use) 에서 에뮬레이터에 방해가 될 수 있는 타사 소프트웨어에 대한 정보를 확인하세요.If these steps do not resolve the issue, see Emulator fails to start (first use) for information on 3rd party software that may be interfering with the emulator.

Emulator fails to start (first use)Emulator fails to start (first use)

에뮬레이터가 시작되지 않으면 다음 작업을 수행하여 문제를 확인하고 해결합니다.If the emulator does not start, go through the following tasks to identify and fix the issue.

  • 최소 하드웨어 요구 사항이 충족되는지와 BIOS 설정이 올바른지 확인합니다.Make sure that minimum hardware requirements are fulfilled and that BIOS settings are correct.

    이 에뮬레이터와 Windows 8 Hyper-V에는 SLAT(두 번째 수준 주소 변환)를 지원하는 64비트 프로세서가 필요합니다.The Emulator and Windows 8 Hyper-V require a 64-bit processor with Second Level Address Translation (SLAT). Intel의 경우는 기본적으로 Core i3, i5 또는 i7 프로세서(또는 여러 Xeon 모델 하나)가 필요합니다.For Intel, you essentially need a Core i3, i5 or i7 processor (or one of many Xeons). AMD 칩의 목록은 여기에서 확인할 수 있습니다.A list of AMD chips is available here.

    1. 사용하는 컴퓨터가 시스템 요구 사항을 충족하는지 확인합니다.Make sure your computer meets the system requirements.

    2. SLAT 도구 에서 컴퓨터의 SLAT 지원 여부를 보고하는지 확인합니다.Verify that the SLAT tool reports that your computer is SLAT capable.

    3. 컴퓨터의 BIOS 설정 내에서 모든 가상화 기술을 사용되도록 설정되어 있는지 확인합니다.Within the BIOS settings of your computer, make sure that all virtualization technology is enabled. 각 하드웨어 제조업체에 대해 정확한 BIOS 설명이 다를 수 있습니다.The exact BIOS descriptions may vary for each hardware manufacturer. 일반적으로 다음과 관련된 기능을 사용하도록 설정합니다.In general, enable features related to:

      • SLAT(두 번째 수준 주소 변환)SLAT (Second Level Address Translation)

      • EPT(확장 페이지 테이블)(Intel)EPT (Extended Page Tables) (Intel)

      • NPT(중첩된 페이지 테이블)(AMD)NPT (Nested Page Tables) (AMD)

      • RVI(신속한 가상화 인덱싱)(AMD)RVI (Rapid Virtualization Indexing) (AMD)

      • VMX(하드웨어 지원 가상화 지원을 나타내는 Intel 머리글자어)VMX (an Intel acronym indicating hardware assisted virtualization support)

      • SVM(하드웨어 지원 가상화 지원을 나타내는 AMD 머리글자어)SVM (an AMD acronym indicating hardware assisted virtualization support)

      • XD(Execute Disable)(Intel). 사용하도록 설정해야 합니다.XD (Execute Disable) (Intel); this must be enabled

      • NX(No Execute)(AMD). 사용하도록 설정해야 합니다.NX (No Execute)(AMD); this must be enabled.

    4. BIOS에 다음 옵션이 있는 경우 사용하지 않도록 설정합니다.If the following options are present in the BIOS, disable them.

      • Intel VT-d 사용 안 함Disable Intel VT-d

      • 신뢰할 수 있는 실행 사용 안 함Disable Trusted Execution

        자세한 내용은 다음 문서를 참조하세요. Technet: Hyper-V: Hyper-V를 사용하도록 설정하는 동안 BIOS 오류를 해결하는 방법For more information, see this article: Technet: Hyper-V: How to Fix BIOS Errors Enabling Hyper-V

    5. 4GB 이상의 시스템 메모리가 있는지와 이 메모리가 다른 리소스 집약적 프로그램 및 프로세스에서 사용되고 있지 않은지 확인합니다.Make sure you have at least 4GB system memory and that it is not being consumed by other resource-intensive programs and processes.

    6. Windows 8 Professional 이상을 실행하고 있는지 확인합니다(Windows Server 2008은 지원되지 않음).Make sure you are running Windows 8 Professional or better (Windows Server 2008 is not supported). Windows Server 2012는 지원되지만 데스크톱 경험 기능을 사용하도록 설정해야 합니다.Windows Server 2012 is supported, but you must enable Desktop Experience.

      이벤트 뷰어를 검사하여 하이퍼바이저 오류가 있는지 확인할 수 있습니다.You can inspect the Event Viewer to see if there are any Hypervisor errors. 이 작업을 수행하려면 이벤트 뷰어를 열고(시작 키+R을 입력한 다음 eventvwr입력) Windows 로그, 시스템을 선택합니다.To do this, open Event Viewer (Start key + R, then type eventvwr) and then select Windows Logs, System. 그런 후 소스를 Hyper-V-Hypervisor로 설정하고 이벤트 소스별로 로그를 필터링합니다.Then filter the log by event source, setting the source to Hyper-V-Hypervisor. 근본 원인을 파악하는 데 도움이 되도록 오류를 확인하세요.Check for errors to help identify root cause.

      프로세서가 최소 요구 사항을 충족하지만 하이퍼바이저에 계속 오류가 발생하는 경우 컴퓨터에 사용할 수 있는 BIOS 업그레이드가 있는지 확인하세요.If your processor meets the minimum requirements but hypervisor is still failing, consider finding out if there is a BIOS upgrade available for your computer. 업그레이드가 있고 적용하기로 선택한 경우 BIOS를 업그레이드할 때 제조업체에서 제공한 모든 사전 예방 조치를 준수합니다(예를 들어 전력 손실로 인해 BIOS 펌웨어 업그레이드가 중단될 경우 BIOS가 영구히 손상될 수 있으므로 주의할 것).If there is one, and you choose to upgrade, be sure to observe all precautions from the manufacturer when upgrading the BIOS (such as making sure the BIOS firmware upgrade is not interrupted by a power loss, which may permanently corrupt the BIOS).

  • 4GB 이상의 시스템 메모리가 있는지와 이 메모리가 다른 리소스 집약적 프로그램 및 프로세스에서 사용되고 있지 않은지 확인합니다.Make sure you have at least 4GB system memory and that it is not being consumed by other resource-intensive programs and processes.

  • 가상 네트워킹에 방해가 될 수 있는 타사 드라이버 또는 소프트웨어를 제거/사용하지 않도록 설정합니다.Remove/Disable third party drivers or software that may be interfering with virtual networking.

    Hyper-V 네트워킹 스택과 완전히 호환되지는 않는 네트워킹 드라이버/프로토콜 등, Windows 8에 설치된 일부 타사 제품의 알려진 문제가 있습니다.There are some known issues with some 3rd party products installed under Windows 8 such as networking drivers/protocols that are not fully compatible with the Hyper-V networking stack.

    일반적으로 Windows 8 및 Hyper-V와 호환되도록 해당 소프트웨어를 업데이트하는 작업은 해당 제품 개발자가 진행해야 합니다.In general, it will be up to the developers of those products to update their software to be compatible with Windows 8 and Hyper-V.

    Windows 8 규정 준수를 위해 VirtualBox, Virtual PC 7, VMWare, 일부 VPN 클라이언트, 소프트웨어 방화벽, 일부 Cisco VPN 클라이언트 버전 및 기타 가상화 시스템의 업그레이드가 필요할 수 있습니다.The following products may require upgrading for Windows 8 compliance: VirtualBox, Virtual PC 7, VMWare, some VPN clients, software firewalls, some versions of the Cisco VPN clients, and other virtualization systems. 문제가 있을 수 있는 가상화 소프트웨어의 개발자에게 Windows 8 및 Hyper-V와 호환되도록 소프트웨어를 업그레이드하도록 권장하세요.Work with the developer of the questionable virtualization software to encourage them to upgrade the software to make it compatible with Windows 8 and Hyper-V.

    해결 방법으로, 에뮬레이터에서 Visual Studio와 통신하는 데 사용하는 가상 네트워크에 방해가 될 수 있는 모든 타사 드라이버 및 응용 프로그램을 사용하지 않도록 설정할 수 있습니다.As a Workaround, you can disable all third party drivers and applications which may be interfering with the virtual network used by the Emulator to communicate with Visual Studio. 이러한 응용 프로그램에는 다음이 포함될 수 있습니다.These applications may include:

    • 바이러스 백신 응용 프로그램(네트워크 스택에 연결)Antivirus applications (which hook into the network stack)

    • 네트워크 모니터링 도구Network monitoring tools

    • 네트워크 로깅 도구Network logging tools

    • 기타 시스템 모니터링 소프트웨어Other system monitoring software

      가능한 다른 해결 방법으로, 문제의 제품을 제거하고 제품 개발자에게 업데이트된 버전을 릴리스할 것을 요청하는 것 외에 다음 단계를 수행합니다.Another possible workaround, short of uninstalling the product(s) in question (and requesting the product developer to release an updated version), is to take the following steps.

    1. 네트워크 연결 관리자를 시작합니다(시작 화면에서 View Network Connections 을 입력하고 이 옵션을 선택하여 네트워크 연결 보기).Start the Network Connections manager (from the Start screen, type View Network Connections and select this option to view the network connections.)

    2. vEthernet(내부 이더넷 포트 Windows Phone 에뮬레이터 내부 스위치) 어댑터에 대해 상황에 맞는 메뉴에서 속성 을 선택합니다.For the vEthernet (Internal Ethernet Port Windows Phone Emulator Internal Switch) adapter, choose Properties from the context menu.

      Hyper-V에서 사용되는 가상 어댑터Virtual Adapter used by Hyper-V

      어댑터 속성은 다음과 같습니다.The adapter properties are shown here.

      가상 어댑터 속성Virtual Adapter Properties

    3. 이 어댑터에 대해 이 연결에 다음 항목 사용 에서 선택해야 하는 유일한 항목은 다음과 같습니다.For this adapter, the only items that should be selected under This connection uses the following items should be the following:

      • Microsoft Networks용 클라이언트Client for Microsoft Networks

      • QoS 패킷 스케줄러QoS Packet Scheduler

      • Microsoft Networks에 대한 파일 및 프린터 공유File and Printer Sharing for Microsoft Networks

      • Microsoft LLDP 프로토콜 드라이버Microsoft LLDP Protocol Driver

      • 연결 계층 토폴로지 검색 매퍼 I/O 드라이버Link-Layer Topology Discovery Mapper I/O Driver

      • 연결 계층 토폴로지 검색 응답기Link-Layer Topology Discovery Responder

      • 인터넷 프로토콜 버전 6(TCP/IPv6)Internet Protocol Version 6 (TCP/IPv6)

      • 인터넷 프로토콜 버전 4(TCP/IPv4)Internet Protocol Version 4 (TCP/IPv4)

    4. 다른 모든 항목은 선택 취소합니다.Deselect any other items.

      이 기법을 사용할 때의 단점은 새로운 타사 제품이 지원되지 않는 드라이버를 설치하거나, 에뮬레이터가 설치될 때마다 이러한 단계를 반복해야 한다는 것입니다.The downside to using this technique is that any time a new 3rd party product installs unsupported drivers, or any time the emulator is installed, these steps will need to be repeated.

      타사 제품을 제거한 후 Windows Phone 에뮬레이터 내부 스위치를 복원해야 할 수 있습니다.After uninstalling third party products you may need to restore the Windows Phone Emulator Internal Switch. 수행할 작업To do that:

    • Hyper-V를 열고 가상 스위치 관리자로 이동합니다.Open Hyper V and go into the Virtual Switch Manager. "Windows Phone 에뮬레이터 내부 스위치"라는 가상 스위치를 만들고 해당 연결 형식을 내부 네트워크로 설정합니다.Create a virtual switch named "Windows Phone Emulator Internal Switch" and set its connection type to Internal network.

      가상 스위치 관리자Virtual Switch Manager

      이제 에뮬레이터를 시작합니다.Now launch the emulator. 에뮬레이터가 작동됩니다.It should work.

에뮬레이터를 설치한 후 컴퓨터 부팅 실패Computer fails to boot after installing the Emulator

이 문제는 다음 조건에 해당되는 경우 발생할 수 있습니다.This problem can occur when the following conditions are true:

  • 컴퓨터에 Gigabyte 마더보드가 있습니다.Your computer has a Gigabyte motherboard.

  • 이 마더보드에서 USB3이 사용되도록 설정되어 있습니다.USB3 is enabled on the motherboard.

    이 문제를 해결하려면 마더보드의 BIOS 설정에서 USB3를 사용하지 않도록 설정하고 컴퓨터를 다시 부팅합니다.To solve this problem, disable USB3 in the BIOS settings of the motherboard and reboot the computer. 그런 후 Gigabyte에서 이 마더보드의 BIOS에 대한 업데이트를 출시했는지 확인합니다.Then check whether Gigabyte has released an update for your motherboard's BIOS.

    자세한 내용은 기술 자료 문서 Gigabyte 시스템에서 Hyper-V 역할을 설치한 후 부팅 오류 발생을 참조하세요.For more info, see the following Knowledge Base article: Boot failure after installation of Hyper-V role on Gigabyte systems.

Visual Studio가 앱을 에뮬레이터에 배포하는 동안 중지되거나 에뮬레이터가 다른 IDE에 디버그 대상으로 표시되지 않습니다.Visual Studio gets stuck trying to deploy the app to the emulator or the emulator does not appear as a debug target in other IDEs

에뮬레이터를 실행하고 있지만 ADB(Android 디버그 브리지)에 연결된 것으로 나타나지 않거나 ADB를 사용하는 Android 도구(예: Android Studio 또는 Eclipse)에 나타나지 않는 경우 에뮬레이터가 ADB를 찾는 위치를 조정해야 할 수 있습니다.If the emulator is running, but it does not appear to be connected to ADB (Android Debug Bridge) or it does not appear in Android tools that make use of ADB (for example, Android Studio or Eclipse), you may need to adjust where the emulator looks for ADB. 에뮬레이터는 레지스트리 키를 사용하여 Android SDK의 기본 위치를 식별하고 해당 디렉터리에서 \platform-tools\adb.exe 파일을 찾습니다.The emulator uses a registry key to identify the base location of your Android SDK, and looks for the \platform-tools\adb.exe file under that directory. 에뮬레이터에서 사용하는 Android SDK 경로를 수정하려면To modify the Android SDK path used by the emulator:

  • 시작 단추 상황에 맞는 메뉴에서 실행 을 선택하고 대화 상자에 regedit 를 입력한 다음 확인을 선택하여 레지스트리 편집기를 엽니다.Open Registry Editor by selecting Run from the Start buttons context menu, typing regedit in the dialog box, and choosing OK.

  • 왼쪽의 폴더 트리에서 HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Android SDK Tools로 이동합니다.Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Android SDK Tools in the folder tree on the left.

  • Android SDK의 경로와 일치하도록 Path 레지스트리 변수를 수정합니다.Modify the Path registry variable to match the path to your Android SDK.

    에뮬레이터를 다시 시작하면 에뮬레이터가 ADB 및 관련 Android 도구에 연결되어 있는 것을 확인할 수 있어야 합니다.Restart the emulator and you should now be able to see the emulator connected to ADB and associated Android tools.

에뮬레이터가 UDP 포트를 설정하지 못해서 중지됩니다.Emulator hangs because it couldn't set up the UDP port

Xamarin Player와의 비호환성으로 인해 이 문제가 발생할 수 있습니다.You may experience this issue due to incompatibility with Xamarin Player. 에뮬레이터가 응답하지 않거나 “에뮬레이터가 장치 운영 체제에 연결할 수 없음: UDP 포트를 설정할 수 없습니다.If the emulator appears to hang or if you see this error message, "The emulator is unable to connect to the device operating system: Couldn't set up the UDP port. 일부 기능을 사용할 수 없습니다”와 같은 오류 메시지가 표시되는 경우 이 문제가 발생할 수 있습니다.Some functionality might be disabled", you may be experiencing this issue. 다음 단계를 수행합니다.Take the following steps.

  1. Xamarin Player를 제거합니다.Uninstall Xamarin Player.

  2. Virtual Box가 제거되었는지 확인합니다(Xamarin Player는 Virtual Box에서 실행됨).Verify that virtual box has been removed (Xamarin Player runs on top of virtual box).

  3. 장치 관리자로 이동하고 숨겨진 장치를 표시하는 옵션을 선택한 다음 실제 네트워크 카드를 제외하고 모든 장치를 삭제합니다.Go to device manager, select the option to show hidden devices, and then delete everything except the physical network cards.

  4. 실제 네트워크 어댑터 외의 장치를 모두 제거한 후 Hyper-V를 제거했다가 다시 설치해 볼 수 있습니다.You can try uninstalling/reinstalling Hyper-V after removing any non-physical network adapters.

Xamarin 프로젝트에 디버거를 연결할 수 없음Cannot attach debugger to a Xamarin project

Intel Skylake 프로세서를 사용하여 Windows 10을 실행하는 경우 에뮬레이터에서 Xamarin 앱을 실행할 수 없거나 Visual Studio 디버거가 앱에 연결되지 않을 수 있습니다.If you are running Windows 10 with Intel Skylake processors, Xamarin apps might fail to run in the emulator or the Visual Studio debugger might not attach to them. 이러한 현상은 Hyper-V 및 Skylake 프로세서의 문제로 인해 발생합니다.This is due to an issue with Hyper-V and Skylake processors. 이러한 문제를 해결하려면 다음 단계를 수행합니다.Take the following steps as a workaround.

  1. Hyper-V 관리자를 열고 사용 중인 에뮬레이터 프로필용 VM을 선택합니다.Open Hyper-V Manager and select the VM for the emulator profile that your are using.

  2. 오른쪽 아래에 있는 저장된 상태 삭제를 선택합니다.Select Delete Saved State (lower right).

  3. 설정...을 선택합니다.Choose Settings...

  4. 프로세서 노드를 확장하고 호환성을 선택합니다.Expand the processor node and choose Compatibility.

  5. 다른 프로세서 버전을 사용하는 물리적 컴퓨터로 마이그레이션을 사용하도록 설정합니다.Enable Migrate to a physical computer with a different processor version.

  6. 작업 아래에서 서비스를 다시 시작한 후에 다시 시도합니다.Restart the service (under Actions) and try again.

에뮬레이터가 Google Play 서비스를 사용하는 앱을 실행하지 못함Emulator fails to run app that uses Google Play Services

에뮬레이터에 Google Play 서비스용 라이브러리가 함께 제공되지 않습니다.The emulator does not ship with the libraries for Google Play Services. 그러나 에뮬레이터는 플래시 가능 zip 파일의 끌어서 놓기 설치를 지원합니다.However, the emulator does support drag-and-drop installation of flashable zip files.

파일 끌어서 놓기, APK 또는 플래시 가능 zip 파일이 작동하지 않습니다.Drag and Drop of a file, APK, or flashable zip file does not work

사용자가 화면에 파일을 끌어다 놓으면 에뮬레이터는 ADB.exe를 사용하여 화면에 파일을 전송합니다.The emulator uses ADB.exe to facilitate file transfer when you drag and drop a file onto the screen. 파일을 끌어다 놓으려 할 때 오류가 발생하면 에뮬레이터가 ADB.exe에 연결되지 않은 것일 수 있습니다.If you encounter an error when you try to drag and drop a file, this probably indicates that the emulator is not connected to ADB.exe. 해결하려면 Visual Studio가 앱을 에뮬레이터에 배포하는 동안 중지되거나 에뮬레이터가 다른 IDE에 디버그 대상으로 표시되지 않습니다.에서 확인할 수 있습니다.To resolve, follow steps in Visual Studio gets stuck trying to deploy the app to the emulator or the emulator does not appear as a debug target in other IDEs.

스크린샷의 해상도가 올바르지 않음Resolution of screenshot is incorrect

추가 도구 창에서 스크린샷 탭을 사용하여 스크린샷을 찍었으나 결과 이미지 크기가 예상과 다른 경우 캡처를 선택하기 전에 화면의 확대/축소 수준을 조정해야 할 수 있습니다.If you take a screenshot using the Screenshot tab in the Additional Tools window and the resulting image is of an unexpected size, you may need to adjust the zoom level of the screen before choosing Capture. 에뮬레이터는 호스트 PC 모니터의 화면 해상도로 스크린샷을 찍습니다.The emulator takes screenshots at the resolution of the screen on your host PC monitor.

에뮬레이터가 OpenGL 콘텐츠를 렌더링하지 못함Emulator fails to render OpenGL content

에뮬레이터는 호스트 컴퓨터의 GPU를 사용하여 OpenGL 콘텐츠를 렌더링하고 ANGLE 프로젝트를 사용하여 DirectX와의 사이에서 이러한 호출을 변환합니다.The emulator renders OpenGL content using your host machine's GPU and uses the ANGLE project to convert these calls to and from DirectX. 응용 프로그램이 장치에서는 올바르게 렌더링하지만 에뮬레이터에서는 그렇지 못할 경우 장치가 잘못된 OpenGL 호출을 완화시키는 것일 수 있습니다(예: 일치하지 않는 셰이더 변수 사용).If your application renders correctly on a device but incorrectly on the emulator, it is likely that the device is mitigating an incorrect OpenGL call (for example, using shader variables that do not match).

에뮬레이터가 멀티 터치 제스처에 응답하지 않음Emulator does not respond to multi-touch gestures

일부 경우에는 에뮬레이터가 시작되지만 터치 지원 디스플레이의 직접적인 조작을 통해 또는 에뮬레이터 도구 모음의 멀티 터치 도구를 사용하여 멀티 터치에 응답하지 않습니다.In some cases, the emulator will start and not respond to multi-touch either through direct interaction from your touch-enabled display or using the Multi-Touch Tool on the emulator toolbar. 이러한 경우 에뮬레이터 도구 모음에서 회전 단추를 선택하고 멀티 터치를 다시 사용해 봅니다.If this is the case, choose the Rotate button on the emulator toolbar and attempt to use multi-touch again. 문제가 계속되면 에뮬레이터가 OpenGL 콘텐츠를 렌더링하지 못함 문제를 확인하세요.If the issue persists, read the Emulator fails to render OpenGL content issue.

지원 리소스Support Resources

호스트 컴퓨터가 시스템 요구 사항을 충족한 상태에서 이 문제 해결 가이드에서 다루지 않은 문제가 발생하는 경우:If your host computer meets the system requirements and you encounter an issue not covered in this troubleshooting guide:

  • Android 에뮬레이터 및 visual-studio 태그를 사용하여 StackOverflow에 대해 질문합니다.Ask a question on StackOverflow using the android-emulator and visual-studio tags.

  • Visual Studio 또는 에뮬레이터 관리자에서 웃는 얼굴 보내기 도구를 사용하여 문제를 보고합니다.Report an issue using the Send a Smile tool in Visual Studio or in the Emulator Manager.