小程序安装Vant Weapp详细步骤,下载和npm安装版

梦里梦外; 2024-03-16 11:53 42阅读 0赞

#### 小程序安装Vant Weapp详细步骤 ####

*  使用npm下载
 *   *  1、新建项目并初始化项目
     *  2、下载Vant Weapp
     *  3、修改 app.json
     *  4、构建 npm 包
     *  5、引入组件
 *  下载方式
 *   *  1. npm下载或者下载\[官方示例\](https://github.com/youzan/vant-weapp)
     *  2. 把里面的\`dist\`文件夹复制出来，放到项目的根目录，重命名为\`vantweapp\`
     *  3. 使用组件，以button为例，这是官方的引入，将红框中的复制，写在\`app.json\`中
     *  4. 将路径改成这样
     *  5. 如果是写在单个页面的json中，路径前面加\`../../\`

![在这里插入图片描述][1ba954309b324eb9bd60a23710de5f5a.png]

## 使用npm下载 ##

### 1、新建项目并初始化项目 ###

见这篇博客：[微信小程序构建npm（js和ts）][npm_js_ts]

### 2、下载Vant Weapp ###

# 通过 npm 安装
    npm i @vant/weapp -S --production
    
    # 通过 yarn 安装
    yarn add @vant/weapp --production
    
    # 安装 0.x 版本
    npm i vant-weapp -S --production

### 3、修改 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": "./miniprogram/"//ts用，js直接./
          }
        ]
      }
    }

注意： 由于目前新版开发者工具创建的小程序目录文件结构问题，npm构建的文件目录为miniprogram\_npm，并且开发工具会默认在当前目录下创建miniprogram\_npm的文件名，所以新版本的miniprogramNpmDistDir配置为’./'即可

### 4、构建 npm 包 ###

打开微信开发者工具，点击 工具 -> 构建 npm，并勾选 使用 npm 模块 选项，构建完成后，即可引入组件。  
**如果是ts版本，先删除project.config.json中setting中的useCompilerPlugins**  
每次构建npm都要记得删除，构建结束记得还原回来  
![在这里插入图片描述][6ca1a4ab398d4c4086df02ffd54e0544.png]

![在这里插入图片描述][d2fd2db99373453f8105b102ad1cdaf6.png]

### 5、引入组件 ###

以 Button 组件为例，只需要在app.json或index.json中配置 Button 对应的路径即可。

"usingComponents": {
        
      "van-button": "@vant/weapp/button/index"
    }

<van-button type="primary">按钮</van-button>

## 下载方式 ##

流程：

### 1. npm下载或者下载[官方示例][Link 1] ###

npm i @vant/weapp -S --production

下载完的目录  
![在这里插入图片描述][20201204143220360.png]

### 2. 把里面的`dist`文件夹复制出来，放到项目的根目录，重命名为`vantweapp` ###

现在的结构目录如下  
![在这里插入图片描述][20201204144033555.png]

### 3. 使用组件，以button为例，这是官方的引入，将红框中的复制，写在`app.json`中 ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xoa3V4aWE_size_16_color_FFFFFF_t_70]

### 4. 将路径改成这样 ###

一定要确保路径是对的

"van-button": "vantweapp/button/index"

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xoa3V4aWE_size_16_color_FFFFFF_t_70 1]

### 5. 如果是写在单个页面的json中，路径前面加`../../` ###

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xoa3V4aWE_size_16_color_FFFFFF_t_70 2]

[1ba954309b324eb9bd60a23710de5f5a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/a947ad6872724802983af324ac5b5c88.png
[npm_js_ts]: https://blog.csdn.net/lhkuxia/article/details/130982652?spm=1001.2014.3001.5501
[6ca1a4ab398d4c4086df02ffd54e0544.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/10df684530e7480f9bd372dc75a64a51.png
[d2fd2db99373453f8105b102ad1cdaf6.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/759b46077b4b471a84ae509d2361321a.png
[Link 1]: https://github.com/youzan/vant-weapp
[20201204143220360.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/521efbc552f642509b918d3b6a81e0a6.png
[20201204144033555.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/4b1fb258b8f343c6a50a31810037bc81.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xoa3V4aWE_size_16_color_FFFFFF_t_70]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/6ee2a832c862406cb15ea1241e28f39f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xoa3V4aWE_size_16_color_FFFFFF_t_70 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/4733933a061542b28e9be1e944c9b669.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2xoa3V4aWE_size_16_color_FFFFFF_t_70 2]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/16/b3683709e84945ba9edb09a2a9cf35c2.png