|
|
# 加密功能依赖安装说明
|
|
|
|
|
|
## 必需依赖
|
|
|
|
|
|
为了使用接口加密功能，需要安装以下 npm 包：
|
|
|
|
|
|
### 1. crypto-js
|
|
|
用于 AES 对称加密
|
|
|
|
|
|
```bash
|
|
|
npm install crypto-js
|
|
|
```
|
|
|
|
|
|
### 2. jsencrypt
|
|
|
用于 RSA 非对称加密
|
|
|
|
|
|
```bash
|
|
|
npm install jsencrypt
|
|
|
```
|
|
|
|
|
|
## 安装步骤
|
|
|
|
|
|
### 方式一：使用 HBuilderX
|
|
|
|
|
|
1. 打开项目根目录
|
|
|
2. 右键点击项目名称
|
|
|
3. 选择"使用命令行窗口打开所在目录"
|
|
|
4. 执行以下命令：
|
|
|
|
|
|
```bash
|
|
|
npm install crypto-js jsencrypt
|
|
|
```
|
|
|
|
|
|
### 方式二：手动安装
|
|
|
|
|
|
如果项目根目录没有 `package.json`，需要先创建：
|
|
|
|
|
|
1. 创建 `package.json` 文件：
|
|
|
|
|
|
```json
|
|
|
{
|
|
|
"name": "stm32-iot-app",
|
|
|
"version": "1.2.0",
|
|
|
"description": "STM32 IoT UniApp",
|
|
|
"main": "main.js",
|
|
|
"scripts": {
|
|
|
"test": "echo \"Error: no test specified\" && exit 1"
|
|
|
},
|
|
|
"dependencies": {
|
|
|
"crypto-js": "^4.2.0",
|
|
|
"jsencrypt": "^3.3.2"
|
|
|
},
|
|
|
"author": "",
|
|
|
"license": "MIT"
|
|
|
}
|
|
|
```
|
|
|
|
|
|
2. 执行安装命令：
|
|
|
|
|
|
```bash
|
|
|
npm install
|
|
|
```
|
|
|
|
|
|
## 验证安装
|
|
|
|
|
|
安装完成后，检查项目根目录下是否生成了 `node_modules` 文件夹，并包含以下目录：
|
|
|
- `node_modules/crypto-js`
|
|
|
- `node_modules/jsencrypt`
|
|
|
|
|
|
## 常见问题
|
|
|
|
|
|
### Q1: HBuilderX 提示找不到模块？
|
|
|
|
|
|
**解决方案：**
|
|
|
1. 确保已正确安装依赖
|
|
|
2. 重启 HBuilderX
|
|
|
3. 清除项目缓存：菜单栏 → 运行 → 清除项目缓存
|
|
|
4. 重新编译项目
|
|
|
|
|
|
### Q2: 小程序端提示 crypto-js 不可用？
|
|
|
|
|
|
**解决方案：**
|
|
|
某些小程序平台对 Node.js 模块支持有限，可能需要：
|
|
|
1. 使用小程序原生 API
|
|
|
2. 使用兼容版本的加密库
|
|
|
3. 参考各平台文档进行适配
|
|
|
|
|
|
### Q3: App 端运行报错？
|
|
|
|
|
|
**解决方案：**
|
|
|
1. 检查 `manifest.json` 中的 App 模块配置
|
|
|
2. 确保在自定义基座中测试
|
|
|
3. 云打包时确保包含了 node_modules
|
|
|
|
|
|
## 平台兼容性
|
|
|
|
|
|
| 平台 | crypto-js | jsencrypt | 备注 |
|
|
|
|------|-----------|-----------|------|
|
|
|
| H5 | ✅ | ✅ | 完全支持 |
|
|
|
| App (iOS) | ✅ | ✅ | 完全支持 |
|
|
|
| App (Android) | ✅ | ✅ | 完全支持 |
|
|
|
| 微信小程序 | ⚠️ | ⚠️ | 需要测试验证 |
|
|
|
| 支付宝小程序 | ⚠️ | ⚠️ | 需要测试验证 |
|
|
|
| 其他小程序 | ⚠️ | ⚠️ | 需要测试验证 |
|
|
|
|
|
|
**注意：** 小程序平台可能需要额外配置或使用替代方案。
|
|
|
|
|
|
## 替代方案（针对小程序）
|
|
|
|
|
|
如果在小程序端遇到兼容性问题，可以考虑：
|
|
|
|
|
|
### 1. 使用小程序原生加密 API
|
|
|
|
|
|
```javascript
|
|
|
// 微信小程序
|
|
|
wx.crypto.getRandomValues()
|
|
|
```
|
|
|
|
|
|
### 2. 使用 uni-app 插件市场的加密插件
|
|
|
|
|
|
搜索关键词：
|
|
|
- AES 加密
|
|
|
- RSA 加密
|
|
|
- 数据加密
|
|
|
|
|
|
### 3. 后端降级处理
|
|
|
|
|
|
在小程序端关闭加密，仅在 App 和 H5 端使用：
|
|
|
|
|
|
```javascript
|
|
|
// config.js
|
|
|
export default {
|
|
|
enableEncrypt: process.env.UNI_PLATFORM === 'h5' ||
|
|
|
process.env.UNI_PLATFORM === 'app-plus',
|
|
|
// ...
|
|
|
}
|
|
|
```
|
|
|
|
|
|
## 技术支持
|
|
|
|
|
|
- UniApp 官方文档：https://uniapp.dcloud.net.cn/
|
|
|
- crypto-js 文档：https://github.com/brix/crypto-js
|
|
|
- jsencrypt 文档：https://github.com/travist/jsencrypt
|
