Install and Configure Tools to Build using iOSInstall And Configure Tools to Build using iOS

플랫폼 간 모바일 개발용 Visual C++를 사용하여 iOS 코드를 편집 및 디버깅하고 iOS 시뮬레이터 또는 iOS 장치에 배포할 수 있지만 라이선스 제한으로 인해 Mac에서 코드를 빌드하고 원격으로 실행해야 합니다.You can use Visual C++ for Cross-Platform Mobile Development to edit, debug and deploy iOS code to the iOS Simulator or to an iOS device, but because of licensing restrictions, the code must be built and run remotely on a Mac. Visual Studio를 사용하여 iOS 앱을 빌드 및 실행하려면 Mac에서 원격 에이전트 vcremote를 설정 및 구성해야 합니다.To build and run iOS apps using Visual Studio, you need to set up and configure the remote agent, vcremote, on your Mac. 원격 에이전트는 Visual Studio의 빌드 요청을 처리하고 Mac에 연결된 iOS 장치 또는 Mac의 iOS 시뮬레이터에서 앱을 실행합니다.The remote agent handles build requests from Visual Studio and runs the app on an iOS device connected to the Mac, or in the iOS Simulator on the Mac.

참고

Mac이 아닌 클라우드에서 호스트되는 Mac 서비스를 사용하는 방법에 대한 자세한 내용은 Build and Simulate iOS in the Cloud를 참조하세요.For information on using cloud-hosted Mac services instead of a Mac, see Build and Simulate iOS in the Cloud. 지침은 Visual Studio Tools for Apache Cordova를 사용한 빌드에 해당합니다.The instructions are for building using Visual Studio Tools for Apache Cordova. 플랫폼 간 모바일 개발용 Visual C++를 사용한 빌드 지침을 사용하려면 vs-mda-remote를 vcremote로 대체합니다.To use the instructions to build using Visual C++ for Cross-Platform Mobile Development, substitute vcremote for vs-mda-remote.

iOS를 사용하여 빌드하는 도구를 설치한 경우 Visual Studio 및 Mac에서 iOS 개발용 원격 에이전트를 신속하게 구성 및 업데이트하는 방법은 이 항목을 참조하세요.Once you have installed the tools to build using iOS, refer to this topic for ways to quickly configure and update the remote agent for iOS development in Visual Studio and on your Mac.

필수 조건Prerequisites

iOS용 원격 에이전트 설치Install the remote agent for iOS

원격 에이전트 시작Start the remote agent

Visual Studio에서 원격 에이전트 구성Configure the remote agent in Visual Studio

Generate a new security PINGenerate a new security PIN

새 서버 인증서 생성Generate a new server certificate

Configure the remote agent on the MacConfigure the remote agent on the Mac

필수 조건Prerequisites

