前言:快應用開發工具,是一款專為快應用開發設計的應用,簡單易用、靈活擴展、并能夠全面支持聯盟標準規范。
微注:本文首發于 vivo 快應用開發博客 - 快應用開發工具入門介紹。
在理想狀態下,開發者應當已經熟悉 Web 前端基礎知識。下列途徑有助您更好了解如何開發快應用前端應用:
- 了解快應用的 框架 、組件 、接口 、平臺 和 其他
- 參考快應用 sample ,其中包含絕大部分組件與 API 的示例代碼與運行效果,可被用作從入門到進階的百科全書。
- 推薦使用一套豐富完整的組件庫 Apex-UI,可以安裝即用,提供了多達 50+ 的組件,幫助開發者快速開發快應用。
下面,我們就循序漸進對快應用 IDE 做下介紹,使得您可以參考之,從而快速入門使用。
快速開始
安裝最新版快應用開發工具 , 快應用的開發工作在 IDE 中展開。以下是開發環節的基本流程:
開發調試
新建項目
可供新建的項目分為兩類:快應用或卡片。新建方法如下:
- 點擊菜單欄「新建快應用工程」、「快捷入口」、「新建快應用工程」、或者「歡迎頁新建工程」 ,打開新建工程界面;
- 點擊下一步 ,填寫項目名稱、項目路徑、應用名稱和應用包名,點擊完成 ,快應用開發工具會在項目路徑下新建改項目并自動打開;
- 新建卡片工程步驟,與新建快應用項目相同;界面展示如下截圖:
代碼編輯預覽
快應用基于前端技術棧,類比 Vue 實用 .vue
充當文件后綴,快應用實用 .ux
;IDE 專門有對具體代碼做處理,使得可以對這類語法提供支持和 Eslint 檢測;具體參考如下說明:
ux 文件語法輔助
Eslint 語法檢測
預覽調試
在開發過程中,快應用的運行效果會在主界面右側的 模擬器 中顯示。由于模擬器尚未支持全部API,因此您還需要使用真機來預覽與調試快應用的實際運行情況。
本地預覽
在你身邊沒有手機的時候,可以通過快應用開發工具的本地預覽功能,查看代碼的運行效果。右側模擬器中的顯示的內容為快應用編譯之后的效果,對應調試器的面板定制了 UX 面板:它展示預覽的 Dom 結構以及樣式,支持實時修改樣式規則、命名以及元素屬性;定制了 Data面板:展示頁面數據,主要指 .ux 文件中的 private、protected、public 字段,可以根據自己的需要,開啟自動刷新。
真機調試
若需要真機調試,請插上數據線、連上手機并打開手機 USB 調試,在開發工具提示連接成功之后,點擊頂部工具欄 USB 調試 ,若手機未安裝快應用的引擎和調試器,開發工具會自動幫您安裝到手機上,只需在手機上確定安裝該應用。安裝成功之后,會自動打開調試器,并調起正在開發的快應用,可以在新的 DevTools 的面板上進行調試以及查看 log 信息。
遠程真機預覽
若沒有手機,又想要查看真機上的運行效果時,「遠程預覽」功能是一個不錯的選擇。如何使用步驟如下:
- 點擊模擬器上方的遠程預覽按鈕,若未安裝插件,請選擇安裝遠程真機插件;
- 安裝成功之后,繼續選擇遠程預覽并選擇平臺進行登錄;
- 登錄成功之后,出現可以使用的機型列表;
- 選擇想要的機型,點擊使用,開發工具將自動上傳 RPK 到遠程真機上,并調起調試器,可以直接看到真機上的真實效果。后續可手動點擊上傳預覽按鈕,查看效果;
上傳發布
上傳至包管理平臺
開發完成之后,若您想分享開發的快應用給別人使用,但又想要不局限于局域網內的訪問,可以將 RPK 包上傳至包管理平臺,可以方便地幫助您解決這個苦惱,如何上傳至包管理平臺步驟如下。
- 點擊頂部工具欄的「打包 」按鈕,快應用開發工具將自動生成 release 簽名的包,若無簽名,會索引您添加簽名。
- 打包成功之后,可以點擊彈窗的「上傳包管理平臺 」按鈕,開發工具會將打出來的 RPK 包上傳至包管理平臺,若未登錄,需先登錄 官網賬號。
- 上傳成功之后,會出現一個二維碼和包管理平臺的鏈接,您可使用調試器的掃碼功能,打開此快應用。
上傳至官網
在開發完成之后,若您想發布上線該快應用,可以通過快應用開發工具的「上傳」功能,將其上傳至官網的開發者中心,后續可在官網按照流程填寫相關信息后,發布上線快應用。若想實時在開發工具中查看官網正在審核的快應用狀態,可使用頂部的「關聯快應用」功能,關聯之后,點擊「詳情」 ,可查看上傳之后的快應用信息。
[站外圖片上傳中...(image-102a0f-1597225367933)]
在了解了基本的功能之后,若想更進一步玩轉快應用開發工具,以下功能能夠使您錦上添花。
體驗增強
編譯模式
使用編譯模式,可配置編譯的啟動頁面和啟動參數,方便調試頁面,支持導入和導出編譯模式。
插件功能快捷入口
有些內置功能,如:新建快應用功能;或者插件攜帶功能如:一鍵轉微信小程序至快應用。為了方便您簡易使用和開發這些功能,特此在側邊欄,注入快捷入口。
意見反饋
側邊欄的「反饋」按鈕,可上傳 issue 到 GitHub,若您有什么疑問,能夠向我們反饋問題,在提交之前,可以先檢索,以避免重復提交。