Studio3T/RoboMongo Windows平台编译指南

前言

RoboMongo（现更名为Studio 3T）是一款广受欢迎的MongoDB图形化管理工具。本文将详细介绍在Windows平台上从源码编译构建RoboMongo的完整流程，帮助开发者理解其构建体系并掌握自定义构建的能力。

环境准备

1. 版本说明

本文适用于RoboMongo 1.0及更早版本，以及MongoDB 3.2系列的构建。新版本可能有不同的构建要求。

2. 工具链准备

2.1 Git版本控制

• 推荐使用Git 2.7.0 64位版本
• 安装时需注意：
  • 选择"Use Git from the Windows Command Prompt"选项
  • 行尾转换选择"Checkout Windows-style, commit Unix-style line endings"

2.2 Visual Studio 2013

• 必须安装Update 4或更高版本（推荐Update 5）
• 这是构建MongoDB和Qt库的基础编译环境

2.3 Python环境

• 需要ActivePython 2.7 x64版本
• 确保python.exe已加入系统PATH

2.4 构建工具

• SCons 2.3.4：使用ZIP包安装，通过setup.py安装
• CMake 3.3.2：使用安装程序并添加至PATH

2.5 Qt框架

• 需要Qt 5.7 msvc2013 64-bit组件
• 建议使用在线安装器仅安装必需组件

2.6 OpenSSL

• 版本要求1.0.1p
• 需要从源码编译生成动态链接库

详细构建步骤

1. OpenSSL编译

# 使用VS2013 x64交叉工具命令提示符
perl Configure VC-WIN64A
ms\do_win64a
nmake -f ms\ntdll.mak

编译成功后会在out32dll目录生成以下文件：

• libeay32.lib/dll
• ssleay32.lib/dll
• inc32目录包含头文件

2. RoboMongo Shell构建

RoboMongo Shell是基于MongoDB 3.2的分支版本，需要单独构建：

git clone https://github.com/paralect/robomongo-shell.git
cd robomongo-shell
git checkout roboshell-v3.2

设置关键环境变量：

setx ROBOMONGO_CMAKE_PREFIX_PATH "Qt路径;robomongo-shell路径;OpenSSL路径"

构建命令：

bin\build

3. RoboMongo主程序构建

git clone https://github.com/paralect/robomongo.git

构建流程：

bin\configure  # 配置步骤
bin\build     # 构建主程序
bin\install   # 安装到指定目录

运行生成的Robomongo.exe即可启动应用。

常见问题处理

1. 环境变量设置：确保所有工具链的可执行文件都在PATH中
2. 构建失败：可尝试先执行bin\clean清理再重新构建
3. 版本兼容性：严格遵循各组件版本要求
4. 路径问题：所有路径建议使用不含空格和特殊字符的英文路径

技术原理

RoboMongo的Windows构建体系具有以下特点：

1. 混合使用多种构建工具（SCons、CMake、nmake）
2. 依赖自定义的MongoDB Shell分支
3. 需要精确控制Qt和OpenSSL的版本匹配
4. 构建过程分为配置、编译、安装三个阶段

理解这些构建原理有助于解决可能遇到的构建问题，也为自定义修改RoboMongo提供了基础。

结语

通过本文的详细指导，开发者应该能够在Windows平台上成功构建RoboMongo。构建过程中如遇到问题，建议仔细检查各工具版本是否符合要求，以及环境变量设置是否正确。掌握从源码构建的能力将为深入理解和使用RoboMongo打下坚实基础。