烽火exmobile--ios原生插件開發

一：開發

工具xcode、mbuilder

1：在http://www.exmobi.cn/open/resource.html網站下載生成插件包，XKPlugin_Test2_ComponentFactory是使用時的插件工廠，可以改成自己的名稱想使用的名稱：XKPlugin_CPI_ComponentFactory.h；其他文件XKPlugin_Component不要改動。

2：XKPlugin_CPI_ComponentFactory.m文件中，修改紅色代碼，CPI_CalendarComponent是自己寫的插件類。

3：新建插件類，AppPlugin下，新建New Group，名稱是CPI_CalendarComponent，在此文件夾下新建文件，

New File...-->Cocoa Touch Class-->Class(class就是插件類名稱，和步驟2中的紅色代碼中的type類型一致CPI_CalendarCpmponent)-->SubClass(NSObject)-->Language(Objective-C)；

4：CPI_CalendarCpmponent.h文件中導入基礎插件類（XKPlugin_Component）,其中idetifier 是需要返回的回調值

5：CPI_CalendarCpmponent.m中，

（1）getView是返回視圖，如果有視圖，則返回視圖模式，如果不返回視圖，則只可以直接返回一個nil；

（2）call方法是js和插件之間調用的橋梁，第一個參數必須是方法名稱，用來判斷js調用的什么方法，最多有起個參數，前臺自己傳參，只要不大于7個就可以，后臺自己判斷參數個數。call方法格式不要修改，不要在call方法中使用UIAlert方法，容易造成閃退。

（3）set方法是獲取前臺nativecomponent的xml標簽中的參數

（4）setValue是插件的回調，在方法體里執行了需要操作的功能之后，回調一個值返回

5：get方法是可以在mbuilder上可以調用的返回值。

前段頁面調用MBuilder

1：body里放xml標簽文件，其實“type”代表的是你寫的插件類，id是自己定義的，在js中使用

var nav= document.getElementById("nav");來獲取這個插件，factoryname是寫的工廠類，wid是自己定義的方法，js中使用toGetWid(v)方法來獲取這個回調回來的值，就是xcode插件中，setValue中和回調函數一起返回過來的參數。

二：打包

1：新建一個文件夾，名稱為自己定義的工廠類：XKPlugin_CPI_ComponentFactory

2:將xcode中的代碼通過編譯，點擊AppPlugin項目-->Product-->Archive。

3:可以在項目的Products目錄下看見一個libplugin.a文件，右鍵點擊-->Show in Finder,將.a文件復制到文件夾中。

4：將自己寫的工廠類XKPlugin_CPI_ComponentFactory.h文件復制到文件夾中

5：在文件夾中新建一個framework文件夾，里面新建一個framework.txt文檔，將插件項目中所需要的freamwork相對路徑放到.txt文件中，將插件工程中所需要的.a文件或者其他第三方framework庫復制到framework文件夾中

6：新建p_w_picpath文件夾，將插件工程中所需要的圖片放到文件夾中

7：新建other文件夾，將項目中一些其他文件放置到這個文件夾中，比如plist、xml文件（如果說插件中需要設計到權限的問題，需要在plist文件中添加權限）；

8：新建xib文件夾，將插件工程中需要的xib文件放到文件夾中（返回視圖的插件需要，不然不需要）；

9：新建natives文件夾，在文件夾下新建文件夾，名稱為插件類的名稱CPI_CalendarComponent，新建config.xml文件，作為插件的版本信息，可以有有多個插件，config文件格式如下，其中version是版本號，每次要更新的時候需要提高版本號，不然會打包失敗。type是你的插件類，factoryname是工廠類，其他信息可以隨便填了。

10：所有文件完成之后，壓縮XKPlugin_CPI_ComponentFactory，格式必須是.zip格式的。

11：插件打包好之后登陸到烽火的控制臺，在插件管理中，添加插件，打包成功之后，在mbuilder打包的時候 可以修改ios的打包配置文件，將自己的插件添加進去就可以使用了。

三：遇到的問題

Q：打包的時候，烽火平臺的教程上，直接選擇了文件夾中的七項，然后壓縮，上傳之后顯示打包失敗；

A：文件夾中的七個選項，外面還需要加一層工廠類的文件夾，然后再壓縮，壓縮格式必須是ZIP格式的。

Q：在IOS平臺壓縮打包，上傳失敗

A：IOS平臺打包的時候，文件夾中會出現多余的文件，導致打包失敗，將所有的文件拷到windows平臺壓縮。

Q：第一次上傳成功，第二次失敗

A：一個可能是修改的插件有問題，還有一個可能是因為config.xml文件中version的版本號沒有提高導致的。

Q：本次所做的日歷插件中，ios10以下的版本可以正常使用，ios10以上的沒有反應

A：IOS10的版本提高了安全性，在開發的時候，需要加上權限，在AppPlugin的文件夾下，新建一個info.plist文件，或者直接從別處拷過來，在Information Property List 下添加一個App TransportSecurity Settings 選項，在此項下面加上插件所需要的權限。然后選中AppPlugin工程，在Build Settings選項下面找到 packaging-->info.plist File 選項，將info.plist文件的路徑加上去，并且將這個plist文件加入到打包文件夾中的other文件夾下。

Q：打包成功之后安裝app，但是打開之后會有閃退現象

A：第一，在MBuilder中打包的項目的時候，基座版本不要選的太高

   第二，在插件的call方法中，不要使用UIAlert方法彈出信息，將所需的信息通過回調，返回到js中，        通過js去回調。

Q：使用get方法獲取參數值，在js中使用nav.get("v"),信息沒有返回

A：返回的參數沒有獲取到，參數需要操作成功之后通過自身的回調函數回來，js使用時并沒有獲取到這個參數值，callbackFunction是從set方法中根據前端<nativecomponent>中自定義的名稱獲取的，helper_callJsScript調用了js中的方法名稱。