Ubuntu16.04下MINIGUI 3.2.0开发环境搭建全攻略

1. MINIGUI开发环境搭建概述

第一次接触MINIGUI的朋友可能会好奇，这个看起来像嵌入式系统专用的小型GUI框架，为什么在Ubuntu16.04上安装会这么复杂？其实MINIGUI作为国内自主研发的轻量级图形界面系统，在工业控制、医疗设备、智能家居等领域有着广泛应用。我去年接手一个医疗设备项目时，就深刻体会到了搭建MINIGUI开发环境的"酸爽"。

MINIGUI 3.2.0版本相比早期版本在性能和功能上都有显著提升，但安装过程也确实让不少开发者头疼。经过多次实践，我总结出一套相对可靠的安装方法，特别适合在Ubuntu16.04系统上部署。为什么强调要用Ubuntu16.04？因为新版本Ubuntu的库依赖关系经常变化，会导致各种莫名其妙的编译错误。

2. 安装前的准备工作

2.1 系统环境确认

在开始之前，请确保你已经完成了Ubuntu16.04系统的安装。我建议使用纯净的系统环境，避免之前安装的软件造成干扰。可以通过以下命令检查系统版本：

lsb_release -a

输出应该显示"Ubuntu 16.04"。如果不是，建议重新安装系统，否则后续可能会遇到各种兼容性问题。

2.2 安装必备工具链

MINIGUI编译需要完整的开发工具链。执行以下命令一次性安装所有必需工具：

sudo apt-get update sudo apt-get install -y git gcc g++ binutils autoconf automake libtool make cmake pkg-config

这里有个小技巧：如果你不确定某个包是否已经安装，可以使用dpkg -s 包名命令查询。比如dpkg -s cmake会显示cmake的安装状态和版本信息。

2.3 安装依赖库

MINIGUI运行时需要一些基础图形库的支持。这些库可以通过apt直接安装：

sudo apt-get install -y libgtk2.0-dev libjpeg-dev libpng12-dev libfreetype6-dev libsqlite3-dev libxml2-dev

特别注意libpng12-dev这个包，在新版Ubuntu中可能已经被移除，但在16.04中是可以正常安装的。如果遇到找不到包的情况，可以尝试添加Ubuntu16.04的官方源。

3. 配置GitHub访问

3.1 生成SSH密钥

由于MINIGUI源码托管在GitHub上，我们需要配置SSH密钥来克隆代码库。执行以下命令生成密钥：

ssh-keygen -t rsa -C "your_email@example.com"

生成过程中会提示输入保存位置和密码，直接按回车使用默认值即可。完成后，公钥会保存在~/.ssh/id_rsa.pub文件中。

3.2 添加密钥到GitHub账户

用文本编辑器打开公钥文件：

cat ~/.ssh/id_rsa.pub

复制全部内容，然后登录GitHub，在Settings -> SSH and GPG keys页面点击"New SSH key"，粘贴公钥内容并保存。

3.3 测试连接

执行以下命令测试SSH连接是否成功：

ssh -T git@github.com

如果看到"Hi username! You've successfully authenticated..."的欢迎信息，说明配置成功。如果失败，可以尝试执行ssh-add ~/.ssh/id_rsa添加密钥到ssh-agent。

4. 获取MINIGUI源代码

4.1 克隆代码仓库

MINIGUI 3.2.0的完整构建脚本托管在GitHub上，使用以下命令克隆：

git clone git@github.com:VincentWei/build-minigui-3.2.git

VincentWei是MINIGUI的创始人，这个仓库包含了构建MINIGUI所需的所有组件。

4.2 获取子模块代码

进入克隆的目录，运行fetch脚本下载所有子模块：

cd build-minigui-3.2 ./fetch-all.sh

这个过程可能会比较慢，因为要下载MINIGUI核心代码、资源文件和示例程序。如果中途失败，可以多次运行该脚本，它会自动续传。

5. 编译安装MINIGUI

5.1 安装GVFB虚拟帧缓冲

GVFB是MINIGUI的虚拟帧缓冲设备，用于在没有物理显示设备的环境下运行MINIGUI程序：

cd gvfb cmake . make sudo make install

编译过程中可能会提示缺少某些头文件，通常是相应的dev包没有安装，可以根据错误信息补充安装依赖库。

5.2 安装Chipmunk物理引擎

MINIGUI的一些高级功能需要Chipmunk物理引擎支持：

cd ../3rd-party/chipmunk-5.3.1 cmake . make sudo make install

这个步骤一般比较顺利，如果出现权限问题，可以在make install前加上sudo。

5.3 编译MINIGUI资源文件

资源文件包含字体、图标等MINIGUI运行必需的素材：

cd ../minigui-res ./autogen.sh ./configure sudo make install

autogen.sh脚本会生成configure文件，如果提示缺少automake或autoconf，请确认2.2节的工具链是否安装完整。

