Visual Studio Tools for Apache Cordova 설치

  • 아티클

*이 문서는 시험판 소프트웨어인 Visual Studio Tools for Apache Cordova에 대해 설명합니다. 설명하는 기능은 미리 보기에 있으며 변경될 수 있습니다. Microsoft 다운로드 센터.*에서 미리 보기를 다운로드할 수 있습니다.

이 문서에서는 Visual Studio Tools for Apache Cordova를 사용하여 플랫폼 간 Cordova 앱을 만드는 데 필요한 도구와 타사 종속성을 설치하는 방법을 설명합니다.

요구 사항
도구 가져오기
도구 설치
수동으로 종속성 설치
iOS용 도구 설치
시스템 환경 변수 재정의

요구 사항

  • Windows 7, Windows 8, Windows 8.1 또는 Windows Server 2012 R2 운영 체제 중 하나가 필요합니다.

    중요

    Windows 7을 사용하는 경우 Android와 iOS용 앱은 개발할 수 있지만 Windows 또는 Windows Phone용 앱은 개발할 수 없습니다.

  • 다음 기능이 설치된 Visual Studio 2013 업데이트 4(Professional, Ultimate, Premium 또는 Community Edition)

    • Windows 8용 스토어 앱 유지 관리를 위한 도구

    • Windows Phone 8.0 SDK

      기존에 설치한 Visual Studio 2013 업데이트 4에 이러한 기능을 추가할 수 있습니다. 이렇게 하려면 제어판에서 프로그램 및 기능을 선택하고 목록에서 Visual Studio 2013을 선택한 다음 변경을 선택합니다. 그런 후에 Visual Studio 설치 창에서 수정을 선택하고 기능 목록에서 아래 그림에 나와 있는 것처럼 두 옵션을 선택합니다.

      Visual Studio 선택적 기능 설치

  • Visual Studio 2013이 아닌 Visual Studio 2015 Preview를 사용하는 경우에는 이 항목에서 설치 절차를 참조하세요.

특정 장치 플랫폼용 앱을 빌드하려는 경우에는 다음의 몇 가지 요구 사항이 추가로 적용됩니다.

  • Android 에뮬레이터는 Intel HAXM 드라이버를 실행할 수 있는 컴퓨터에서 가장 효율적으로 작동합니다. Android에서 Apache Cordova 앱 실행을 참조하세요.

  • Windows Phone 에뮬레이터를 사용하려면 Hyper-V를 실행할 수 있는 컴퓨터가 필요합니다. 자세한 내용은 에뮬레이터의 시스템 요구 사항을 참조하세요.

  • iOS 및 iOS 시뮬레이터를 사용하려면 Xcode 6(Xcode 6이 권장됨)을 실행할 수 있는 Mac 컴퓨터가 필요합니다. 추가 단계는 iOS용 빌드에 도구 설치를 참조하세요.

    팁

    Mac 하드웨어가 아닌 클라우드 서비스에서 iOS를 빌드하려면 클라우드에서 iOS 빌드 및 시뮬레이트를 참조하세요.

도구 다운로드

Visual Studio Tools for Apache Cordova 확장을 다운로드하려면 Microsoft 다운로드 센터로 이동하여 다음 섹션의 단계에 따라 확장을 설치합니다.

중요

이전에 Visual Studio Tools for Apache Cordova(다중 장치 하이브리드 앱)의 CTP를 설치한 경우 먼저 제어판, 프로그램 및 기능을 사용하여 CTP를 제거한 후 Visual Studio 2013 업데이트 4 및 최신 CTP를 설치해야 합니다.

Visual Studio 2015 Preview에서는 Visual Studio Tools for Apache Cordova는 설치 중에 선택적 기능으로 설치할 수 있습니다. 설치 절차를 확인하려면 Visual Studio Tools for Apache Cordova 시작을 참조하세요.

도구 설치

