本文介紹了如何在微信小程序開發(fā)中使用 npm 中包的功能,大大提高微信小程序的開發(fā)效率,同時也是微信小程序系列教程的視頻版更新。
微信小程序在發(fā)布之初沒有對 npm 的支持功能,這也是目前很多前端開發(fā)人員在熟悉了 npm 生態(tài)環(huán)境后,對微信小程序詬病的地方。
微信小程序在 2.2.1 版本后增加了對 npm 包加載的支持,使得小程序支持使用 npm 安裝第三方包。
微信小程序的功能更新最近更新的也非常給力,如之前給大家介紹的 微信小程序開發(fā)平臺新功能「云開發(fā)」快速上手體驗 。
在小程序中加載 npm 包
微信小程序關(guān)于 npm 包的加載使用官方文檔在 這里 ,此實戰(zhàn)部分我們通過加載一個 npm 的第三方庫 miniprogram-datepicker ,此類庫用于實現(xiàn)公歷與農(nóng)歷的日期選擇功能,而微信小程序官方的組件只能簡單地選擇一個公歷時間。
在終端中定位到微信小程序的項目文件夾,通過 npm 的安裝命令安裝。
此處請務(wù)必使用 –production 選項,可以減少安裝一些業(yè)務(wù)無關(guān)的 npm 包,從而減少整個小程序包的大小。
構(gòu)建 npm 包
在微信小程序開發(fā)工具的「工具」菜單下點擊「構(gòu)建 npm」命令,進(jìn)行 npm 包的構(gòu)建,此構(gòu)建可以將 npm 包構(gòu)建成在小程序中可加載使用的包。
為了幫助大家更好的理解發(fā)布 npm 包中提到的各種要求,這里簡單介紹一下原理:
首先 node_modules 目錄不會參與編譯、上傳和打包中,所以小程序想要使用 npm 包必須走一遍“構(gòu)建 npm”的過程,在最外層的 node_modules 的同級目錄下會生成一個 miniprogram_npm 目錄,里面會存放構(gòu)建打包后的 npm 包,也就是小程序真正使用的 npm 包。
構(gòu)建打包分為兩種:小程序 npm 包會直接拷貝構(gòu)建文件生成目錄下的所有文件到 miniprogram_npm 中;其他 npm 包則會從入口 js 文件開始走一遍依賴分析和打包過程(類似 webpack)。
尋找 npm 包的過程和 npm 的實現(xiàn)類似,從依賴 npm 包的文件所在目錄開始逐層往外找,直到找到可用的 npm 包或是小程序根目錄為止。
構(gòu)建完成后還需要確認(rèn)項目已勾選了「使用 npm 模塊」。
在項目中使用第三方模塊
在我們之前實戰(zhàn)項目中,在首頁中測試下此 npm 模塊的加載。
在頁面中布局完 datepicker 后,保存并完成項目的編譯后,點擊按鈕即可看到組件的加載情況。
推薦:《小程序開發(fā)教程》