MPC-HC播放器项目编译指南：从环境配置到完整构建-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00997/article/details/148392611

MPC-HC播放器项目编译指南：从环境配置到完整构建

mpc-hc Media Player Classic 项目地址: https://gitcode.com/gh_mirrors/mp/mpc-hc

前言

MPC-HC作为一款经典的开源媒体播放器，其源代码编译过程需要特定的开发环境配置。本文将详细介绍从零开始编译MPC-HC播放器所需的完整步骤，帮助开发者构建自己的定制版本。

一、Visual Studio开发环境配置

1.1 安装Visual Studio 2019

编译MPC-HC需要安装Visual Studio 2019（任何版本均可），安装时需选择以下关键组件：

C++核心功能（必备基础）
IntelliCode（智能代码辅助）
Windows通用C运行时
Windows通用CRT SDK
C++生成工具（x86和x64架构）
C++ ATL和MFC支持
Windows 10 SDK（推荐10.0.17763.0版本）

1.2 安装Windows SDK

为了确保兼容性，建议安装Windows 8.1 SDK：

仅需选择"Windows Software Development Kit"组件
注意：若使用Windows 10 SDK，生成的二进制文件将要求至少Windows 7 SP1系统，会失去对Vista和Windows 7 RTM的支持

二、Python环境配置（可选）

如需构建翻译DLL文件，需要配置Python环境：

安装Python 3.8.7或更高版本（3.6+均可）
安装必要的polib库（通过pip安装）

三、MSYS和GCC环境搭建（可选）

此环境用于构建LAV Filters（MPC-HC内部使用的解码器）：

下载并安装64位MSYS2（推荐安装到C:\MSYS64\）
运行msys2_shell.bat后安装必要工具：
```
pacman -S make pkg-config diffutils
```
更新所有包（可能需要多次执行）
安装mingw-w64-gcc工具链
建议将MSYS相关路径加入系统PATH环境变量

四、汇编工具配置

4.1 YASM安装

根据系统架构下载对应版本的YASM：

64位系统推荐yasm-1.3.0-win64.exe
32位系统使用yasm-1.3.0-win32.exe

将可执行文件重命名为yasm.exe并放入系统PATH路径（如C:\Windows或MSYS的usr\bin目录）

4.2 NASM安装

下载最新版NASM
将nasm.exe放入Visual Studio的VC目录下

五、构建配置文件设置

在MPC-HC源代码目录创建build.user.bat文件，配置以下关键路径：

@ECHO OFF
REM MSYS2/MinGW路径（LAVFilters必需）
SET "MPCHC_MSYS=C:\MSYS64"
SET "MPCHC_MINGW32=C:\MSYS64\mingw64"
SET "MPCHC_MINGW64=C:\MSYS64\mingw64"

REM 可选配置
SET "MPCHC_GIT=C:\Program Files\Git"  ; Git路径
SET "MPCHC_PYTHON=C:\Program Files\Python38"  ; Python路径
SET "MPCHC_WINSDK_VER=8.1"  ; Windows SDK版本

注意：若Visual Studio自动检测失败，需手动指定安装路径。

六、获取源代码

使用Git获取MPC-HC源代码：

git clone --recursive https://repository.url/mpc-hc.git

或分步操作：

git clone https://repository.url/mpc-hc.git
git submodule update --init --recursive

若子模块更新失败，可尝试先获取所有标签再更新。

七、编译过程

7.1 主程序编译

打开mpc-hc.sln解决方案文件
选择Release配置
按F7开始构建
生成文件位于bin\mpc-hc_x86目录

7.2 图标库编译

打开mpciconlib.sln
构建生成mpciconlib.dll

7.3 多语言资源编译

打开mpcresources.sln
构建BuildAll项目
多语言DLL将生成在Lang目录

7.4 批量构建

也可使用build.bat脚本一键构建所有组件（运行build.bat help查看用法）

八、安装包制作

安装Inno Setup Unicode v5.5.9或更新版本
打开distrib\mpc-hc_setup.iss脚本
仔细阅读脚本开头的注释说明
编译生成安装包

注意事项：

可通过build.bat的installer或packages参数构建安装包
编辑iss文件时注意保持原编码格式

结语

通过以上步骤，开发者可以完整构建MPC-HC播放器的所有组件。对于日常开发调试，可选择"Release Lite"/"Debug Lite"配置快速构建（不含内部滤镜功能）。正式发布版本则应使用完整构建配置。

mpc-hc Media Player Classic 项目地址: https://gitcode.com/gh_mirrors/mp/mpc-hc

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考