설치 관리자는 먼저 Cordova 앱 개발을 지원하기 위해 Visual Studio 패치를 설치합니다. 그런 후에 다음의 타사 소프트웨어를 설치하는 옵션을 제공합니다. 이러한 소프트웨어는 대부분 특정 플랫폼 또는 Apache Cordova에 필요한 오픈 소스 소프트웨어입니다.

  • Joyent Node.js를 사용하면 Visual Studio를 Apache Cordova CLI(명령줄 인터페이스) 및 Apache Ripple 에뮬레이터와 통합할 수 있습니다.

  • Git CLI는 특정 Cordova 플러그 인에 대해 Git URI를 수동으로 추가해야 하는 경우에만 필요합니다.

  • iOS 및 Android용 Apache Ripple 에뮬레이터를 실행하려면 Google Chrome이 필요합니다.

  • Android 빌드 프로세스를 수행하려면 Apache Ant 1.8.0 이상 버전이 필요합니다.

  • Android 빌드 프로세스를 수행하려면 Oracle Java JDK 7이 필요합니다.

  • Android 빌드 프로세스를 수행하고 Ripple을 사용하려면 Android SDK가 필요합니다.

  • Windows WebSQL Polyfill 플러그 인에 대해 Windows 앱으로의 SQL 연결을 추가하려면 Windows 런타임용 SQLite가 필요합니다.

  • Windows PC에 연결된 iOS 장치에 앱을 배포하려면 Apple iTunes가 필요합니다.

Visual Studio 확장 및 종속성을 설치하려면

  1. 도구 가져오기에서 찾은 설치 관리자를 실행합니다.

  2. 지침에 따라 Visual Studio 확장을 설치합니다.

  3. 메시지가 표시되면 설치 관리자가 타사 소프트웨어 종속성을 설치하도록 허용합니다. 소프트웨어 선택을 취소하고 나중에 필요한 종속성을 수동으로 설치할 수도 있습니다.

    중요

    타사 종속성이 시스템에 이미 설치되어 있거나 해당 종속성을 수동으로 설치하려는 경우에는 시스템 경로를 업데이트해야 할 수 있습니다.수동으로 종속성 설치를 참조하세요.

    설치할 타사 소프트웨어 선택

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

    중요

    모든 항목을 정상적으로 설치하려면 컴퓨터를 다시 부팅해야 합니다.

  5. Visual Studio 열고 도구, 확장 및 업데이트, 업데이트를 차례로 선택합니다. Visual Studio Tools for Apache Cordova용 Visual Studio 업데이트가 있는 경우 설치합니다.

    참고

    도구를 설치하고 나서 처음으로 앱을 빌드할 때 Cordova 도구가 다운로드되어 설치됩니다.따라서 첫 번째 빌드는 완료하는 데 시간이 더 오래 걸립니다.출력 창에서 진행률을 확인합니다.

  6. iOS 시뮬레이터 또는 iOS 장치에서 앱을 실행하려면 Mac 컴퓨터에 원격 에이전트를 설치해야 합니다. iOS용 빌드에 도구 설치을 참조하세요.

수동으로 종속성 설치

하나 이상의 종속성을 확장과 함께 설치하지 않으려는 경우 나중에 수동으로 설치할 수 있습니다.

경고

Java를 제외한 종속성은 원하는 순서대로 설치할 수 있습니다.Java는 Android SDK를 설치하기 전에 설치하고 구성해야 합니다.

