微信小程序使用npm支持踩坑


Posted in Javascript onNovember 07, 2018

前言

最近写了个CNode 社区的微信小程序版本,把在微信小程序中使用npm包,踩的坑记录一下,希望能给遇到类似问题的小伙伴,提供一些思路和方向。

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文件及其依赖的模块进行打包处理,并不会将该npm包下一些可选的文件(eg: moment的语言环境包)拷贝到miniprogram_npm目录下

miniprogram_npm 、构建npm及更多npm支持相关信息,请翻阅小程序文档-npm支持

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

Javascript 相关文章推荐
Jquery显示、隐藏元素以及添加删除样式
Aug 09 Javascript
jQuery-1.9.1源码分析系列(十一)DOM操作续之克隆节点
Dec 01 Javascript
javascript点击按钮实现隐藏显示切换效果
Feb 03 Javascript
vue.js初学入门教程(2)
Nov 07 Javascript
jQuery将表单序列化成一个Object对象的实例
Nov 29 Javascript
jquery ajaxfileupload异步上传插件使用详解
Feb 08 Javascript
详解基于Bootstrap+angular的一个豆瓣电影app
Jun 26 Javascript
详解如何在vscode里面调试js和node.js的方法步骤
Dec 24 Javascript
js计算最大公约数和最小公倍数代码实例
Sep 11 Javascript
js实现坦克大战游戏
Feb 24 Javascript
详解JavaScript中的Object.is()与"==="运算符总结
Jun 17 Javascript
vue点击弹窗自动触发点击事件的解决办法(模拟场景)
May 25 Vue.js
Angular Material Icon使用详解
Nov 07 #Javascript
详解Webpack loader 之 file-loader
Nov 07 #Javascript
JS复杂判断的更优雅写法代码详解
Nov 07 #Javascript
javascript动态创建对象的属性详解
Nov 07 #Javascript
在vue中使用express-mock搭建mock服务的方法
Nov 07 #Javascript
详解在vue-test-utils中mock全局对象
Nov 07 #Javascript
vue-cli 首屏加载优化问题
Nov 06 #Javascript
You might like
用PHP实现图象锐化代码
2007/06/14 PHP
PHP小程序自动提交到自助友情连接
2009/11/24 PHP
PHP 利用Mail_MimeDecode类提取邮件信息示例
2014/01/26 PHP
php中$_GET与$_POST过滤sql注入的方法
2014/11/03 PHP
php表单提交与$_POST实例分析
2015/01/26 PHP
PHP中is_file()函数使用指南
2015/05/08 PHP
PHP读取汉字的点阵数据
2015/06/22 PHP
PHP+iframe图片上传实现即时刷新效果
2016/11/18 PHP
JQuery1.6 使用方法三
2011/11/23 Javascript
浅谈jQuery构造函数分析
2015/05/11 Javascript
js性能优化技巧
2015/11/29 Javascript
JavaScript常用代码书写规范的超全面总结
2016/09/11 Javascript
微信小程序组件 marquee实例详解
2017/06/23 Javascript
ES6学习教程之对象字面量详解
2017/10/09 Javascript
基于vue-cli 路由 实现类似tab切换效果(vue 2.0)
2019/05/08 Javascript
javascript实现简易聊天室
2019/07/12 Javascript
vue源码nextTick使用及原理解析
2019/08/13 Javascript
在layui.use 中自定义 function 的正确方法
2019/09/16 Javascript
微信小程序 点击切换样式scroll-view实现代码实例
2019/10/11 Javascript
15 分钟掌握vue-next响应式原理
2019/10/13 Javascript
vue 虚拟DOM的原理
2020/10/03 Javascript
微信小程序实现列表左右滑动
2020/11/19 Javascript
[02:41]辉夜杯现场一家三口 “我爸玩风行 我玩血魔”
2015/12/27 DOTA
[01:30]我们共输赢 完美世界城市挑战赛开启全新赛季
2019/04/19 DOTA
[42:24]完美世界DOTA2联赛循环赛 LBZS vs DM BO2第一场 11.01
2020/11/02 DOTA
让Python更加充分的使用Sqlite3
2017/12/11 Python
tensorflow2.0的函数签名与图结构(推荐)
2020/04/28 Python
StubHub巴西:购买和出售您的门票
2016/07/22 全球购物
师德个人剖析材料
2014/02/02 职场文书
党员入党表决心的话
2014/03/11 职场文书
工厂搬迁方案
2014/05/11 职场文书
作风建设年活动实施方案
2014/10/24 职场文书
会计工作总结范文2014
2014/12/23 职场文书
工程部经理岗位职责
2015/02/02 职场文书
MySQL之select、distinct、limit的使用
2021/11/11 MySQL
分享node.js实现简单登录注册的具体代码
2022/04/26 NodeJs