SageTV项目Windows原生代码构建指南

概述

本文将详细介绍如何在Windows系统上搭建SageTV开源项目的开发环境，用于构建Windows平台的原生(non-Java)代码。我们将使用Visual Studio 2015和MSYS2/MINGW工具链来完成这一过程。本指南适合从零开始配置环境的开发者。

环境准备

构建过程需要多次系统重启，请确保不要跳过这些重启步骤。完整的构建流程包括以下步骤：

1. 安装JDK（32位和64位版本）
2. 安装DirectX SDK
3. 安装Visual Studio 2015
4. 安装MSYS2及必要软件包
5. 在MinGW环境下构建SageTV Windows原生代码
6. 在Visual Studio环境下构建SageTV Windows原生代码

详细步骤

1. JDK安装配置

技术背景： SageTV最初是使用32位Java构建的，为了保持兼容性，建议同时安装32位和64位JDK。

操作步骤：

1. 下载并安装Java Development Kit (Windows x86和x64版本)
2. 记录JDK的安装路径
3. 设置以下环境变量：
   • SAGEDEVJDK：指向32位JDK安装路径（如：C:\Program Files (x86)\Java\jdk1.8.0_60）
   • SAGEDEVJDK64：指向64位JDK安装路径
   • JAVA_HOME：指向主要使用的JDK路径

注意事项：

• 路径中不要使用引号，即使包含空格
• 建议使用JDK 8版本以获得最佳兼容性

2. DirectX SDK安装

技术背景： SageTV的部分多媒体功能依赖于DirectX库，需要使用2010年6月发布的DirectX SDK版本。

操作步骤：

1. 下载并安装"DirectX SDK June 2010"版本
2. 安装时选择包含"Direct X symbol files"
3. 验证系统环境变量DXSDK_DIR已自动设置（64位系统通常为：C:\Program Files (x86)\Microsoft DirectX SDK (June 2010)）

3. Visual Studio 2015安装

技术背景： Visual Studio提供了原生代码开发的IDE环境，同时包含必要的库和编译工具。

关键组件选择：

1. 选择"Custom"安装类型
2. 在编程语言部分确保选中：
   • Visual C++
   • Microsoft Foundation Classes for C++（必须）
   • Windows XP Support for C++
3. 在通用工具部分选中：
   • Git for Windows
   • GitHub Extension for Visual Studio

安装说明：

• 安装过程可能耗时较长（约1小时）
• 安装完成后需要重启系统
• 后续可通过重新运行安装程序添加或修改组件

4. MSYS2环境配置

技术背景： MSYS2提供了类Unix的命令行环境，用于构建跨平台软件。

安装步骤：

1. 根据系统架构下载对应版本的MSYS2（64位系统选择x86_64版本）
2. 安装完成后，通过pacman包管理器安装以下必要组件：
   • 构建工具链：make, autoconf, automake, libtool
   • 编译器：mingw-w64-i686-gcc（32位）/mingw-w64-x86_64-gcc（64位）
   • 多媒体库：yasm, freetype, harfbuzz, libpng
   • 基础库：zlib, graphite2

使用技巧：

• 使用pacman -Ss <pattern>搜索可用包
• 使用pacman -Q查看已安装包
• 注意区分MSYS、MinGW32和MinGW64三种环境

5. MinGW环境下的代码构建

构建前提：

• 确保所有必要软件包已安装
• 确认环境变量（SAGEDEVJDK、SAGEDEVJDK64、JAVA_HOME）已正确设置
• 在正确的Shell环境中操作（32位或64位MinGW）

构建步骤：

1. 导航至sagetv/buildwin目录
2. 执行./buildwin.sh脚本

构建产物： 脚本将生成以下DLL文件（位于buildwin/Win32或x64目录）：

• swscale.dll
• ImageLoader.dll
• Pushreader.dll
• FreetypeFontJNI.dll
• Mpeg2Transcoder.dll

同时会在third_party目录生成Pushreader.lib文件，供Visual Studio项目引用。

6. Visual Studio环境下的代码构建

构建前提：

• 确认所有环境变量已设置（DXSDK_DIR、SAGEDEVJDK、SAGEDEVJDK64、JAVA_HOME）
• 已获取项目源代码

构建步骤：

1. 打开SageWorkspace.sln解决方案文件（位于native目录）
2. 在VS菜单栏选择正确的构建配置（Release + Win32/x64）
3. 右键点击SageLauncher项目并选择"Build"

构建产物： 生成的文件将位于native\Build\Release\Win32或x64目录。

常见问题解决

1. RC1015错误：无法打开'afxres.h'

   • 原因：未安装Microsoft Foundation Classes
   • 解决：重新运行VS2015安装程序并添加该组件

2. 找不到jvm.lib

   • 原因：SAGEDEVJDK环境变量未设置或路径错误
   • 解决：检查并修正JDK路径

3. 无法打开'D3dX9.h'

   • 原因：DXSDK_DIR环境变量问题
   • 解决：确认DirectX SDK安装正确且环境变量指向正确路径

4. 找不到tools.jar

   • 原因：JAVA_HOME环境变量设置错误
   • 解决：检查并修正Java安装路径

总结

本文详细介绍了在Windows平台构建SageTV原生代码的完整流程。通过合理配置开发环境，开发者可以顺利编译SageTV的多媒体组件。建议按照步骤顺序操作，并注意环境变量的正确设置，这是构建成功的关键因素。