前言
最近寫了個CNode 社區(qū)的微信小程序版本,把在微信小程序中使用npm包,踩的坑記錄一下,希望能給遇到類似問題的小伙伴,提供一些思路和方向。
npm 支持
從小程序基礎(chǔ)庫版本 2.2.1 或以上、及開發(fā)者工具 1.02.1808300 或以上開始,小程序支持使用 npm 安裝第三方包。
踩坑之路
由于項目中需要格式化一些日期數(shù)據(jù),于是選擇了moment,一款JavaScript 日期處理類庫
首先使用命令行,安裝moment
# 打開小程序根目錄 cd src npm install --production moment
然后按照小程序文檔往下操作,直到構(gòu)建完成
于是我們迫不及待的開始使用moment
import moment from 'moment'; let sFromNowText = moment(new Date() - 360000).fromNow(); console.log(sFromNowText); // 控制臺
moment能夠正常工作,但是很快我們發(fā)現(xiàn)英文不是我們想要的
于是我們找到moment的國際化配置,并設(shè)置全局語言為中文
import moment from 'moment'; moment.locale('zh-cn'); let sFromNowText = moment(new Date() - 360000).fromNow(); console.log(sFromNowText); // 可是控制臺,依然
嘗試輸出moment.locale執(zhí)行后的返回值
// ... let sLang = moment.locale('zh-cn'); console.log(sLang); // 控制臺
發(fā)現(xiàn)設(shè)置語言環(huán)境失敗了,經(jīng)過排查和翻閱小程序文檔后,發(fā)現(xiàn)通過微信開發(fā)者工具構(gòu)建npm
后,并不會將語言環(huán)境相關(guān)文件拷貝到miniprogram_npm
目錄下,僅將入口js文件及其依賴的模塊進行打包處理,進而導(dǎo)致加載中文語言環(huán)境失敗。以下是摘自小程序文檔的一段話:
構(gòu)建打包分為兩種:小程序 npm 包會直接拷貝構(gòu)建文件生成目錄下的所有文件到 miniprogram_npm 中;其他 npm 包則會從入口 js 文件開始走一遍依賴分析和打包過程(類似 webpack)。
快速查看了一下moment源碼,發(fā)現(xiàn)moment.locale方法,會從./locale/目錄下加載語言環(huán)境包,于是嘗試手動從node_modules/moment/目錄下,將中文語言環(huán)境包,拷貝到miniprogram_npm目錄下
// moment.js // ... function loadLocale(name) { // ... var aliasedRequire = require; aliasedRequire('./locale/' + name); // ... } // ...
經(jīng)過調(diào)試發(fā)現(xiàn),moment定義語言環(huán)境時出錯,原來是由于構(gòu)建npm導(dǎo)致入口文件(moment.js)經(jīng)過打包后更名為index.js導(dǎo)致:Error: module "miniprogram_npm/moment/moment" is not defined
// zh-cn.js (function(global, factory) { typeof exports === 'object' && typeof module !== 'undefined' && typeof require === 'function' ? factory(require('../moment')) : typeof define === 'function' && define.amd ? define(['../moment'], factory) : factory(global.moment); })(this, function(moment) { 'use strict'; var zhCn = moment.defineLocale('zh-cn', { // ... }); return zhCn; });
果然手動將'../moment'統(tǒng)一改為'../index',然后重新執(zhí)行
import moment from 'moment'; moment.locale('zh-cn'); let sFromNowText = moment(new Date() - 360000).fromNow(); console.log(sFromNowText); // 現(xiàn)在控制臺,
大功告成,nice! 但也別忘了回過頭來,總結(jié)一下導(dǎo)致這幾個問題的原因:
miniprogram_npm 、構(gòu)建npm及更多npm支持相關(guān)信息,請翻閱小程序文檔-npm支持
聲明:本網(wǎng)頁內(nèi)容旨在傳播知識,若有侵權(quán)等問題請及時與本網(wǎng)聯(lián)系,我們將在第一時間刪除處理。TEL:177 7030 7066 E-MAIL:11247931@qq.com