license: Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. 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
バージョン 3.0 以降、コルドバすべてデバイス Api のプラグインとして実装して、既定で無効になっているそれらを残します。 追加し、「概要」で説明したワークフローの選択に応じて、プラグインを削除する 2 つの異なる方法もサポートしています。
使用するプラットフォーム間のワークフローを使用する場合、 cordova コマンド ライン インターフェイスでの説明に従って、プラグインを追加する CLI ユーティリティ。 CLI を一度に指定のすべてのプラットフォーム用のプラグインを変更します。
プラットフォームを中心としたワークフローを使用する場合使用する下位Plugmanのコマンド ライン インターフェイス、別々 に各ターゲット プラットフォーム用。
このセクションの詳細 Plugman ユーティリティ。 ノード モジュールとして Plugman を消費したり、ソース コードの変更については、そのリポジトリ内の README ファイルを参照してください。.
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 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 <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin org.apache.cordova.battery-status
cordova-plugin-camera plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin org.apache.cordova.camera
cordova-plugin-console plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin org.apache.cordova.console
cordova-plugin-contacts plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin org.apache.cordova.contacts
cordova-plugin-device plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin org.apache.cordova.device
cordova-plugin-device-motion (accelerometer) plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin org.apache.cordova.device-motion
cordova-plugin-device-orientation (compass) plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin org.apache.cordova.device-orientation
cordova-plugin-dialogs plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin org.apache.cordova.dialogs
cordova-plugin-file plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin org.apache.cordova.file
cordova-plugin-file-transfer plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin org.apache.cordova.file-transfer
cordova-plugin-geolocation plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin org.apache.cordova.geolocation
cordova-plugin-globalization plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin org.apache.cordova.globalization
cordova-plugin-inappbrowser plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin org.apache.cordova.inappbrowser
cordova-plugin-media plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin org.apache.cordova.media
cordova-plugin-media-capture plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin org.apache.cordova.media-capture
cordova-plugin-network-information plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin org.apache.cordova.network-information
cordova-plugin-splashscreen plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin org.apache.cordova.splashscreen
cordova-plugin-vibration plugman --platform <ios|amazon-fireos|android|blackberry10|wp8> --project --plugin org.apache.cordova.vibration