license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. 저작권에 대한 추가 정보를 보려면 NOTICE 파일을 보십시오. ASF는 이 파일을 아파치 라이센스 2.0 (이하 “라이센스”) 하에 배포합니다. 라이센스에 허가되지 않은 용도로는 이 파일을 사용하실 수 없습니다. You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing,
     software distributed under the License is distributed on an
     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
     KIND, either express or implied.  See the License for the
     specific language governing permissions and limitations

under the License.

Plugman를 사용 하 여 플러그인을 관리 하

버전 3.0 이후, 코르도바 모든 장치, 플러그인으로 Api를 구현 하 고 기본적으로 비활성화 그들을 떠난다. 그것은 또한 추가 하 고 워크플로 개요에 설명 된의 선택에 따라 플러그인을 제거 하려면 두 가지 방법으로 지원 합니다.

  • 사용 하는 교차 플랫폼 워크플로우를 사용 하는 경우는 cordova 명령줄 인터페이스에 설명 된 대로 플러그인을 추가 하려면 CLI 유틸리티. CLI 모든 지정 된 플랫폼에 대 한 플러그인을 한 번에 수정합니다.

  • 플랫폼을 중심으로 워크플로 사용 하는 경우 하위 수준 Plugman 명령줄 인터페이스 별도로 각 대상된 플랫폼 사용.

이 섹션에는 Plugman 유틸리티를 자세히 설명합니다. 에 대 한 자세한 내용은 노드 모듈 Plugman을 소비 하거나 소스 코드를 수정, 그것의 저장소에서 README 파일 을 참조 하십시오..

Plugman 설치

Plugman를 설치 하려면 노드 컴퓨터에 설치 되어 있어야 합니다. 그럼 다음을 실행할 수 있습니다 어디에 어떤 디렉토리에서 사용할 수 있도록 plugman를 세계적으로 설치 하 여 환경에서 명령:

$ npm install -g plugman

당신이 있어야 git 에 당신의 PATH 원격 git Url에서 직접 플러그인을 설치할 수 있습니다.

팁: 찾으면 그와 plugman를 설치한 후 npm 여전히을 실행할 수 있습니다 plugman 명령, 추가 했는지 확인은 /npm/ 디렉토리에 당신의PATH.

참고: 당신의 세계를 오염 하지 않으려는 경우이 단계를 건너뛸 수 있습니다 npm Plugman를 세계적으로 설치 하 여 네임 스페이스. 만약이 사건이 다음 셸 도구와 코르 도우 바 프로젝트를 만들 때 있을 것입니다는 node_modules Plugman를 포함 하 여 프로젝트 내부 디렉터리. 세계적으로를 설치 하지 않은 호출 해야 node 예를 들어 각 Plugman 명령에 대 한 node ./node_modules/plugman/main.js -version . 이 가이드의 나머지 부분에서는 가정 합니다 설치 Plugman 세계적으로, 그것을 그냥 호출할 수 있습니다 의미plugman.

코르 도우 바 프로젝트 만들기

Plugman를 사용 하 여 코르도바 프로젝트를 만들어야 합니다. 이렇게 하려면 명령줄 인터페이스 또는 낮은 수준의 쉘 스크립트. 쉘 스크립트를 사용 하 여 프로젝트를 만드는 데 대 한 지침 플랫폼 가이드 페이지에 나열 된 다양 한 “명령줄 도구” 가이드에 있습니다.

플러그인 추가

Plugman 설치 하 고 코르 도우 바 프로젝트를 만들었습니다와 플랫폼에 플러그인을 추가 시작할 수 있습니다.

$ plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin <name|url|path> [--plugins_dir <directory>] [--www <directory>] [--variable <name>=<value> [--variable <name>=<value> ...]]

최소 매개 변수를 사용 하 여,이 명령은 코르도바 프로젝트에 플러그인을 설치 합니다. 해당 플랫폼에 대 한 플랫폼 및 코르도바 프로젝트 위치를 지정 해야 합니다. 또한 지정 해야 플러그인을 다른 --plugin 매개 변수 형성 되 고:

  • name플러그인 내용이 존재: 디렉터리 이름입니다. 이 기존 디렉터리 여야는 --plugins_dir 경로 (아래 추가 정보 참조) 또는 코르도바 레지스트리에서 플러그인.
  • url: URL https:// 또는 git로 시작: / /를 포함 하는 시그니처의 유효한 git 저장소를 가리키는 한 plugin.xml 파일. 이 저장소의 내용을 복사할 것이 고--plugins_dir.
  • path: 디렉터리 경로를 포함 하는 유효한 플러그인을 포함 하는 plugin.xml 파일. 이 패스의이 내용을 복사할 수 있는--plugins_dir.