다음 정보에 따라 아래 링크를 통해 종속성을 수동으로 설치할 수 있습니다.

  • Joyent Node.js

    Node.js의 x86 버전을 설치하는 것이 좋습니다.

  • Google Chrome

  • Git 명령줄 도구

    Git 명령줄 도구를 설치할 때는 명령 프롬프트 경로에 Git를 추가하는 옵션을 선택합니다.

    경고

    Git 명령줄 도구 1.9.3은 기본적으로 설치됩니다.1.9.0 이전 버전을 설치하는 경우 예기치 않은 오류가 발생할 수 있습니다.

  • Apache Ant

    • Ant를 다운로드하여 C:/ant-1.x.x와 같은 위치에 추출합니다.

    • 위의 위치를 가리키도록 ANT_HOME 환경 변수를 설정합니다.

    • 시스템 경로에 %ANT_HOME%\bin을 추가합니다.

      참고

      이 환경 변수를 수동으로 설정해야 하는 경우 시스템 환경 변수 재정의를 참조하세요.

  • Oracle Java 7

    • JAVA_HOME 환경 변수를 C:/Program Files/Java/jdk1.7.0_55로 설정합니다.

    • 시스템 경로에 %JAVA_HOME%\bin을 추가합니다.

      참고

      이 환경 변수를 수동으로 설정해야 하는 경우 시스템 환경 변수 재정의를 참조하세요.

  • Android SDK(다음 SDK 패키지 포함):

    • Android SDK 도구(최신 버전)

    • Android SDK 플랫폼 도구(최신 버전)

    • Android SDK 빌드 도구(최신 버전)

    • Android 4.4.x(API level 19)(다음 패키지 포함):

      • SDK 플랫폼

      • ARM EABI v7a 시스템 이미지

      • Intel x86 Atom 시스템 이미지

      • Google API(x86 시스템 이미지)

      • Google API(ARM 시스템 이미지)

    다음 그림에서는 Android SDK Manager의 필수 패키지를 보여 줍니다.

    Android SDK의 필수 패키지

    ADT_HOME 환경 변수를 SDK 설치 위치로 설정합니다.

    시스템 경로에 %ADT_HOME%\tools;%ADT_HOME%\platform-tools를 추가합니다.

    이 환경 변수를 수동으로 설정해야 하는 경우 시스템 환경 변수 재정의를 참조하세요.

    팁

    Windows의 기본 위치에 Android SDK를 설치하는 경우 C:\Program Files (x86)\Android\android-sdk에 설치됩니다.

  • Apple iTunes(x86, x64)

  • SQLite

  • WebSocket4Net(Windows 7에서 앱을 개발하는 경우 필요함)

    1. CodePlex에서 WebSocket4Net(0.9).Binaries.zip을 다운로드합니다.

    2. 다운로드한 zip 파일에서 net45\Release\WebSocket4Net.dll을 컴퓨터의 %ProgramFiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE\CommonExtensions\Microsoft\WebClient\Diagnostics\ToolWindows 폴더에 복사합니다.

iOS용 도구 설치

Visual Studio에서 iOS용 앱을 빌드하고 실행하려면 몇 가지 단계를 추가로 수행해야 합니다. iOS용 빌드에 도구 설치을 참조하세요.

시스템 환경 변수 재정의

Visual Studio는 설치된 타사 소프트웨어의 구성을 검색하고 다음 환경 변수에서 설치 경로를 유지 관리합니다.

  • ADT_HOME - Android 설치 경로를 가리킵니다.

  • ANT_HOME - 컴퓨터의 Ant 폴더를 가리킵니다.

  • GIT_HOME - Git 설치 경로를 가리킵니다.

  • JAVA_HOME - Java 설치 경로를 가리킵니다.

Visual Studio는 앱을 빌드하고 실행할 때 이러한 환경 변수를 사용합니다. Visual Studio 옵션 대화 상자를 통해 환경 변수를 확인하고 해당 값을 수정할 수 있습니다. 다음과 같은 이유 중 하나에 해당하는 경우에는 기본 설정을 재정의할 수 있습니다.

  • Visual Studio에서 경로를 확인할 수 없는 경우. 이 경우에는 환경 변수 옆에 경고가 표시됩니다.

  • 여러 소프트웨어 버전을 설치했는데 특정 버전을 사용하려는 경우

  • 전역 환경 경로를 로컬 Visual Studio 환경과 다르게 지정하려는 경우

변수를 재정의하려면

  1. Visual Studio 메뉴 모음에서 도구, 옵션을 차례로 선택합니다.

  2. 옵션 대화 상자에서 Tools for Apache Cordova를 선택한 후 환경 변수 재정의를 선택합니다.

  3. 변경 내용을 확인합니다.

    • 값을 재정의하려면 해당 확인란을 선택하고 값을 수정합니다.

      경로 정보가 잘못되었거나 누락된 경우 Visual Studio에서 변수 옆에 경고를 표시합니다.

    • 환경 변수를 기본값으로 다시 설정하려면 해당 확인란의 선택을 취소하거나 기본값으로 다시 설정을 선택합니다.

  4. 확인을 선택하여 변경 내용을 저장하고 대화 상자를 닫습니다.

환경 변수, 경고 메시지

Cordova 버전 수동 업데이트