원격 에이전트를 설치 및 사용하여 iOS용 코드를 개발하려면 다음 필수 조건이 있어야 합니다.To install and use the remote agent to develop code for iOS, you must first have these prerequisites:

  • OS X Mavericks 이상을 실행하는 Mac 컴퓨터A Mac computer running OS X Mavericks or later

  • Apple IDAn Apple ID

  • Apple의 활성 iOS 개발자 프로그램 계정An active iOS Developer Program account with Apple

  • Xcode 6Xcode 6

    Xcode 6은 앱 스토어에서 다운로드할 수 있습니다.Xcode 6 can be downloaded from the App Store.

  • Xcode 명령줄 도구Xcode command line tools

    Xcode 명령줄 도구를 설치하려면 Mac에서 터미널 앱을 열고 다음 명령을 입력합니다.To install the Xcode command line tools, open the Terminal app on your Mac and enter the following command:

    xcode-select --install

  • Xcode에서 구성된 iOS 서명 IDAn iOS signing identity configured in Xcode

    iOS 서명 ID를 얻는 방법에 대한 자세한 내용은 iOS 개발자 라이브러리에서 서명 ID 및 인증서 유지 관리 를 참조하세요.For detailed information on obtaining an iOS Signing Identity, see Maintaining Your Signing Identities and Certificates in the iOS Developer Library. Xcode에서 서명 ID를 보거나 설정하려면 Xcode 메뉴를 열고 기본 설정을 선택합니다.To see or set your signing identity in Xcode, open the Xcode menu and choose Preferences. 계정 을 선택하고 Apple ID를 선택한 다음 세부 정보 보기 단추를 선택합니다.Select Accounts and choose your Apple ID, and then choose the View Details button.

  • 개발에 iOS 장치를 사용하는 경우 장치에 대해 Xcode에서 구성된 프로비저닝 프로필If you are using an iOS device for development, a Provisioning Profile configured in Xcode for your device

    프로비저닝 프로필을 만드는 방법에 대한 자세한 내용은 iOS 개발자 라이브러리에서 회원 센터를 사용하여 프로비저닝 프로필 만들기 를 참조하세요.For detailed information on creating provisioning Profiles, see Creating Provisioning Profiles Using Member Center in the iOS Developer Library.

  • Node.jsNode.js

  • npm의 업데이트된 버전An updated version of npm

    Node.js와 함께 제공된 npm 버전이 vcremote를 설치할 수 있을 만큼 최신 버전이 아닐 수 있습니다.The version of npm that comes with Node.js may not be recent enough to install vcremote. npm을 업데이트하려면 Mac에서 터미널 앱을 열고 다음 명령을 입력합니다.To update npm, open the Terminal app on your Mac and enter the following command:

    sudo npm install -g npm@latest

iOS용 원격 에이전트 설치Install the remote agent for iOS

플랫폼 간 모바일 개발용 Visual C++를 설치하는 경우 Visual Studio는 Mac에서 실행되는 원격 에이전트인 vcremote와 통신하여 파일을 전송하고, iOS 앱을 빌드 및 실행하고, 디버깅 명령을 보낼 수 있습니다.When you install Visual C++ for Cross-Platform Mobile Development, Visual Studio can communicate with vcremote, a remote agent running on your Mac to transfer files, build and run your iOS app, and send debugging commands.

원격 에이전트를 설치하기 전에 필수 조건 을 충족하고 플랫폼 간 모바일 개발용 Visual C++를 설치했는지 확인합니다.Before you install the remote agent, make sure you have satisfied the Prerequisites and installed Visual C++ for Cross-Platform Mobile Development.

원격 에이전트를 다운로드하여 설치하려면To download and install the remote agent

  • Mac의 터미널 앱에서 다음 명령을 입력합니다.From the Terminal app on your Mac, enter:

    sudo npm install -g --unsafe-perm vcremote

    전역 설치(-g) 스위치는 사용하는 것이 좋지만 반드시 사용할 필요는 없습니다.The global installation (-g) switch is recommended but not required.

    설치하는 동안 vcremote가 설치되고 Mac에서 개발자 모드가 활성화됩니다.During the installation, vcremote is installed and developer mode is activated on your Mac. Homebrew 및 vcremote-lib 및 vcremote-utils의 두 npm 패키지도 설치됩니다.Homebrew and two npm packages, vcremote-lib and vcremote-utils, are also installed.

    참고

    Homebrew를 설치하려면 sudo(관리자) 액세스 권한이 있어야 합니다.To install Homebrew, you must have sudo (administrator) access. sudo 액세스 권한 없이 vcremote를 설치해야 하는 경우 usr/local 위치에 Homebrew를 수동으로 설치하고 해당 bin 폴더를 사용자의 경로에 추가하면 됩니다.If you need to install vcremote without sudo, you can install Homebrew manually in a usr/local location and add its bin folder to your path. 자세한 내용은 Homebrew 설명서를 참조하세요.For more information, see the Homebrew documentation. 개발자 모드를 수동으로 사용하도록 설정하려면 터미널 앱에서 다음 명령을 입력합니다. DevToolsSecurity -enableTo manually enable developer mode, enter this command in the Terminal app: DevToolsSecurity -enable

    Visual Studio를 새 버전으로 업데이트하는 경우 현재 원격 에이전트 버전도 업데이트해야 합니다.If you update to a new version of Visual Studio, you must update to the current version of the remote agent as well. 원격 에이전트를 업데이트하려면 원격 에이전트 다운로드 및 설치 단계를 반복합니다.To update the remote agent, repeat the steps to download and install the remote agent.

