Skip to content

小程序构建插件

接入插件后,平台判断和模块转换会自动进行。使用者不用手动修改 Axios 内部文件,也不用另写 Vite 的 optimizeDeps.exclude。但插件需要在应用构建配置中注册一次:根入口的 FastAxios 或 adapter 不会替应用注入 Vite/Webpack 插件。若现有构建配置已经注册,就不要重复添加。

小程序兼容包仍由应用显式安装,插件不会自动安装依赖:

bash
pnpm add miniprogram-formdata miniprogram-blob

Vite 项目使用独立子路径,插件只在 UNI_PLATFORMmp- 开头时生效:

ts
import { defineConfig } from "vite";
import uniAppAxiosPlugin from "@fast-china/axios/vite";

export default defineConfig({
	plugins: [uniAppAxiosPlugin()],
});

Webpack 项目使用:

ts
import uniAppAxiosPlugin from "@fast-china/axios/webpack";

export default {
	plugins: [uniAppAxiosPlugin()],
};

插件会替换 Axios 的 FormData、Blob 平台模块,并在应用项目缺少对应兼容包时直接终止构建。H5、App 和普通 Web 构建保持原始模块不变。