一、初始化npm
在项目根目录下执行 npm init 命令,初始化项目,命令执行完毕后会在根目录下生成 package.json 文件。
注意:执行 npm init 命令后,不需要单独配置,全部回车一直到就可以。
二、通过 npm 安装 Vant Weapp
npm i @vant/weapp -S --production
三、修改 app.json
将 app.json 中的 “style”: “v2” 去除,小程序的新版基础组件强行加上了许多样式,难以覆盖,不关闭将造成部分组件样式混乱。
四、修改 project.config.json
开发者工具创建的项目,miniprogramRoot 默认为 miniprogram,package.json 在其外部,npm 构建无法正常工作。
需要手动在 project.config.json 内添加如下配置,使开发者工具可以正确索引到 npm 依赖的位置。
{
...
"setting": {
...
"packNpmManually": true,
"packNpmRelationList": [
{
"packageJsonPath": "./package.json",
"miniprogramNpmDistDir": "./"
}
]
}
}
五、构建 npm 包
打开微信开发者工具,点击 设置-> 项目设置,勾选 使用 npm 模块 选项。然后点击 工具 -> 构建 npm,构建完成后,即可引入组件。
六、使用
在项目的 app.json 或 页面的 index.json 中配置需要的组件对应的路径即可。
以 Button 组件为例:
// app.json 或 jindex.json
"usingComponents": {
"van-button": "@vant/weapp/button/index"
}
参考资料:
https://vant-contrib.gitee.io/vant-weapp/#/quickstart#bu-zou-si-gou-jian-npm-bao
https://developers.weixin.qq.com/miniprogram/dev/devtools/npm.html#_2-%E6%9E%84%E5%BB%BA-npm