3.0 KiB

Raw Permalink Blame History

加密功能依赖安装说明

必需依赖

为了使用接口加密功能，需要安装以下 npm 包：

1. crypto-js

用于 AES 对称加密

npm install crypto-js

2. jsencrypt

用于 RSA 非对称加密

npm install jsencrypt

安装步骤

方式一：使用 HBuilderX

打开项目根目录
右键点击项目名称
选择"使用命令行窗口打开所在目录"
执行以下命令：

npm install crypto-js jsencrypt

方式二：手动安装

如果项目根目录没有 package.json，需要先创建：

创建 package.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"
}

执行安装命令：

npm install

验证安装

安装完成后，检查项目根目录下是否生成了 node_modules 文件夹，并包含以下目录：

node_modules/crypto-js
node_modules/jsencrypt

常见问题

Q1: HBuilderX 提示找不到模块？

解决方案：

确保已正确安装依赖
重启 HBuilderX
清除项目缓存：菜单栏 → 运行 → 清除项目缓存
重新编译项目

Q2: 小程序端提示 crypto-js 不可用？

解决方案： 某些小程序平台对 Node.js 模块支持有限，可能需要：

使用小程序原生 API
使用兼容版本的加密库
参考各平台文档进行适配

Q3: App 端运行报错？

解决方案：

检查 manifest.json 中的 App 模块配置
确保在自定义基座中测试
云打包时确保包含了 node_modules

平台兼容性

平台	crypto-js	jsencrypt	备注
H5	✅	✅	完全支持
App (iOS)	✅	✅	完全支持
App (Android)	✅	✅	完全支持
微信小程序	⚠️	⚠️	需要测试验证
支付宝小程序	⚠️	⚠️	需要测试验证
其他小程序	⚠️	⚠️	需要测试验证

注意： 小程序平台可能需要额外配置或使用替代方案。

替代方案（针对小程序）

如果在小程序端遇到兼容性问题，可以考虑：

1. 使用小程序原生加密 API

// 微信小程序
wx.crypto.getRandomValues()

2. 使用 uni-app 插件市场的加密插件

搜索关键词：

AES 加密
RSA 加密
数据加密

3. 后端降级处理

在小程序端关闭加密，仅在 App 和 H5 端使用：

// 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

3.0 KiB Raw Permalink Blame History