Plugman を使用してプラグインを管理するには

バージョン 3.0 以降、コルドバすべてデバイス Api のプラグインとして実装して、既定で無効になっているそれらを残します。 追加し、「概要」で説明したワークフローの選択に応じて、プラグインを削除する 2 つの異なる方法もサポートしています。

  • 使用するプラットフォーム間のワークフローを使用する場合、 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: Https://または git で始まる URL://クローンを含む有効な git リポジトリを指している、 plugin.xml ファイル。 このリポジトリの内容にコピーされる、--plugins_dir.
  • path: を含む有効なプラグインが含まれているディレクトリへのパスを plugin.xml ファイル。このパスのコンテンツにコピーされます、--plugins_dir.

その他のパラメーター:

  • --plugins_dir既定値は <project>/cordova/plugins が、フェッチされるプラグイン任意のディレクトリの各サブディレクトリを含むことができます。
  • --wwwデフォルトで、プロジェクトの www フォルダーの場所、コルドバ プロジェクト アプリケーション web 資産として使用される任意のディレクトリにすることができます。
  • --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 いくつかの追加のレジストリ関連のコマンドが表示場合があります。 これらのコマンドは、プラグインの開発者とサード パーティのプラグイン登録に実装されない可能性があります。

追加することもできます、 --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プラグイン レジストリに固有のサード パーティのプラグイン登録を実装することができません可能性があります。

プラグインを探してください。

プラグイン レジストリプラグイン id キーワードの特定のスペースで区切られたリストに一致するを検索するのに Plugman を使用できます。

plugman search <plugin keywords>

プラグイン レジストリを変更します。

取得または、現在のプラグイン レジストリの URL を設定することができます plugman を使用しています。一般的にこれはサード パーティ プラグイン レジストリを使用する場合を除き、http://registry.cordova.io で設定しておきます。

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