从GitHub克隆Cordova项目后，如何安装配置并在Android Studio构建运行？
2026-5-25
完整指南：从克隆Cordova项目到在Android Studio中运行
作为Cordova新手，遇到平台添加失败的问题很常见，大多是环境没配置到位或者项目依赖没处理好。我来帮你一步步梳理正确的操作流程：
一、先搞定前置环境（最关键的一步！）
Cordova依赖几个核心工具，必须先配置到位：
- Node.js & npm：先安装Node.js（建议选LTS稳定版），安装完成后打开终端，输入
node -v和npm -v验证是否安装成功。npm会随Node一起自动安装。 - JDK：Cordova 10+建议使用JDK 11（不要用太新的版本，避免兼容性问题），安装后配置
JAVA_HOME环境变量，并把%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（Mac/Linux）加入系统PATH。 - Android开发环境：
- 安装Android Studio，打开后通过SDK Manager下载所需的Android SDK（建议选项目目标SDK版本，比如Android 13/14），同时要下载Android SDK Build-Tools和Android SDK Platform-Tools。
- 配置
ANDROID_HOME环境变量：指向你的Android SDK安装目录（Windows默认是C:\Users\你的用户名\AppData\Local\Android\Sdk，Mac是~/Library/Android/sdk）。 - 把
%ANDROID_HOME%\platform-tools和%ANDROID_HOME%\tools\bin（Windows）或对应Mac/Linux路径加入系统PATH。
二、安装Cordova
打开终端，全局安装Cordova：
npm install -g cordova
安装完成后输入cordova -v，如果能显示版本号，说明安装成功。
三、处理你克隆的Cordova项目
- 打开终端，进入你克隆的项目根目录：
cd 你的项目文件夹路径
- 安装项目本地依赖：
克隆下来的项目通常没有node_modules文件夹，先执行：
npm install
这一步会安装项目package.json里定义的所有依赖，包括Cordova的本地版本（有时候全局Cordova和项目本地版本不一致也会导致问题）。
四、添加Android平台
- 先检查是否已有残留的Android平台（如果之前添加失败过），有的话先移除：
cordova platform remove android
- 添加指定版本的Android平台（建议选稳定版，比如最新的
12.0.0，或者看项目要求的版本）：
cordova platform add android@12.0.0
等待命令执行完成，没有报错的话，平台就添加成功了。
五、在Android Studio中构建并运行项目
- 先在终端执行一次Cordova构建，生成Android项目文件：
cordova build android
- 打开Android Studio，选择Open an existing project，然后找到你项目根目录下的
platforms/android文件夹，选中后点击OK。 - 等待Android Studio完成Gradle同步（第一次可能会下载很多依赖，需要点时间），如果出现同步错误，先检查是否是SDK版本缺失，按照提示下载即可。
- 同步完成后，选择你的模拟器或连接的真机，点击运行按钮，就能启动项目了。
常见问题排查
- 如果添加平台时提示“找不到Android SDK”：检查
ANDROID_HOME环境变量是否配置正确，PATH里是否包含了platform-tools等路径，重启终端再试。 - 如果Gradle同步失败：检查Android Studio的SDK Manager是否下载了项目所需的SDK版本和Build-Tools版本，或者尝试删除
platforms/android/.gradle文件夹后重新同步。 - 如果运行时出现权限问题：检查项目根目录下的
config.xml，确认是否添加了所需的权限（比如网络权限），重新构建后再试。
内容的提问来源于stack exchange，提问作者nOOb iOS
相关产品推荐
相关产品推荐