원격 에이전트 시작Start the remote agent

Visual Studio에서 iOS 코드를 빌드 및 실행하려면 원격 에이전트가 실행되고 있어야 합니다.The remote agent must be running for Visual Studio to build and run your iOS code. Visual Studio가 원격 에이전트와 쌍으로 연결되어야 통신할 수 있습니다.Visual Studio must be paired with the remote agent before it can communicate. 기본적으로 원격 에이전트는 Visual Studio와 쌍으로 연결되기 위해 PIN이 필요한 보안된 연결 모드로 실행됩니다.By default, the remote agent runs in secured connection mode, which requires a PIN to pair with Visual Studio.

원격 에이전트를 시작하려면To start the remote agent

  • Mac의 터미널 앱에서 다음 명령을 입력합니다.From the Terminal app on your Mac, enter:

    vcremote

    이렇게 하면 기본 빌드 디렉터리가 ~/vcremote인 원격 에이전트가 시작됩니다.This starts the remote agent with a default build directory of ~/vcremote. 추가 구성 옵션은 Configure the remote agent on the Mac을 참조하세요.For additional configuration options, see Configure the remote agent on the Mac.

    에이전트를 처음 시작할 때 및 새 클라이언트 인증서를 만들 때마다 호스트 이름, 포트, PIN을 비롯해 Visual Studio에서 에이전트를 구성하는 데 필요한 정보가 표시됩니다.The first time you start the agent, and any time you create a new client certificate, you are provided with the required information to configure the agent in Visual Studio, including the host name, the port, and the PIN.

    vcremote를 사용하여 보안 PIN 생성Use vcremote to generate a secure PIN

    Visual Studio에서 호스트 이름을 사용하여 원격 에이전트를 구성하려는 경우 Windows에서 호스트 이름으로 Mac을 ping하여 원격 에이전트에 연결할 수 있는지 확인합니다.If you intend to configure the remote agent in Visual Studio using the host name, ping the Mac from Windows using the host name to verify that it is reachable. 그렇지 않은 경우 대신 IP 주소를 사용해야 할 수도 있습니다.Otherwise, you may need to use the IP address instead.

    생성된 PIN은 일회용이며 제한된 시간 동안만 유효합니다.The generated PIN is for one time use, and is only valid for a limited time. 시간이 만료되기 전에 Visual Studio를 원격 에이전트와 쌍으로 연결하지 않으면 새 PIN을 생성해야 합니다.If you do not pair Visual Studio with the remote agent before the time expires, you will need to generate a new PIN. 자세한 내용은 Generate a new security PIN을 참조하세요.For more information, see Generate a new security PIN.

    보안되지 않은 모드에서 원격 에이전트를 사용할 수 있습니다.You can use the remote agent in unsecured mode. 보안되지 않은 모드에서 PIN 없이 원격 에이전트를 Visual Studio와 쌍으로 연결할 수 있습니다.In unsecured mode, the remote agent can be paired to Visual Studio without a PIN.

보안된 연결 모드를 사용하지 않도록 설정하려면To disable secured connection mode

  • vcremote에서 보안된 연결 모드를 사용하지 않도록 설정하려면 Mac의 터미널 앱에서 다음 명령을 입력합니다.To disable secured connection mode in vcremote, enter this command in the Terminal app on your Mac:

    vcremote --secure false

