纯 Windows+Android Studio 编译 Android 版 VLC 保姆级步骤

全程无 Linux/WSL 依赖，仅需 Windows 10/11 + Android Studio，每一步标注「操作 + 验证 + 避坑」，确保零基础能完成。

核心前置要求

• 系统：Windows 10/11 64 位（32 位不支持）

• 磁盘空间：≥30GB（依赖 + 源码 + 编译产物）

• 权限：全程用管理员权限操作

• 网络：稳定（需下载依赖，建议提前配置国内镜像）

• 关闭：杀毒软件（避免误删编译文件 / 拦截下载）

步骤 1：安装 Android Studio 并配置核心环境（关键！）

VLC-Android 对 NDK 版本敏感，优先选 NDK r25b（亲测兼容性最佳，高版本易报错）。

1.1 下载安装 Android Studio

1. 下载地址：Android Studio 最新稳定版（国内可通过中文社区镜像）

2. 运行安装包，点击「Next」，勾选以下组件（必选）：

• ✅ Android SDK

• ✅ Android NDK (Side by side)（手动指定 r25b，不要选最新版）

• ✅ CMake

3. 点击「Next」，选择安装路径（建议非系统盘，如D:\Android\Android Studio，路径无空格 / 中文），等待安装完成（约 10-20 分钟）。

1.2 配置 NDK r25b（核心避坑！）

若安装时未自动下载 r25b，手动补充：

1. 打开 Android Studio → 点击顶部「Tools」→「SDK Manager」；

2. 切换到「SDK Tools」标签，勾选「Show Package Details」；

3. 找到「NDK (Side by side)」，展开后只勾选「25.2.9519653（r25b）」，取消其他版本；

4. 点击「Apply」，等待 NDK 下载安装完成（约 500MB）。

1.3 配置环境变量（必须！）

右键「此电脑」→「属性」→「高级系统设置」→「环境变量」→「系统变量」，新增 / 编辑以下变量：

1.4 验证环境

打开管理员权限的 CMD（开始菜单搜「CMD」→右键「以管理员身份运行」），输入以下命令验证：

# 验证NDK（显示r25b版本即成功）
ndk-build --version
# 验证ADB（显示版本号即成功）
adb --version
# 验证CMake（显示版本号即成功）
cmake --version

步骤 2：安装辅助编译工具（缺一不可）

VLC-Android 依赖这些工具编译底层库，必须装且配置 PATH。

2.1 安装 Git（克隆源码）

1. 下载：Git for Windows

2. 安装关键设置（其余默认）：

• 选择「Use Git from the Command Prompt」（加入系统 PATH）；

• 换行符选「Checkout as-is, commit as-is」（避免脚本格式错误）；

3. 验证：CMD 输入 git --version，显示版本号即成功。

2.2 安装 Python 3.10+（脚本依赖）

1. 下载：Python 3.10.11（兼容性最佳）（选「Windows Installer (64-bit)」）；

2. 安装必勾选：「Add Python 3.10 to PATH」，点击「Install Now」；

3. 验证：CMD 输入 python --version，显示Python 3.10.11即成功。

2.3 安装 Strawberry Perl（编译依赖）

1. 下载：Strawberry Perl（Windows 64 位）；

2. 安装路径默认（C:\Strawberry），一路下一步；

3. 验证：CMD 输入 perl --version，显示版本号即成功。

步骤 3：克隆 VLC-Android 源码（避坑！路径无空格 / 中文）

3.1 创建工作目录

打开管理员 CMD，执行：

# 创建总目录（路径必须无空格/中文）
mkdir D:\vlc-android-build
cd D:\vlc-android-build

3.2 克隆源码（优先镜像，速度快）

# 官方仓库（速度慢，备选）
git clone https://code.videolan.org/videolan/vlc-android.git

# 推荐：Gitee镜像（国内速度快）
git clone https://gitee.com/mirrors_videolan/vlc-android.git

• 克隆完成后，进入源码目录：cd vlc-android

• 可选：切换到稳定版（避免开发版 bug）：git checkout 3.5.0（最新稳定版可查VLC 官网）。

步骤 4：配置国内镜像（解决下载超时核心！）

VLC-Android 依赖的 Gradle 和第三方库默认从国外下载，需修改配置加速：

4.1 修改 Gradle 镜像

1. 打开D:\vlc-android-build\vlc-android\gradle\wrapper\gradle-wrapper.properties；