다른 매개 변수:

  • --plugins_dir기본값은 <project>/cordova/plugins , 하지만 수 있습니다 각각에 대 한 하위 디렉터리 포함 된 디렉터리를 가져오지 플러그인.
  • --www프로젝트의 기본값 www 폴더 위치 하지만 코르도바 프로젝트 응용 프로그램 웹 자산으로 사용 되는 모든 디렉터리를 수 있습니다.
  • --variable변수를 지정할 특정 필요한 설치 시 특정 API 키 또는 다른 사용자 정의 사용자 정의 매개 변수를 필요로 하는 플러그인을 수 있습니다. 자세한 내용은 플러그인 명세 를 참조 하십시오.

플러그인 제거

플러그인을 제거 하려면 단순히 전달 된 --uninstall 플래그와 플러그인 ID를 제공

$ plugman --uninstall --platform <ios|amazon-fireos|android|blackberry10|wp8> --project <directory> --plugin <id> [--www <directory>] [--plugins_dir <directory>]

도움말 명령

Plugman 전역 도움말 명령 집착 하거나 문제가 발생 하는 경우 도움이 될 수 있는 특징 이다. 그것은 모든 사용 가능한 Plugman 명령 및 구문 목록을 표시 합니다.

plugman -help
plugman  # same as above

참고: plugman -help 몇 가지 추가 레지스트리 관련 명령이 표시 될 수 있습니다. 이 명령은 플러그인 개발자 이며 제 3 자 플러그인 레지스트리에 구현 되지 않을 수 있습니다.

추가할 수 있습니다는 --debug|-d 플래그 방출 하 고 당신을 도울 수 있습니다 내부 디버깅 메시지를 표시 하는 자세한 정보 표시 모드에서 해당 명령을 실행 하는 모든 Plugman 명령에 누락 된 파일 같은 문제를 추적 합니다.

# Adding Android battery-status plugin to "myProject":
plugman -d --platform android --project myProject --plugin cordova-plugin-battery-status

마지막으로, 사용할 수 있습니다는 --version|-v 플래그를 사용 하는 Plugman의 버전을 참조 하십시오.

plugman -v

레지스트리 작업

플러그인 레지스트리상호 작용을 위해 사용 될 수 있는 plugman 명령 수가 있습니다. 이러한 레지스트리 명령을 plugins.cordova.io 플러그인 레지스트리 관련 되며 제 3 자 플러그인 레지스트리에서 구현 되지 않을 수 있습니다 note 하시기 바랍니다.

플러그인에 대 한 검색

Plugman를 사용 하 여 플러그인 id 주어진된 공간 구분 된 키워드 목록이 일치 하는 플러그 접속식 레지스트리 검색 수 있습니다.

plugman search <plugin keywords>

플러그인 레지스트리 변경

당신이 얻을 수 또는 현재 플러그인 레지스트리 URL 설정 plugman를 사용 하 여. 일반적으로 http://registry.cordova.io에서 설정 하는 제 3 자 플러그인 레지스트리를 사용 하려는 경우가 아니면이 떠나야 한다.

plugman config set registry <url-to-registry>
plugman config get registry

플러그인 정보

함께 플러그인 저장소에 저장 된 어떤 특정 플러그인에 대 한 정보를 얻을 수 있습니다.

plugman info <id>

이 플러그인의 버전 번호와 같은 플러그인 레지스트리 정보와 인출 연락을 드릴 것입니다.

코어 플러그인 설치

아래 예제에서는 코르도바 Api 프로젝트에서는 여전히 작동 버전 3.0으로 업그레이드 한 후 필요에 따라 플러그인을 추가 하는 방법을 보여 줍니다. 각 명령에 대 한 대상 플랫폼을 선택 하 고 플랫폼의 프로젝트 디렉토리를 참조 해야 합니다.

  • cordova-plugin-battery-status

    plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-battery-status

  • cordova-plugin-camera plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-camera

  • cordova-plugin-console plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-console

  • cordova-plugin-contacts plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-contacts

  • cordova-plugin-device plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-device

  • cordova-plugin-device-motion (accelerometer) plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-device-motion

  • cordova-plugin-device-orientation (compass) plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-device-orientation

  • cordova-plugin-dialogs plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-dialogs

  • cordova-plugin-file plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-file

  • cordova-plugin-file-transfer plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-file-transfer

  • cordova-plugin-geolocation plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-geolocation

  • cordova-plugin-globalization plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-globalization

  • cordova-plugin-inappbrowser plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-inappbrowser

  • cordova-plugin-media plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-media

  • cordova-plugin-media-capture plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-media-capture

  • cordova-plugin-network-information plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-network-information

  • cordova-plugin-splashscreen plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-splashscreen

  • cordova-plugin-vibration plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin cordova-plugin-vibration