보안된 연결 모드를 사용하도록 설정하려면To enable secured connection mode

  • 보안된 연결 모드를 사용하도록 설정하려면 다음 명령을 입력합니다.To enable secured connection mode, enter this command:

    vcremote --secure true

    원격 에이전트를 시작한 후 중지할 때까지 Visual Studio에서 사용할 수 있습니다.Once you have started the remote agent, you can use it from Visual Studio until you stop it.

원격 에이전트를 중지하려면To stop the remote agent

  • vcremote가 실행되는 터미널 창에서 Control+C를 입력합니다.In the Terminal window vcremote is running in, enter Control+C.

Visual Studio에서 원격 에이전트 구성Configure the remote agent in Visual Studio

Visual Studio에서 원격 에이전트에 연결하려면 Visual Studio 옵션에서 원격 구성을 지정해야 합니다.To connect to the remote agent from Visual Studio, you must specify the remote configuration in the Visual Studio options.

Visual Studio에서 원격 에이전트를 구성하려면To configure the remote agent from Visual Studio

  1. Mac에서 에이전트가 실행되고 있지 않은 경우 원격 에이전트 시작의 단계를 따르세요.If the agent is not already running on your Mac, follow the steps in Start the remote agent. Visual Studio가 성공적으로 쌍을 이루고 연결한 다음 프로젝트를 빌드하려면 Mac에서 vcremote를 실행해야 합니다.Your Mac must be running vcremote for Visual Studio to successfully pair, connect and build your project.

  2. Mac에서 Mac의 호스트 이름 또는 IP 주소를 가져옵니다.On your Mac, get the host name or IP address of your Mac.

    터미널 창에서 ifconfig 명령을 사용하여 IP 주소를 가져올 수 있습니다.You can get the IP address by using the ifconfig command in a Terminal window. 활성 네트워크 인터페이스 아래에 나열된 inet 주소를 사용합니다.Use the inet address listed under the active network interface.

  3. Visual Studio 메뉴 모음에서 도구, 옵션을 차례로 선택합니다.On the Visual Studio menu bar, choose Tools, Options.

  4. 옵션 대화 상자에서 플랫폼 간, C++, iOS를 확장합니다.In the Options dialog box, expand Cross Platform, C++, iOS.

  5. 호스트 이름포트 필드에서 시작할 때 원격 에이전트에 의해 지정된 값을 입력합니다.In the Host Name and Port fields, enter the values specified by the remote agent when you started it. 호스트 이름은 Mac의 DNS 이름 또는 IP 주소일 수 있습니다.The host name can be the DNS name or IP address of your Mac. 기본 포트는 3030입니다.The default port is 3030.

    참고

    호스트 이름을 사용하여 Mac을 ping할 수 없는 경우 IP 주소를 사용해야 할 수도 있습니다.If you cannot ping the Mac using the host name, you may need to use the IP address.

  6. 기본 보안된 연결 모드에서 원격 에이전트를 사용하는 경우 보안 확인란을 선택한 다음 Pin 필드에 원격 에이전트에 의해 지정된 PIN 값을 입력합니다.If you use the remote agent in the default secured connection mode, check the Secure checkbox, then enter the PIN value specified by the remote agent in the Pin field. 보안되지 않은 연결 모드에서 원격 에이전트를 사용하는 경우 보안 확인란을 선택 취소하고 Pin 필드를 비워 둡니다.If you use the remote agent in unsecured connection mode, clear the Secure checkbox and leave the Pin field blank.

  7. 연결을 선택하여 연결을 사용하도록 설정합니다.Choose Pair to enable the pairing.

    iOS 빌드에 대한 vcremote 연결 구성Configure vcremote connection for iOS builds

    호스트 이름 또는 포트를 변경할 때까지 연결이 유지됩니다.The pairing persists until you change the host name or port. 옵션 대화 상자에서 호스트 이름 또는 포트를 변경하는 경우 변경 내용을 취소하려면 되돌리기 단추를 선택하여 이전 연결로 되돌립니다.If you change the host name or port in the Options dialog box, to undo the change, choose the Revert button to revert to the previous pairing.

    연결이 성공하지 못한 경우 Start the remote agent의 단계에 따라 원격 에이전트가 실행되고 있는지 확인합니다.If the pairing does not succeed, verify that the remote agent is running by following the steps in Start the remote agent. 원격 에이전트 PIN이 생성된 이후 너무 많은 시간이 경과한 경우 Mac에서 Generate a new security PIN 의 단계를 따른 후 다시 시도합니다.If too much time has passed since the remote agent PIN was generated, follow the steps in Generate a new security PIN on the Mac and then try again. Mac의 호스트 이름을 사용하는 경우 호스트 이름 필드에 대신 IP 주소를 사용하여 시도합니다.If you are using the host name of your Mac, try using the IP address in the Host Name field instead.

  8. 원격 루트 필드의 폴더 이름을 업데이트하여 Mac의 홈(~) 디렉터리에서 원격 에이전트에 사용되는 폴더를 지정합니다.Update the folder name in the Remote Root field to specify the folder used by the remote agent in your home (~) directory on the Mac. 기본적으로 원격 에이전트는 /Users/username/vcremote를 원격 루트로 사용합니다.By default, the remote agent uses /Users/username/vcremote as the remote root.

  9. 확인 을 선택하여 원격 연결 설정을 저장합니다.Choose OK to save the remote pairing connection settings.

    Visual Studio는 사용할 때마다 동일한 정보를 사용하여 Mac의 원격 에이전트에 연결합니다.Visual Studio uses the same information to connect to the remote agent on your Mac each time you use it. Mac에서 새 보안 인증서를 생성하거나 해당 호스트 이름 또는 IP 주소가 변경되지 않는 한 Visual Studio를 원격 에이전트와 쌍으로 다시 연결할 필요가 없습니다.You do not need to pair Visual Studio with the remote agent again unless you generate a new security certificate on your Mac, or its hostname or IP address changes.