2. 将distributionUrl替换为阿里云镜像：

   distributionUrl=https://mirrors.aliyun.com/maven/gradle/gradle-7.5-bin.zip

   
   

4.2 修改项目镜像

1. 打开D:\vlc-android-build\vlc-android\build.gradle（根目录的 build.gradle）；

2. 在allprojects→repositories中替换为国内镜像：

   allprojects {
     repositories {
         maven { url 'https://maven.aliyun.com/repository/google' }
         maven { url 'https://maven.aliyun.com/repository/jcenter' }
         maven { url 'https://maven.aliyun.com/repository/maven-central' }
         maven { url 'https://maven.aliyun.com/nexus/content/groups/public/' }
         google()
         mavenCentral()
     }
   }

   
   

4.3 修改 gradle.properties（可选，加速同步）

打开D:\vlc-android-build\vlc-android\gradle.properties，新增：

# 阿里云镜像
org.gradle.project.repoUrl=https://maven.aliyun.com/repository/google
org.gradle.project.jcenterUrl=https://maven.aliyun.com/repository/jcenter
org.gradle.project.mavenCentralUrl=https://maven.aliyun.com/repository/maven-central
# 加速Gradle编译
org.gradle.daemon=true
org.gradle.parallel=true
org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m

步骤 5：编译 VLC 安卓依赖（最耗时，核心步骤）

5.1 初始化 Gradle

在管理员 CMD 中进入源码目录，执行：

cd D:\vlc-android-build\vlc-android
# 清理缓存（首次执行可选）
./gradlew clean
或
gradle clean

• 首次执行会下载 Gradle，等待完成（约 5-10 分钟，镜像加持下更快）。

5.2 编译 VLC 底层依赖

执行核心命令（耗时 1-2 小时，取决于电脑配置）：

./gradlew prepareVlc
或
gradle prepareVlc

关键避坑：

• 若报错「NDK 版本不匹配」：

  打开D:\vlc-android-build\vlc-android\build.gradle，修改ndkVersion为你安装的 r25b：

  android {
    ndkVersion "25.2.9519653"
  }

  
  

• 若报错「python/perl 未找到」：检查环境变量是否配置，重启 CMD（必须管理员权限）；

• 若下载依赖超时：重新执行./gradlew prepareVlc（断点续传，无需从头来）。

步骤 6：Android Studio 打开并编译打包

6.1 打开项目

1. 启动 Android Studio，点击「Open」；

2. 选择D:\vlc-android-build\vlc-android目录，点击「OK」；

3. 等待 Gradle 同步完成（首次同步约 10-20 分钟，镜像加持下更快）；

• 同步时若提示「NDK not found」：确认ANDROID_NDK_ROOT环境变量正确，或在 Android Studio 中「File→Project Structure→SDK Location→NDK Location」手动指定 r25b 路径。

6.2 编译项目

1. 同步完成后，点击顶部「Build」→「Make Project」；

• 编译耗时约 15-30 分钟，无红色报错即成功；

• 若报错「内存不足」：修改gradle.properties中org.gradle.jvmargs为-Xmx4096m（根据电脑内存调整）。

6.3 生成 APK（调试版 / 发布版）

6.3.1 调试版 APK（直接运行 / 安装）

1. 连接安卓设备（开启开发者模式 + USB 调试），或启动模拟器；

2. 点击顶部「Run」→「Run 'app'」；

3. 选择设备后，Android Studio 会自动编译并安装 APK 到设备，完成后可直接运行。

6.3.2 手动导出 APK

1. 点击顶部「Build」→「Build Bundle (s) / APK (s)」→「Build APK (s)」；

2. 编译完成后，点击提示框的「locate」，即可找到调试版 APK：

   D:\vlc-android-build\vlc-android\app\build\outputs\apk\debug\app-debug.apk

6.3.3 发布版 APK（可选，需签名）

1. 点击「Build」→「Generate Signed Bundle / APK」；

2. 选择「APK」→「Next」；

3. 若无签名文件，点击「Create new」创建（填写密钥信息，记住密码）；

4. 选择「release」→「Finish」，等待编译完成即可生成发布版 APK。

常见问题避坑指南

最终产物

• 调试版 APK：vlc-android\app\build\outputs\apk\debug\app-debug.apk

• 发布版 APK：vlc-android\app\build\outputs\apk\release\app-release.apk（需签名）

• 可直接将 APK 拷贝到安卓设备安装，或通过 Android Studio 运行到模拟器 / 真机。