在
使用JavaScript開發WPS載入項(一)
中,我們初步瞭解瞭如何建立一個WPS的載入專案,並簡單瞭解瞭如何編寫外掛,本文我們介紹,如下內容:
如何進行載入項的除錯。
善用REPL。
如果釋出部署。
一、除錯
一個Js的載入項被載入後按
ALT+F12
快捷鍵,可以開啟DevTool,熟悉前端開發的同學,應該不會陌生,熟悉的配方,熟悉的味道。
WPS載入項除錯演示
二、REPL
剛看到repl這個詞的時候有的同學可能會覺得陌生,應該叫做互動式解析器。
R(read)、E(evaluate)、P(print)、L(loop)
讀取、解析、輸出、迴圈此過程,週而復始。
為什麼要提到REPL,很大一部分原因是我使用Clojure/ClojureScript的緣故。
善用這個工具,我們可以隨時驗證自己的想法,以一種非常直觀的方式在測試程式碼。
REPL演示圖
// 設定當前單元格值wps。Application。ActiveCell。Value2=“Hello”; // 繫結事件wps。ApiEvent。AddApiEventListener(“SheetChange”,()=>console。log(“單元格改變了”));
三、釋出部署
載入項開發完成後需要交付給客戶,現對官方給出的開發文件中細節部分進行補充。
根據官方文件介紹,JavaScript開發的載入項有兩種部署模式可選:
publish模式(適用於:企業版20200425分支之後版本)
jsplugins.xml模式(適用於:2019版本,2020發的版本)。
且這兩種模式都需要一個用於部署的伺服器(其中jsplugins.xml模式可以實現純離線模式部署,就是不需要伺服器,需要手工部署,對於使用者來說不是很友好)。
publish模式是
最方便的,但僅適用於企業版。
publish模式演示
本機未安裝WPS企業版,我們選擇jsplugins。xml模式繼續本文後續內容。
jsplugins.xml模式的部署步驟如下:
使用wpsjs build編譯載入專案(分為線上和離線兩種模式)。
將編譯完成的檔案及
jsplugins.xml
部署到伺服器(直接複製到伺服器上)。
使用者在本地修改oem。ini檔案以定位載入項部署伺服器。
我們逐一講解一下部署涉及到的一些細節問題。
線上和離線的區別:
線上顧名思義程式碼是部署在線上的每次載入外掛的時候都會請求資源;
而離線是將線上部署的壓縮包下載到本地,非版本變更不更新;
還有一種無伺服器,手工部署離線的方式,本文不做討論,感興趣的同學,自行前往官網閱讀文件。
部署伺服器的要求:
靜態資源伺服器就可以,Nginx足可以勝任。
jsplugins.xml:
name顧名思義外掛的名稱,type是外掛的宿主型別(et為表格),url外掛所在遠端目錄。
oem.ini檔案:
這個檔案在WPS的安裝目錄的cfgs資料夾中,內容類似如下:
[Setup]
Silent=0
LaunchWPS=1
LaunchCenter=1
CreateDesktopShortcut=1
SendInstallSource=1
LANG_ID=1031
BUILD_VERSION=11。1。0。10314
Industry=
PipeNumber=12012。2019
SourceDir=oeminfo
[feature]
xn3QfP-XIpyKSU9I2xbCubad10=hn3QfP-XIpyk99gTmjC7T6IF10
[Support]
JsApiPlugin=true
JsApiShowWebDebugger=true
[Server]
JSPluginsServer=http://127。0。0。1/plugin/
注意
JSPluginsServer
所配置的遠端目錄不是外掛所在目錄,而是
jsplugins.xml
檔案所在目錄。
四、結語
本文淺嘗輒止地談及了JavaScript開發WPS載入項的一些常用操作,希望對有此方面需求的同學有所幫助,
歡迎大家轉發、評論
。