Visual Studio는 특정 버전의 Apache Cordova를 대상으로 테스트되었습니다. 프로젝트별로 Cordova 버전을 선택할 수 있도록 할 예정이지만 지금도 패치를 적용하여 시스템의 모든 프로젝트에서 다른 버전의 Cordova를 사용할 수 있습니다.

경고

Visual Studio에 패치를 설치하는 것은 공식적으로는 지원되지 않습니다.예기치 않은 동작이 발생할 수 있으므로 이러한 단계는 고급 사용자만 수행하는 것이 좋습니다.패치를 설치하면 시스템 차원의 변경이 수행됩니다.

다른 버전의 Cordova를 사용하도록 Visual Studio를 업데이트하려면

  1. Visual Studio Tools for Cordova를 설치한 후 Cordova를 설치하기 위한 빈 프로젝트를 만들고 빌드합니다.

  2. 명령줄을 열고 다음 명령을 입력합니다.

    cd %appdata%\npm\node_modules\vs-mda\

    Node.js를 직접 설치한 경우 vs-mda는 다른 위치에 설치되어 있을 수 있습니다. 이전 명령을 실행하면 기본 설치 위치가 표시됩니다.

  3. 명령줄에서 다음 명령을 입력합니다.

    npm install cordova@version --save

    여기서 version은 사용하려는 Cordova CLI의 버전입니다. 예를 들어 4.1.0을 사용할 수 있습니다.

    Cordova를 다른 위치에 설치한 경우 cordova --version을 입력하여 Cordova 버전을 확인할 수 있습니다.

    중요

    앞의 설치 명령을 실행할 때는 전역 스위치 -g를 생략해야 합니다.

  4. Visual Studio에서 편집 중인 프로젝트에 대해 솔루션 정리 같은 "정리" 작업을 실행하여 버전 변경 내용이 적용되도록 합니다.

지원되는 버전의 Cordova로 되돌리려면

  • 명령 프롬프트를 열고 다음을 입력합니다.

    npm uninstall -g vs-mda

    다음번에 빌드하면 vs-mda가 자동으로 다시 설치됩니다.

    아니면 C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE\Extensions에서 vs-mda 파일을 검색하고, 사용하려는 버전을 참조하도록 package.json을 수정해도 됩니다. package.json의 수정이 완료되면 동일한 폴더에서 다음 명령을 실행합니다.

    npm install -g vs-mda

Mac에서 iOS 빌드가 지원되도록 하려면 vs-mda-remote에서 사용하는 Cordova 버전이 Visual Studio에 대해 설치한 버전과 일치해야 합니다. 다음 단계에서는 특정 버전의 Cordova를 사용하도록 vs-mda-remote를 업데이트하는 방법을 설명합니다. iOS 빌드 도구를 설치하는 방법에 대한 자세한 내용은 iOS용 빌드에 도구 설치를 참조하세요.

Mac의 vs-mda-remote를 다른 버전의 Cordova에 대해 업데이트하려면

  1. Mac에서 터미널 앱을 열고 다음 명령을 입력합니다.

    cd /usr/local/lib/node_modules/vs-mda-remote

    vs-mda-remote를 전역적으로(-g) 설치하지 않은 경우 Mac에서의 vs-mda-remote 위치는 다를 수 있습니다. 

  2. 다음 명령을 입력합니다.

    sudo npm install cordova@version --save

    여기서 version은 이전에 설치한 버전과 동일한 버전의 Cordova CLI입니다. 예를 들어 4.1.0일 수 있습니다.

    중요

    앞의 설치 명령을 실행할 때는 전역 스위치 -g를 생략해야 합니다.

    Cordova를 다른 위치에 설치한 경우 cordova --version을 입력하여 Cordova 버전을 확인할 수 있습니다.

    Visual Studio에서 편집 중인 프로젝트에 대해 솔루션 정리 같은 "정리" 작업을 실행하여 버전 변경 내용이 적용되도록 합니다.

Mac의 vs-mda-remote를 지원되는 버전으로 되돌리려면

  1. Mac의 터미널 앱을 열고 다음 명령을 입력합니다.

    sudo npm uninstall -g vs-mda-remote

  2. 다음 명령을 입력합니다.

    sudo npm install -g vs-mda-remote --save

    

참고 항목

개념

iOS용 빌드에 도구 설치

기타 리소스

도구 다운로드

FAQ

알려진 문제