Xamarin 환경 확인Verify your Xamarin environment

설치 관리자가 완료되면( Setup and install참조) 몇 분 동안 Xamarin 개발을 경험할 모든 준비가 되었는지 확인하세요.Once the installers have completed (see Setup and install), spend a few minutes to verify that everything is ready to experience Xamarin development.

설치 확인을 완료했으면 다음 연습 중 하나 또는 모두를 시도합니다.Once you have finished verifying the installation, try either or both of the following walkthroughs:

모든 플랫폼All platforms

Visual Studio에서 먼저 도구 > 확장 및 업데이트를 선택하고 Xamarin 구성 요소를 업데이트해야 하는지 확인합니다.In Visual Studio, first select Tools > Extensions and Updates and check if any of the Xamarin components require updates.

그런 다음, 파일 > 새 프로젝트를 사용하여 Visual Studio에서 새 Xamarin.Forms 솔루션을 만듭니다.Then, create a new Xamarin.Forms solution in Visual Studio using File > New Project. 대화 상자에서 Visual C# > 플랫폼 간을 확장하고 모바일 앱(Xamarin.Forms) 을 선택한 후, 확인을 클릭합니다.In the dialog, expand Visual C# > Cross-Platform, select Mobile App (Xamarin.Forms), and click OK. 이어지는 대화 상자에서 비어 있는 앱을 선택합니다.In the dialog that follows, select Blank App. 코드 공유 전략에서 .NET Standard를 선택합니다.Under Code Sharing Strategy, select .NET Standard. 확인을 클릭합니다.Click OK.

이러한 작업으로 공유 .NET Standard 2.0 라이브러리 프로젝트와 Android, iOS 및 UWP(유니버설 Windows 플랫폼)에 대한 응용 프로그램 프로젝트의 4개 프로젝트를 사용한 솔루션이 만들어집니다.These actions create a solution with four projects: a shared .NET Standard 2.0 library project and application projects for Android, iOS, and the Universal Windows Platform (UWP):

비어 있는 Xamarin.Forms 템플릿에서 새 프로젝트를 만들기의 결과Results of creating a new project from the Blank App Xamarin.Forms template

AndroidAndroid

  1. 도구 > Android > Android SDK 관리자로 이동하여 최신 Android SDK 도구가 설치되어 있는지 확인합니다.Check that you have the latest Android SDK tools installed by going to Tools > Android > Android SDK Manager. 최신 버전의 Android SDK 도구, Android SDK 플랫폼 도구 및 Android SDK 빌드 도구를 설치합니다.Install the newest versions of the Android SDK Tools, Android SDK Platform tools, and Android SDK Build tools. 항상 최신 Android API 수준을 설치할 필요는 없습니다.It is not necessary to always install the latest Android API level. 필요한 API 수준은 대상으로 지정할 플랫폼 수준에 따라 달라집니다.The API level you need depends on the platform level you want to target. 일반적으로 Xamarin 플랫폼을 설치하면 필요한 Android 플랫폼 수준이 설치됩니다.In general, installing the Xamarin platform will install the Android platform level it requires.

  2. 장치 또는 에뮬레이터에서 빌드 및 디버깅 확인:Validate building and debugging on a device or emulator:

    • 솔루션 탐색기에서 Android 프로젝트를 마우스 오른쪽 단추로 클릭하고 시작 프로젝트로 설정을 선택합니다.Right-click the Android project in Solution Explorer and select Set as Startup Project.

    • 도구 모음에서 사용 가능한 Android 장치 및 에뮬레이터 목록이 들어 있는 드롭다운이 표시되어야 합니다.In the toolbar, you should see a drop-down containing a list of available Android devices and emulators.

    장치의 설정 페이지에 있는 개발자 옵션에서 Android 장치를 USB 디버깅에 대해 사용하도록 설정해야 합니다.Android devices must be enabled for USB debugging in the Developer options of the device's Settings page. 그런 다음, 장치가 USB 케이블을 통해 컴퓨터에 연결됩니다.The device is then attached to the computer by USB cable.

    또한 목록은 에뮬레이터입니다.Also listed are emulators. 장치 또는 Visual Studio 에뮬레이터 중 하나를 선택합니다.Select one of the devices or Visual Studio emulators:

    Visual Studio Emulator for Android를 디버그 대상으로 선택Selecting the Visual Studio Emulator for Android as a debug target

    자세한 내용은 Introducing Visual Studio's Emulator for Android(Visual Studio Emulator for Android 소개) (Visual Studio ALM 블로그)를 참조하세요.For more detailed information, see Introducing Visual Studio's Emulator for Android (Visual Studio ALM blog). 에뮬레이터를 작동시키는 중 문제가 발생하면 Troubleshooting the Visual Studio Emulator for Android을 참조하세요.If you encounter problems getting the emulator to work, see Troubleshooting the Visual Studio Emulator for Android. 도구 > Android > Android Emulator 관리자를 선택하여 에뮬레이터에 대한 새로운 장치 프로필을 만들 수도 있습니다.You can also create new device profiles for the emulator by selecting Tools > Android > Android Emulator Manager.

  3. F5 키를 눌러 컴파일하고 프로그램을 Android 장치 또는 에뮬레이터에 배포합니다.Press F5 to compile and deploy the program to the Android device or emulator.

