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

バージョン 3.0 以降、コルドバすべてデバイス Api のプラグインとして実装して、既定で無効になっているそれらを残します。 追加し、プラグインを削除する 2 つの異なる方法もサポートしています。 最初を使用して、 cordova CLI コマンド ライン インターフェイスで記述されています。 低レベルのPlugmanコマンド ライン インターフェイス ("ネイティブ プラットフォーム dev"ワークフロー。) を使用して 2 番目のです。これら 2 つの開発パスの主な違いはこと Plugman にのみ追加できますプラグイン 1 つのプラットフォームに、CLI が対象とするプラットフォームのすべてにプラグインを追加します。 このためときに、使用する Plugman している密接にそれ故に、単一のプラットフォームで、ワークフローの"ネイティブ プラットフォーム Dev"名前より理にかなって。

についての詳細 Plugman、特に消費するノード モジュールとして Plugman または Plugman コード上でのハッキングに興味があるなら、そのリポジトリ内の readmeを参照してください。.

Plugman をインストールします。

Plugman をインストールするには、コンピューターにインストールされているノードが必要です。 その後、次を実行することができますがあなたのマシン上の任意のディレクトリから使用可能な世界的に、plugman をインストールする環境内で任意の場所からコマンド。

$ npm install -g plugman

あなたも持っている必要があります git に、 PATH プラグインをインストールするリモートの git Url から直接ことができます。

のヒント：Plugman 故宮をインストールした後あなたがいないまだいずれかを実行することができますを見つける場合 plugman 、コマンドを追加したことを確認して、 /npm/ ディレクトリにあなたPATH.

注：グローバル Plugman をインストールすることによって、グローバル npm の名前空間を煩雑にしたくない場合は、この手順を省略できます。 このような場合、そのシェル ツールとコルドバ プロジェクトを作成するときがある場合、 node_modules ディレクトリを Plugman を含むプロジェクト内。 たとえばすべての Plugman コマンドのノードを起動する必要がありますのであなたがグローバルではなく instally、 node ./node_modules/plugman/main.js -version 。 このガイドの残りの部分だけでそれを呼び出すことができます意味、世界的に Plugman をインストールしたと仮定しますplugman.

コルドバのプロジェクトを作成します。

Plugman を使用することができます、前にコルドバのプロジェクトを作成する必要があります。 コマンド ライン インターフェイスを持つか低レベルのシェル スクリプトを使用します。 シェル スクリプトを使用してプロジェクトを作成するための手順は、プラットフォームのガイドのページに記載されている様々 な「コマンド ライン ツール」ガイドにあります。

プラグインを追加します。

Plugman インストールされているコルドバ プロジェクトを作成した後でプラットフォームへのプラグインの追加を開始できます。

$ plugman --platform <ios|amazon-fireos|android|blackberry10|wp7|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|wp7|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 org.apache.cordova.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 --project --plugin org.apache.cordova.battery-status

  • cordova-plugin-camera plugman --platform --project --plugin org.apache.cordova.camera

  • cordova-plugin-console plugman --platform --project --plugin org.apache.cordova.console

  • cordova-plugin-contacts plugman --platform --project --plugin org.apache.cordova.contacts

  • cordova-plugin-device plugman --platform --project --plugin org.apache.cordova.device

  • cordova-plugin-device-motion (accelerometer) plugman --platform --project --plugin org.apache.cordova.device-motion

  • cordova-plugin-device-orientation (compass) plugman --platform --project --plugin org.apache.cordova.device-orientation

  • cordova-plugin-dialogs plugman --platform --project --plugin org.apache.cordova.dialogs

  • cordova-plugin-file plugman --platform --project --plugin org.apache.cordova.file

  • cordova-plugin-file-transfer plugman --platform --project --plugin org.apache.cordova.file-transfer

  • cordova-plugin-geolocation plugman --platform --project --plugin org.apache.cordova.geolocation

  • cordova-plugin-globalization plugman --platform --project --plugin org.apache.cordova.globalization

  • cordova-plugin-inappbrowser plugman --platform --project --plugin org.apache.cordova.inappbrowser

  • cordova-plugin-media plugman --platform --project --plugin org.apache.cordova.media

  • cordova-plugin-media-capture plugman --platform --project --plugin org.apache.cordova.media-capture

  • cordova-plugin-network-information plugman --platform --project --plugin org.apache.cordova.network-information

  • cordova-plugin-splashscreen plugman --platform --project --plugin org.apache.cordova.splashscreen

  • cordova-plugin-vibration plugman --platform --project --plugin org.apache.cordova.vibration