Generate a new security PINGenerate a new security PIN

원격 에이전트를 처음 시작하는 경우 생성된 PIN은 제한된 시간(기본적으로 10분) 동안만 유효합니다.When you start the remote agent the first time, the generated PIN is valid for a limited amount of time—by default, 10 minutes. 시간이 만료되기 전에 Visual Studio를 원격 에이전트와 쌍으로 연결하지 않으면 새 PIN을 생성해야 합니다.If you don't pair Visual Studio to the remote agent before the time expires, you will need to generate a new PIN.

새 PIN을 생성하려면To generate a new PIN

  1. 에이전트를 중지합니다(또는 Mac에서 두 번째 터미널 앱 창을 열고 여기에 명령 입력).Stop the agent, or open a second Terminal app window on your Mac and use that to enter the command.

  2. 터미널 앱에서 다음 명령을 입력합니다.Enter this command in the Terminal app:

    vcremote generateClientCert

    원격 에이전트가 새 임시 PIN을 생성합니다.The remote agent generates a new temporary PIN. 새 PIN을 사용하여 Visual Studio를 쌍으로 연결하려면 Visual Studio에서 원격 에이전트 구성의 단계를 반복합니다.To pair Visual Studio by using the new PIN, repeat the steps in Configure the remote agent in Visual Studio.

새 서버 인증서 생성Generate a new server certificate

보안을 위해, Visual Studio를 원격 에이전트와 연결하는 서버 인증서는 Mac의 IP 주소 또는 호스트 이름에 연결되어 있습니다.For security purposes, the server certificates that pair Visual Studio with the remote agent are tied to the IP address or host name of your Mac. 이러한 값이 변경되면 새 서버 인증서를 생성한 후 Visual Studio를 새 값으로 다시 구성해야 합니다.If these values change, you must generate a new server certificate, and then reconfigure Visual Studio with the new values.

