应用环境配置
应用环境配置是使用 uniapp 开发工具的第一步，正确配置开发环境可以确保打包过程顺利进行。
概述
应用环境配置主要包括：
- Android SDK 配置
- iOS 开发环境配置（仅 Mac）
- JDK 配置
- Node.js 环境配置
Android 环境配置
1. 安装 Android SDK
方式一：通过 Android Studio 安装（推荐）
下载 Android Studio
访问 Android Studio 官网下载最新版本
安装 Android Studio
按照安装向导完成安装
配置 SDK
- 打开 Android Studio
- 进入
Preferences/Settings>Appearance & Behavior>System Settings>Android SDK - 安装所需的 SDK 版本（推荐 Android 10.0 (API 29) 或更高）
- 在
SDK Tools标签页中，确保安装：- Android SDK Build-Tools
- Android SDK Platform-Tools
- Android SDK Tools
方式二：独立安装 SDK
- 下载 Android SDK Command-line Tools
- 解压到指定目录，例如：
- Windows:
C:\Android\sdk - macOS:
~/Library/Android/sdk
- Windows:
- 配置环境变量（见下文）
2. 配置环境变量
Windows
右键点击"此电脑" > "属性" > "高级系统设置" > "环境变量"
在"系统变量"中新建：
变量名: ANDROID_HOME 变量值: C:\Android\sdk编辑
Path变量，添加：%ANDROID_HOME%\platform-tools %ANDROID_HOME%\tools %ANDROID_HOME%\build-tools\33.0.0点击"确定"保存
macOS/Linux
编辑 ~/.bash_profile 或 ~/.zshrc 文件：
export ANDROID_HOME=~/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/build-tools/33.0.0保存后执行：
source ~/.bash_profile # 或 source ~/.zshrc3. 验证 Android 环境
打开终端/命令提示符，运行：
adb version如果显示版本信息，说明配置成功。
iOS 环境配置（仅 macOS）
1. 安装 Xcode
从 App Store 安装
- 打开 App Store
- 搜索"Xcode"
- 点击"获取"或"安装"
首次运行配置
- 安装完成后打开 Xcode
- 同意许可协议
- 等待组件安装完成
2. 安装 Command Line Tools
打开终端，运行：
xcode-select --install如果已安装，会提示 command line tools are already installed
3. 验证 Xcode
xcodebuild -version应显示类似输出：
Xcode 15.0
Build version 15A240d4. 配置证书和描述文件
iOS 打包需要 Apple 开发者证书：
注册 Apple Developer 账号
访问 Apple Developer 注册账号
创建证书
- 登录 Apple Developer 后台
- 进入"Certificates, Identifiers & Profiles"
- 创建开发证书或发布证书
创建 App ID
- 在"Identifiers"中创建 App ID
- 设置 Bundle ID
创建描述文件
- 在"Profiles"中创建 Provisioning Profile
- 关联证书和 App ID
下载并安装
- 下载证书（.cer）和描述文件（.mobileprovision）
- 双击证书文件安装到钥匙串
- 描述文件放到指定位置
JDK 配置
1. 安装 JDK
推荐使用 JDK 11 或 JDK 17。
下载 JDK
访问以下任一网站下载：
安装
按照下载的安装包提示完成安装。
2. 配置环境变量
Windows
找到 JDK 安装路径，例如：
C:\Program Files\Java\jdk-11新建系统变量：
变量名: JAVA_HOME 变量值: C:\Program Files\Java\jdk-11编辑
Path变量，添加：%JAVA_HOME%\bin
macOS/Linux
编辑 ~/.bash_profile 或 ~/.zshrc：
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-11.jdk/Contents/Home
export PATH=$JAVA_HOME/bin:$PATH3. 验证 JDK
java -version
javac -version应显示 JDK 版本信息。
Node.js 配置
1. 安装 Node.js
推荐使用 Node.js 16 或更高版本。
下载安装
访问 Node.js 官网下载 LTS 版本并安装。
使用版本管理工具（推荐）
nvm（Node Version Manager）:
# macOS/Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 安装 Node.js
nvm install 18
nvm use 18Windows 使用 nvm-windows:
从 nvm-windows 下载安装。
2. 验证 Node.js
node -v
npm -v3. 配置 npm 镜像（可选）
加速依赖下载：
# 使用淘宝镜像
npm config set registry https://registry.npmmirror.com在工具中配置环境
打开 uniapp 开发工具后，进行环境配置：
1. 打开配置界面
- 点击菜单栏"设置" > "环境配置"
- 或使用快捷键
Ctrl/Cmd + ,
2. 配置路径
在配置界面中设置：
Android 配置：
- Android SDK 路径：
C:\Android\sdk或~/Library/Android/sdk - Android Build Tools 版本：
33.0.0
iOS 配置（macOS）：
- Xcode 路径：
/Applications/Xcode.app - 自动检测已安装的证书和描述文件
JDK 配置：
- JDK 路径：
C:\Program Files\Java\jdk-11或/Library/Java/JavaVirtualMachines/jdk-11.jdk/Contents/Home
Node.js 配置：
- Node.js 路径：自动检测或手动指定
3. 验证配置
点击"验证环境"按钮，工具会自动检测配置是否正确。
常见问题
Android SDK 未找到
问题: 提示找不到 Android SDK
解决方案:
- 确认
ANDROID_HOME环境变量已设置 - 重启终端/命令提示符
- 重启 uniapp 开发工具
- 手动指定 SDK 路径
JDK 版本不兼容
问题: 提示 JDK 版本过低或过高
解决方案:
- 卸载当前 JDK
- 安装推荐版本（JDK 11 或 JDK 17）
- 重新配置环境变量
iOS 证书问题
问题: 打包时提示证书无效
解决方案:
- 检查证书是否过期
- 确认证书类型正确（开发/发布）
- 重新下载并安装证书
- 检查描述文件是否匹配
macOS 权限问题
问题: 提示无权限访问某些文件
解决方案:
# 授予工具磁盘访问权限
sudo chmod -R 755 /path/to/sdk环境检查清单
在开始打包前，确保以下项目已完成：
- [ ] Android SDK 已安装并配置
- [ ] JDK 已安装并配置
- [ ] Node.js 已安装
- [ ] iOS 环境已配置（macOS）
- [ ] 所有环境变量已设置
- [ ] 工具中的环境配置已验证通过
下一步
环境配置完成后，您可以：
- 阅读项目配置了解如何配置 uniapp 项目
- 查看离线 AppKey 配置
- 开始本地打包