5.4 完整构建MINIGUI

回到项目根目录，执行完整构建脚本：

cd ../.. ./build-all.sh

这个过程会比较长，可能要10-30分钟不等，取决于你的机器性能。如果中途报错，可以尝试再次运行该脚本，很多临时性问题可以通过重试解决。

6. 验证安装结果

6.1 运行演示程序

安装完成后，可以运行内置的演示程序验证：

/usr/local/bin/mguxdemo

如果看到一个手机风格的界面，说明MINIGUI已经成功安装。按ESC键可以退出演示程序。

6.2 编译运行示例游戏

MINIGUI自带了一个消除类游戏示例：

cd mg-sample ./configure make cd same ./same

游戏运行时可能会提示找不到字体或资源，这是因为环境变量没设置正确。可以暂时通过指定资源路径解决：

MINIGUI_RES_PATH=/usr/local/share/minigui/res ./same

7. 开发第一个MINIGUI程序

7.1 HelloWorld示例代码

创建一个hello.c文件，输入以下代码：

#include <stdio.h> #include <minigui/common.h> #include <minigui/gdi.h> #include <minigui/minigui.h> #include <minigui/window.h> #include <minigui/control.h> static int HelloWin(HWND hwnd, int message, WPARAM wParam, LPARAM lParam) { HDC hdc; switch(message) { case MSG_PAINT: hdc = BeginPaint(hwnd); TextOut(hdc, 60, 60, "Hello World!"); EndPaint(hwnd, hdc); return 0; case MSG_CLOSE: DestroyMainWindow(hwnd); PostQuitMessage(hwnd); return 0; } return DefaultMainWinProc(hwnd, message, wParam, lParam); } int MiniGUIMain(int argc, const char *argv[]) { MSG Msg; HWND hMainWnd; MAINWINCREATE CreateInfo; CreateInfo.dwStyle = WS_VISIBLE | WS_BORDER | WS_CAPTION; CreateInfo.dwExStyle = WS_EX_NONE; CreateInfo.spCaption = "HelloWorld"; CreateInfo.hMenu = 0; CreateInfo.hCursor = GetSystemCursor(0); CreateInfo.hIcon = 0; CreateInfo.MainWindowProc = HelloWin; CreateInfo.lx = 0; CreateInfo.ty = 0; CreateInfo.rx = 240; CreateInfo.by = 180; CreateInfo.iBkColor = COLOR_lightwhite; CreateInfo.dwAddData = 0; CreateInfo.hHosting = HWND_DESKTOP; hMainWnd = CreateMainWindow(&CreateInfo); if(hMainWnd == HWND_INVALID) return -1; ShowWindow(hMainWnd, SW_SHOWNORMAL); while(GetMessage(&Msg, hMainWnd)) { TranslateMessage(&Msg); DispatchMessage(&Msg); } MainWindowThreadCleanup(hMainWnd); return 0; }

7.2 编译链接程序

使用gcc编译时需要链接MINIGUI的库文件：

gcc hello.c -o hello -lminigui_ths -ljpeg -lpng -lz -lpthread -lfreetype

注意库的链接顺序很重要，-lminigui_ths必须放在第一位，因为它依赖后面的库。

7.3 解决库缺失问题

如果编译时提示找不到minigui_ths库，需要安装MINIGUI的开发包：

wget -qO - http://files.fmsoft.cn/ubuntu/key/fmsoft.gpg | sudo apt-key add - sudo sh -c 'echo "deb http://files.fmsoft.cn/ubuntu/ xenial restricted" >> /etc/apt/sources.list' sudo apt update sudo apt install libminigui-ths-dev

安装完成后再次尝试编译，应该就能成功了。

8. 常见问题解决

在实际安装过程中，可能会遇到各种问题。这里分享几个我遇到过的典型问题及解决方法：

问题1：编译时出现"png.h: No such file or directory"

解决方法：安装libpng开发包

sudo apt-get install libpng12-dev

问题2：运行程序时报错"error while loading shared libraries: libminigui_ths.so.3.2: cannot open shared object file"

解决方法：添加库路径到ldconfig

sudo sh -c 'echo "/usr/local/lib" > /etc/ld.so.conf.d/minigui.conf' sudo ldconfig

问题3：GVFB运行时无法打开显示

解决方法：检查DISPLAY环境变量是否正确设置，或者尝试使用sudo运行。有时候需要先启动虚拟帧缓冲：

gvfb & export DISPLAY=:0 ./your_minigui_program

问题4：make过程中出现语法错误

解决方法：这通常是因为系统时间不正确导致的，可以同步系统时间：

sudo ntpdate pool.ntp.org

MINIGUI的环境搭建确实比一般的开源项目要复杂，但一旦搭建成功，后续的开发工作就会顺利很多。建议在成功安装后对整个系统做个快照，方便以后恢复。