새 서버 인증서를 생성하려면To generate a new server certificate

  1. vcremote 에이전트를 중지합니다.Stop the vcremote agent.

  2. 터미널 앱에서 다음 명령을 입력합니다.Enter this command in the Terminal app:

    vcremote resetServerCert

  3. 확인 메시지가 표시되면 Y을 입력합니다.When prompted for confirmation, enter Y.

  4. 터미널 앱에서 다음 명령을 입력합니다.Enter this command in the Terminal app:

    vcremote generateClientCert

    이렇게 하면 새 임시 PIN이 생성됩니다.This generates a new temporary PIN.

  5. 새 PIN을 사용하여 Visual Studio를 쌍으로 연결하려면 Visual Studio에서 원격 에이전트 구성의 단계를 반복합니다.To pair Visual Studio by using the new PIN, repeat the steps in Configure the remote agent in Visual Studio.

Configure the remote agent on the MacConfigure the remote agent on the Mac

다양한 명령줄 옵션을 사용하여 원격 에이전트를 구성할 수 있습니다.You can configure the remote agent using various command line options. 예를 들어 빌드 요청을 수신할 포트와 파일 시스템에 유지할 최대 빌드 수를 지정할 수 있습니다.For example, you can specify the port to listen for build requests and specify the maximum number of builds to maintain on the file system. 기본적으로 해당 제한은 10개 빌드입니다.By default, the limit is 10 builds. 원격 에이전트는 종료 시 최대값을 초과하는 빌드를 제거합니다.The remote agent will remove builds that exceed the maximum on shutdown.

원격 에이전트를 구성하려면To configure the remote agent

  • 원격 에이전트 명령의 전체 목록을 보려면 터미널 앱에서 다음을 입력합니다.To see a complete list of remote agent commands, in the Terminal app, enter:

    vcremote --help

  • 보안 모드를 사용하지 않도록 설정하고 단순한 HTTP 기반 연결을 사용하려면 다음을 입력합니다.To disable secure mode and enable simple HTTP based connections, enter:

    vcremote --secure false

    이 옵션을 사용하는 경우 Visual Studio에서 에이전트를 구성할 때 보안 확인란을 선택 취소하고 Pin 필드를 비워 둡니다.When you use this option, clear the Secure checkbox and leave the Pin field blank when configuring the agent in Visual Studio.

  • 원격 에이전트 파일의 위치를 지정하려면 다음을 입력합니다.To specify a location for remote agent files, enter:

    vcremote --serverDir directory_path

    여기서 directory_path 는 로그 파일, 빌드 및 서버 인증서를 배치할 Mac의 위치입니다.where directory_path is the location on your Mac to place log files, builds, and server certificates. 기본적으로 이 위치는 /Users/사용자 이름/vcremote입니다.By default, this location is /Users/username/vcremote. 빌드는 이 위치에 빌드 번호를 기준으로 구성됩니다.Builds are organized by build number in this location.

  • 백그라운드 프로세스를 사용하여 stdoutstderr 을 server.log라는 파일에 캡처하려면 다음을 입력합니다.To use a background process to capture stdout and stderr to a file named server.log, enter:

    vcremote > server.log 2>&1 &

    server.log 파일은 빌드 문제를 해결하는 데 도움이 될 수 있습니다.The server.log file can assist in troubleshooting build issues.

  • 명령줄 매개 변수 대신 구성 파일을 사용하여 에이전트를 실행하려면 다음 명령을 입력합니다.To run the agent by using a configuration file instead of command-line parameters, enter:

    vcremote --config config_file_path

    여기서 config_file_path 는 JSON 형식의 구성 파일 경로입니다.where config_file_path is the path to a configuration file in JSON format. 시작 옵션과 해당 값에 대시가 포함되어서는 안 됩니다.The startup options and their values must not include dashes.

참고 항목See Also

Install Visual C++ for Cross-Platform Mobile DevelopmentInstall Visual C++ for Cross-Platform Mobile Development