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 <directory> --plugin cordova-plugin-battery-status

  • cordova-plugin-camera

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

  • cordova-plugin-console

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

  • cordova-plugin-contacts

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

  • cordova-plugin-device

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

  • cordova-plugin-device-motion (accelerometer)

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

  • cordova-plugin-device-orientation (compass)

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

  • cordova-plugin-dialogs

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

  • cordova-plugin-file

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

  • cordova-plugin-file-transfer

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

  • cordova-plugin-geolocation

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

  • cordova-plugin-globalization

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

  • cordova-plugin-inappbrowser

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

  • cordova-plugin-media

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

  • cordova-plugin-media-capture

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

  • cordova-plugin-network-information

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

  • cordova-plugin-splashscreen

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

  • cordova-plugin-vibration

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