Studio3T/RoboMongo 项目构建指南（Mac OS X 与 Linux）

前言

RoboMongo（现更名为Studio3T）是一款广受欢迎的MongoDB图形化管理工具。本文将详细介绍如何在Mac OS X和Linux系统上从源码构建RoboMongo 1.0及更早版本（支持MongoDB 3.2）。对于开发者而言，了解构建过程有助于深入理解工具的实现原理，也为定制化开发奠定基础。

构建前准备

1. 基础工具安装

构建RoboMongo需要以下工具：

• CMake 3.2+：跨平台的自动化构建工具
• Scons 2.4+：软件构建工具
• Qt 5.7：跨平台应用程序框架

Qt 5.7安装示例：

# Mac OS X
下载并安装 qt-opensource-mac-x64-clang-5.7.0.dmg
安装后路径：/path/to/qt-5.7.0/5.7/clang_64

# Linux
下载并安装 qt-opensource-linux-x64-5.7.0.run
安装后路径：/path/to/qt-5.7.0/5.7/gcc_64

2. OpenSSL构建

RoboMongo依赖OpenSSL 1.0.1p进行安全通信。

Mac OS X构建步骤：

wget ftp://ftp.openssl.org/source/old/1.0.1/openssl-1.0.1p.tar.gz
tar -xvzf openssl-1.0.1p.tar.gz
cd openssl-1.0.1p
./Configure darwin64-x86_64-cc shared --openssldir="@rpath"
make
mkdir lib
cp libssl.1.0.0.dylib libcrypto.1.0.0.dylib lib/

Linux构建步骤：

wget ftp://ftp.openssl.org/source/old/1.0.1/openssl-1.0.1p.tar.gz
tar -xvzf openssl-1.0.1p.tar.gz
cd openssl-1.0.1p
./config shared
make
mkdir lib
cp libssl* libcrypto* lib/

构建流程详解

1. 构建RoboMongo Shell

RoboMongo Shell是基于MongoDB Shell的定制版本。

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

设置环境变量（注意使用分号分隔路径）：

# Mac OS X示例
export ROBOMONGO_CMAKE_PREFIX_PATH="/qt路径;/robomongo-shell路径;/openssl路径"

# Linux示例
export ROBOMONGO_CMAKE_PREFIX_PATH="/qt路径;/robomongo-shell路径;/openssl路径"

执行构建：

bin/build

2. 构建RoboMongo主程序

git clone https://github.com/paralect/robomongo
cd robomongo
bin/configure  # 配置步骤
bin/build     # 构建主程序
bin/run       # 运行程序

实用命令

• 清理构建：bin/clean
• 安装到指定目录：bin/install
• 打包：bin/pack

常见问题解决方案

Ubuntu 16.04构建问题

如果bin/configure失败，尝试安装：

sudo apt-get install mesa-common-dev

CentOS构建问题

若出现failed to find gl/gl.h错误，安装：

sudo yum install mesa-libGL mesa-libGL-devel

结语

通过本文的详细步骤，开发者可以顺利完成RoboMongo的构建过程。理解整个构建流程不仅有助于解决可能遇到的问题，也为后续的定制开发提供了基础。建议在构建过程中仔细检查每个步骤的输出信息，确保依赖项正确安装和配置。