昨天第一次寫簡書,感覺太生硬,有的東西只有自己懂了,沒有說的和明白,還望大家見諒,今天說一下自定義ionic插件的一些心得!希望大家勿噴啊。先裝一下逼吧,很多剛學的或者學了一段時間的同學,興許還不知道ionic和cordova的區別,還有phonegap是什么東東?
通俗的講:ionic是一款基于angularjs的html5移動app開發框架phonegap就是一款可以打包并且可以讓js調用原生的移動app框架
問題來了? 那我不用命令安裝ionic 可以使用ionic開發app嗎?答案是可以得。
1.環境配置
Node.js的安裝,ionic的安裝這里不再贅述,默認大家都安裝配置好了環境。
1.1. 安裝plugman新建插件,終端輸入
npm install -g plugman
安裝時如果出現Error: EACCES: permission denied,說明沒有權限,只需要在命令前面加上 sudo npm install -g plugman 即可,安裝命令與安裝結果如下:
2. 新建一個自定義插件DZFPlugin,用彈框顯示我們的內容
plugman create --name <pluginName> --plugin_id <pluginID> --plugin_version <version> [--path <directory>] [--variable NAME=VALUE]
把其中的<pluginName>替換為 DZFPlugin;
<pluginID> 替換為 cordova.plugin.DZFPlugin
<version> 替換為 0.0.1
[--path <directory>] [--variable NAME=VALUE] 這兩個是可選參數,這里不寫了。這樣會在當前目錄下(desktop)創建一個新的目錄DZFPlugin
plugman create --name DZFPlugin --plugin_id cordova.plugin.DZFPlugin --plugin_version 0.0.1
執行完命令之后會在當前目錄生成一個文件夾,我但前設置的是桌面,文件加目錄如下
接下來向DZFPlugin項目中添加Android和ios平臺,把platform替換為android和ios即可,首先進入插件文件路徑,cd DZFPlugin
plugman platform add --platform_name <platform>
最終在終端輸入的命令如下
plugman platform add --platform_name android
plugman platform add --platform_name ios
平臺添加完畢,DZFPlugin中src文件夾下會多出來android和ios兩個文件夾,結果如下:
先看配置文件:plugin.xml
解釋一下關鍵的幾個元素:
(1) id:插件標識,即一開始我們創建插件時輸入的cordova.plugin.DZFPlugin
(2) name:插件名稱,即新建插件是輸入的DZFPlugin
(3) js-module:對應的javascript文件路徑,src屬性指向www/DZFPlugin.js
(4) platform:支持的平臺,就是剛才我們這是剛才我們通過“ plugman platform add --platform_name ios ”添加進來的,這里是安卓和iOS的插件配置信息。
接下來咱們在介紹一下插件目錄中www/xxx.js文件中幾個關鍵字信息:
步驟很簡單:
第一步是引入cordova下的exec庫;
第二步是執行插件方法
exec(success, error, "DZFPlugin", "coolMethod", [arg0]);
success:調用成功時的回調方法
error :調用失敗時的回調方法
"DZFPlugin" :是插件的名稱
"coolMethod" :執行插件里的方法,即原生的方法
[arg0]:可選參數,執行方法的參數數組
最后的js文件方法如下,由于只是做了一個demo,所以原生方法名字還是用的插件自帶原生文件的類名,秩序自己替換成自己定義的原生方法名字即可。
3.安裝自定義插件
這里用事先創建好的ionic項目進行自定義插件的測試,具體ionic項目的創建,請看我的第一篇簡書,打開終端
cd DZFPluginDemo -------切換到項目目錄下
cordova plugin add plugin-id或者插件路徑 ---------本項目是插件的本地路徑,是否安裝成功請見下圖,以iOS為例。
此時工程項目的plugins下會看到自己的插件,前提是你已經安裝成功了!,距離勝利只剩一小步了??!
接下來打開項目目錄下的platforms/ios/DZFPluginDemo工程,最先應該看的兩個地方就是Staging目錄下的config.xml和www目錄下的cordova_plugins.js文件,如果和下圖一致,表明插件已經注冊成功了!cordova_plugins.js文件中的clobbers鍵對應的值應該是配置插件時pluign.xml文件的劃橫線的名字,否則提示找不到方法。
打開DZFPluginDemo目錄下的staging/www/templates/tab-dash.html(項目的首頁添加一個按鈕),注意:如果tab-dash.html編輯不了,在終端輸入sudo chmod -R 777 .即可解決問題,前提是已經進入項目目錄,編輯templates文件夾下的tab-dash.html,添加一個按鈕,便于測試自定義插件是否可用如下。
然后編輯staging/www/js/controller.js文件,方框中的名字和cordova_plugins.js文件中clobber對應的值是一樣的。
運行項目
至此為止,自定義插件已完成,可能有些地方說的不是很清楚,還有很多不足,感覺自己的語言的組織能力太差了,希望大家多給與評論,便于我的改正。