vite-plugin-uni-platform-loader

一个基于vite的，在uniapp中使用的插件。会根据当前编译的平台（默认是h5）自动加载对应的文件。

例如：h5平台默认加载index.vue；微信小程序平台会加载index.mp-weixin.vue，若没有则加载index.vue。

安装

在.npmrc中指定镜像

vite-plugin-uni-platform-loader:registry=https://registry.npmjs.org/

安装插件

npm i -D vite-plugin-uni-platform-loader

使用

在vite.config.ts中使用

import UniPlatformLoader from 'vite-plugin-uni-platform-loader';
import path from 'path';

export default defineConfig({
  plugins: [
    UniPlatformLoader({
      platform: process.env.UNI_PLATFORM,
      rootDir: path.resolve(__dirname, 'src'),
    }),
  ],
});

插件选项

参数名	类型	默认值	说明
rootDir	string	src	根目录
platform	string	h5	平台

实现原理

vite-plugin-uni-platform-loader插件会监听rootDir目录下的文件变化，当文件发生变化时，会更新默认文件中的注释，重新触发vite的构建。

vite构建时在transform钩子中寻找当前文件与平台匹配的文件（例如：小程序平台会根据index.vue寻找index.mp-weixin.vue文件），并返回文件内容。

需要注意的是：h5平台会忽略index.h5.vue文件，因为index.vue默认为h5平台的文件

更新日志

版本	更新内容
1.0.6	更新README
1.0.5	修复默认rootDir路径错误问题
1.0.4	更新README
1.0.3	修复微信小程序平台文件重新加载问题