前言
工作之余写了个CNode 社区小程序,零零散散两个月的时间,通常是晚上下班后,或者早上上班前抽些时间写一会,现在终于发布v1.0.0版本,欢迎扫码预览👏。
预览
微信小程序 npm 支持特性遇到的坑
从小程序基础库版本 2.2.1 或以上、及开发者工具 1.02.1808300 或以上开始,小程序支持使用 npm 安装第三方包。
-
由于项目中需要格式化一些日期数据,于是选择了moment,一款JavaScript 日期处理类库
-
首先使用命令行,安装
moment
# 打开小程序根目录 cd src npm install --production moment
-
然后按照小程序文档往下操作,直到构建完成
-
于是我们迫不及待的开始使用
moment
import moment from 'moment'; let sFromNowText = moment(new Date() - 360000).fromNow(); console.log(sFromNowText); // 控制台输出:"6 minutes ago"
-
moment
能够正常工作,但是很快我们发现英文不是我们想要的 -
于是我们找到
moment
的国际化配置,并设置全局语言为
中文import moment from 'moment'; moment.locale('zh-cn'); let sFromNowText = moment(new Date() - 360000).fromNow(); console.log(sFromNowText); // 可是控制台,依然输出:"6 minutes ago"
-
尝试输出
moment.locale
执行后的返回值// ... let sLang = moment.locale('zh-cn'); console.log(sLang); // 控制台输出:"en"
-
发现设置语言环境失败了,经过排查和翻阅小程序文档后,发现通过微信开发者工具
构建npm
后,并不会将语言环境相关文件拷贝到miniprogram_npm
目录下,仅将入口js文件及其依赖的模块进行打包处理,进而导致加载中文语言环境失败。以下是摘自小程序文档的一段话:构建打包分为两种:小程序 npm 包会直接拷贝构建文件生成目录下的所有文件到 miniprogram_npm 中;其他 npm 包则会从入口 js 文件开始走一遍依赖分析和打包过程(类似 webpack)。
-
快速查看了一下
moment
源码,发现moment.locale
方法,会从./locale/
目录下加载语言环境包,于是尝试手动从node_modules/moment/
目录下,将中文语言环境包,拷贝到miniprogram_npm
目录下// moment.js // ... function loadLocale(name) { // ... var aliasedRequire = require; aliasedRequire('./locale/' + name); // ... } // ...
-
经过调试发现,
moment
定义语言环境时出错,原来是由于构建npm
导致入口文件(moment.js
)经过打包后更名为index.js
导致: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'
统一改为'../index'
,然后重新执行import moment from 'moment'; moment.locale('zh-cn'); let sFromNowText = moment(new Date() - 360000).fromNow(); console.log(sFromNowText); // 现在控制台,输出:"6 分钟前"
-
大功告成,nice! 但也别忘了回过头来,总结一下导致这几个问题的原因:
构建npm
会将npm包的入口文件(eg: moment.js),打包后更名为index.js
构建npm
仅将npm包的入口js文件及其依赖的模块进行打包处理,除此之外的文件(eg: moment的语言环境包)并不会做打包处理
miniprogram_npm
、构建npm
及更多npm支持相关信息,请翻阅小程序文档-npm支持
感想
楼主的第一个微信小程序,从开发到提审,也是几经波折,纪念一下
附上github地址:github.com/Lsnsh/cnode…
欢迎star,持续更新🎉