標籤:
在Cordova中有一個很重要的概念:外掛程式。
外掛程式會提供訪問Cordova核心API的介面。
外掛程式是一些附加的代碼,它能夠提供訪問原生組件的介面。一般情況下,你都需要添加一些外掛程式以啟動Cordova裝置層級的特性。
外掛程式由官方和社區提供,可以在plugins.cordova.io上找到,當然還可以在命令列中去搜尋外掛程式。
從3.0之後,Cordova將所有裝置的API都作為外掛程式,並預設設定為是不啟動的。
那麼,如何添加外掛程式呢?兩種方式。
第一種是使用CLI命令列。
第二種是使用更低層級的命令列Plugman。
兩個的區別在於,Plugman只能一次添加一個平台的外掛程式,而CLI命令列會添加所有平台的外掛程式。所以如果你只在單個平台上工作,使用Plugman就顯得更合理。
使用CLI命令列添加外掛程式:
1.添加外掛程式
1 |
cordova plugin add org.apache.cordova.camera
|
2.刪除外掛程式
1 |
cordova plugin rm org.apache.cordova.camera
|
3.查看當前已有外掛程式
4.根據關鍵字搜尋外掛程式
1 |
cordova plugin search bar code
|
5.社區中會提供很多外掛程式,但是如果它沒有註冊到registry.cordova.io,你可以通過倉庫地址添加
1 |
cordova plugin add https://github.com/apache/cordova-plugin-console.git
|
使用plugman添加外掛程式:
首先你需要安裝plugman
1.添加一個外掛程式
1 |
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> ...]]
|
通過plugman命令列將一個外掛程式加到一個Cordova工程中。你至少要指定平台資訊、Cordova項目位置。
name:外掛程式的目錄名稱。它必須是存在於plugins_dirpath路徑下或者在Cordova中有註冊。
url:以”http://“或者”git://”開頭的url,指向一個合法的git可複製倉庫,倉庫中應該包含一個plugin.xml的檔案,倉庫中的內容可以被拷貝到plugins_dir路徑下。
path:一個指向包含合法外掛程式(包含plugin.xml檔案)目錄的路徑。該路徑下的內容可以被拷貝到plugins_dir。 其他參數:
plugin_dir:預設是指向/cordova/plugins,當然也可以是任何包含每一個已擷取外掛程式的子目錄。
www:預設指向項目的www目錄,但是也可以指向Cordova項目的應用web asserts目錄。
variable:允許在安裝時指定某些變數,對於某些外掛程式需要API key或者其他使用者定義參數是有必要的。
下面是添加電池狀態外掛程式的安裝命令列
1 |
plugman -d --platform android --project myProject –plugin org.apache.cordova.battery-status
|
-d或者—debug參數,會協助你列印出內部調試資訊,協助你跟蹤具體資訊。
2.刪除一個外掛程式
plugman --uninstall --platform <ios|amazon-fireos|android|blackberry10|wp7|wp8> --project <directory> --plugin <id> [--www <directory>] [--plugins_dir <directory>]
Cordova探索之旅系列(二)