axios-uni-adapter v0.0.5

axios 的小程序适配器，支持在各个平台小程序中使用 axios

:star: 特性

• 支持微信、支付宝、钉钉、百度小程序，放心使用 axios，最大限度复用 web 端 axios 的代码
• 支持 TypeScript

:open_file_folder: 目录介绍

.
├── demo 使用demo
├── dist 编译产出代码
├── doc 项目文档
├── src 源代码目录
├── test 单元测试
├── CHANGELOG.md 变更日志
└── TODO.md 计划功能

:rocket: 使用者指南

1.如果你是 webpack 等环境

通过 npm 下载安装代码

$ npm i axios axios-miniprogram-adapter

import axios from "axios";
import mpAdapter from "axios-miniprogram-adapter";
axios.defaults.adapter = mpAdapter;

2.如果你没有使用任何脚手架工具

直接使用小程序开发工具自带的构建npm，请按下面几个步骤引入：

• 确保项目目录下有 package.json 文件，已有的跳过这一步

$ npm init

• 安装

$ npm i axios axios-miniprogram-adapter

• 在小程序开发者工具中依次找到并点击工具->构建npm，构建完成后你的项目目录会多出一个miniprogram_npm目录

• 代码引入使用

import axios from "axios";
import mpAdapter from "axios-miniprogram-adapter";
axios.defaults.adapter = mpAdapter;

这里有一个代码片段 demo 可直接供你使用:https://developers.weixin.qq.com/s/oIqQtBml7F4N,DEMO 源码点这里也可查看

3.如果你没有使用任何脚手架工具且 npm 也不用(不推荐)

直接拷贝编译后的axios、axios-miniprogram-adapter到项目中:

import axios from "你的目录/axios.js";
import mpAdapter from "你的目录/axios-miniprogram-adapter.js";
axios.defaults.adapter = mpAdapter;

三种方式区别

小程序自带的 npm 不支持解析 node_modules 中的库再有外部依赖：例如本库中依赖了axios库的某些工具包，在源码中有下面的代码：

import utils from "axios/lib/utils";

在小程序开发工具中会报错，找不到此依赖。为此，我将依赖打包到一起，这样带来的问题是库的体积多了 2kb，基于此，强烈推荐你使用类似于 webpack 的脚手架工具开发

:bookmark_tabs: 文档

• 同 axios 官方仓库一致
• 与官方 API 的差异、注意事项

:chestnut: Demo

打开小程序开发者工具，根据不同平台，选择各自的目录作为项目根目录：

• 微信axios-miniprogram-adapter/demo/miniprograme-example/dist-wechat
• 支付宝、钉钉axios-miniprogram-adapter/demo/miniprograme-example/dist-alipay
• 百度 axios-miniprogram-adapter/demo/miniprograme-example/dist-swan

该 demo 示范了几个常用功能的用法:

点击查看代码具体用法示例

:gear: 更新日志

CHANGELOG.md

:airplane: 计划列表

TODO.md