94 lines
2.4 KiB
Markdown
94 lines
2.4 KiB
Markdown
|
# @r-utils/uni-app
|
|||
|
|
|
|||
|
|
仅用于 uni-app 项目的工具包，封装请求、上传、NFC、蓝牙、打印和常用 uni API 辅助方法。
|
|||
|
|
|
|||
|
|
## 适用范围
|
|||
|
|
|
|||
|
|
- 适用于 uni-app 项目（含 uni 运行时能力）。
|
|||
|
|
- 适用于需要复用请求、上传、蓝牙、NFC、打印等能力的业务项目。
|
|||
|
|
|
|||
|
|
## 不适用范围
|
|||
|
|
|
|||
|
|
- 不适用于普通 Web Vue2/Vue3 项目。
|
|||
|
|
- 不适用于没有 `uni` 运行时的纯 Node.js 环境。
|
|||
|
|
|
|||
|
|
## 安装
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
pnpm add @r-utils/uni-app
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 导入方式
|
|||
|
|
|
|||
|
|
### 推荐：根入口导入
|
|||
|
|
|
|||
|
|
大多数场景推荐从根入口导入，路径简单，使用心智负担更低。
|
|||
|
|
|
|||
|
|
```ts
|
|||
|
|
import { Request, showToast, toPromise, upload, Printer } from "@r-utils/uni-app";
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 兼容：子路径导入
|
|||
|
|
|
|||
|
|
如果你希望模块边界更清晰，也可以使用子路径导入。两种方式都支持。
|
|||
|
|
|
|||
|
|
```ts
|
|||
|
|
import { Request } from "@r-utils/uni-app/request";
|
|||
|
|
import { showToast, toPromise } from "@r-utils/uni-app/uni-helper";
|
|||
|
|
import { upload } from "@r-utils/uni-app/upload";
|
|||
|
|
import { Printer } from "@r-utils/uni-app/printer";
|
|||
|
|
import { nfcScan } from "@r-utils/uni-app/nfc";
|
|||
|
|
import { BluetoothUtils } from "@r-utils/uni-app/bluetooth-utils";
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 导出模块
|
|||
|
|
|
|||
|
|
| 子路径 | 说明 |
|
|||
|
|
| --- | --- |
|
|||
|
|
| `@r-utils/uni-app/request` | 类 axios 的 `uni.request` 封装 |
|
|||
|
|
| `@r-utils/uni-app/uni-helper` | 常用 uni API 辅助函数 |
|
|||
|
|
| `@r-utils/uni-app/upload` | 上传相关工具 |
|
|||
|
|
| `@r-utils/uni-app/printer` | 打印机相关工具 |
|
|||
|
|
| `@r-utils/uni-app/nfc` | NFC 相关工具 |
|
|||
|
|
| `@r-utils/uni-app/bluetooth-utils` | 蓝牙相关工具 |
|
|||
|
|
|
|||
|
|
## 使用示例
|
|||
|
|
|
|||
|
|
### 请求封装
|
|||
|
|
|
|||
|
|
```ts
|
|||
|
|
import { Request } from "@r-utils/uni-app";
|
|||
|
|
|
|||
|
|
const request = new Request({
|
|||
|
|
baseURL: "https://api.example.com",
|
|||
|
|
});
|
|||
|
|
|
|||
|
|
const res = await request.get("/users", {
|
|||
|
|
data: { pageNum: 1, pageSize: 10 },
|
|||
|
|
});
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 使用 showToast
|
|||
|
|
|
|||
|
|
```ts
|
|||
|
|
import { showToast } from "@r-utils/uni-app";
|
|||
|
|
|
|||
|
|
showToast("保存成功", "success");
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 子路径导入请求模块
|
|||
|
|
|
|||
|
|
```ts
|
|||
|
|
import { Request } from "@r-utils/uni-app/request";
|
|||
|
|
|
|||
|
|
const request = new Request({
|
|||
|
|
baseURL: "https://api.example.com",
|
|||
|
|
});
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 注意事项
|
|||
|
|
|
|||
|
|
- 推荐优先使用根入口导入；如果需要更精确的模块边界，也可以使用子路径导入。
|
|||
|
|
- 本包依赖 uni-app 运行时能力，需在真实 uni-app 环境中验证平台相关功能。
|
|||
|
|
- NFC、蓝牙、打印功能通常依赖具体平台和设备能力，建议按目标端单独测试。
|