跳到正文

小程序构建插件 ​

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

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

bash
pnpm add miniprogram-formdata miniprogram-blob

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

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 构建保持原始模块不变。

找不到 miniprogram-blob 或 miniprogram-formdata ​

  1. 在实际运行小程序构建的应用目录执行上面的依赖安装命令。Monorepo 中确认兼容包是该应用的依赖。
  2. 确认构建配置已注册对应的 Vite 或 Webpack 插件,目标平台以 mp- 开头。
  3. 用项目原有的小程序构建命令重新构建,确认缺包错误消失并生成对应平台的产物。使用上传的项目可在开发者工具中选取一个测试文件,检查请求能发送并得到预期响应。