WindowsWindows

  1. 솔루션 탐색기에서 유니버설 Windows 프로젝트를 마우스 오른쪽 단추로 클릭하고 시작 프로젝트로 설정을 선택합니다.Right-click the Universal Windows project in Solution Explorer and select Set as Startup Project.

  2. 솔루션 플랫폼 드롭다운 목록에서 x86 또는 x64를 선택합니다.In the Solution Platforms drop-down, select x86 or x64. 로컬 컴퓨터를 선택합니다.Select Local Machine.

  3. F5 키를 눌러 바탕 화면에 프로그램을 배포합니다.Press F5 to deploy the program to the desktop.

iOSiOS

  1. Mac에 연결에 설명된 대로 Mac이 네트워크에서 사용 가능하고 Visual Studio와 연결되었는지 확인합니다.Make sure your Mac is available on the network and paired with Visual Studio as described on Connecting to the Mac.

  2. 솔루션 탐색기에서 iOS 프로젝트를 마우스 오른쪽 단추로 클릭하고 시작 프로젝트로 설정을 선택합니다.Right-click the iOS project in Solution Explorer and select Set as Startup Project.

  3. 아래 표시된 대로 Visual Studio의 빌드 드롭다운에서 iPhoneSimulator 대상을 선택하거나 Mac에 테더링된 장치가 있는 경우 iPhone 대상을 선택합니다.Select the iPhoneSimulator target from Visual Studio's build drop-down as shown below, or the iPhone target if you have a device tethered to the Mac.

    IPhoneSimulator 빌드 대상 선택Selecting the iPhoneSimulator build target

    시뮬레이터가 나열되지 않으면 Mac에서 Xcode를 시작하고 Xcode > 기본 설정을 선택한 후에 다운로드를 클릭합니다.If no simulators are listed, launch Xcode on your Mac, select Xcode > Preferences, and click Download. 구성 요소 제목에서 다운로드할 수 있는 시뮬레이터 버전이 표시되어야 합니다.Under the Components heading you should see the simulator versions that are available to download. 디버깅에 대한 추가 지침은 iOS 디버깅 페이지에서 확인할 수 있습니다.Additional instructions for debugging can be found on the iOS Debugging page.

  4. Visual Studio 드롭다운에서 에뮬레이터 장치 대상을 선택합니다.Select an emulator device target from the Visual Studio drop-down:

    iPhone 디버그 대상 선택Selecting an iPhone debug target

  5. F5 키를 눌러 디버거를 시작합니다.Start the debugger by pressing F5. 앱을 조작할 Mac에서 시뮬레이터가 시작되고 동시에 Visual Studio에서 디버깅이 수행됩니다.The simulator is launched on the Mac where you'll interact with the app, while debugging happens in Visual Studio. 물리적 iPhone 또는 iPad가 Mac에 연결되어 있으면 여기에 나타나며, 해당 iPhone 또는 iPad를 대신 선택할 수 있습니다.If you have a physical iPhone or iPad connected to the Mac, it will appear on the list and you can select it instead. 장치 또는 시뮬레이터가 나열되지 않으면 Mac에 대한 연결을 확인합니다.If you do not see any devices or simulators listed, check the connection to the Mac. 위의 1단계에서 연결된 문서를 검토하거나 도구 > iOS > Mac에 연결로 이동합니다.Review the article linked in step 1 above, or go to Tools > iOS > Pair to Mac

  6. Mac에 연결할 때 문제가 발생하면 연결 문제 해결을 읽어 보세요.If you encounter problems connecting to the Mac, read Connection Troubleshooting.

  7. “No installed provisioning profiles match the installed iOS signing keys(설치된 프로비저닝 프로필이 설치된 iOS 서명 키와 일치하지 않습니다).”라는 오류가 표시되면 다음을 수행해 보세요.If you see an error saying "No installed provisioning profiles match the installed iOS signing keys," try the following suggestions:

    • Xcode에 사용자 계정 추가 (영문)(apple.com)에 설명된 대로 Mac의 Xcode에 Apple Id 계정이 추가되어 있는지 확인합니다.Check that your Apple Id account is added in Xcode on your Mac as described on Adding Your Account to Xcode (apple.com). 계정을 추가한 후 Visual Studio와 Xcode를 둘 다 다시 시작해야 합니다.After adding your account, be sure to restart both Visual Studio and Xcode.

    • iOS 번들 서명 탭의 iOS 프로젝트 속성에서 활성 디버그 구성을 위한 사용자 지정 권한 부여 필드가 비어 있는지 확인합니다.Verify that in your iOS project properties in the iOS bundle signing tab, that the Custom entitlement field is empty for the active debug configuration. 참고: 위의 오류 메시지가 발생하는 경우에만 이 설정을 제거합니다.Note: you should only try removing this setting if you've encountered the above error message.

    CrossPlat Xamarin Verify 8CrossPlat Xamarin Verify 8