0. MINIGUI

MiniGUI 是一款面向嵌入式系统的高级窗口系统(Windowing System)和图形用户界面(Graphical User Interface,GUI)支持系统,由魏永明先生于 1998 年底开始开发。

 

2002 年,魏永明先生创建北京飞漫软件技术有限公司,为 MiniGUI 提供商业技术支持,同时也继续提供开源版本,飞漫软件是中国地区为开源社区贡献代码最多的软件企业。最后一个采用 GPL 授权的 MiniGUI 版本是 1.6.10,从 MiniGUI 2.0.4 开始 MiniGUI 被重写并使用商业授权。

 

 

一、安装准备

1. 软件版本

安装MINIGUI编程环境

 

  • MINIGUI版本3.2.0安装系统:Ubuntu16.04

 

不得不说,MINIGUI的安装实在过于复杂,借此文安慰一下我历经7小时苦痛折磨的灵魂,整理一下我的安装与配置的过程(从0到运行helloworld程序),同时为后辈员工提供一点指导和帮助。

 

2. 下载地址

操作系统请选用Ubuntu 16.04版,使用最新的Ubuntu可能会在安装过程中出现各种“奇怪的”错误(真是奇怪的错误,至今不知道怎么修复……)

 

二、安装前的准备工作

假设你已成功安装Ubuntu16.04操作系统

 

1、安装各种依赖软件

你需要确保已经安装以下软件。若未安装,则可以执行sudo apt-get install 软件名进行安装。

 

1) git
2) gcc/g++
3) binutils
4) autoconf/automake
5) libtool
6) make
7) cmake
8) pkg-config

 

2、安装各种依赖库

你需要确保已经安装以下依赖库。若未安装,则可以执行sudo apt-get install 库名进行安装。

 

1) libgtk2.0-dev
2) libjpeg-dev
3) libpng12-dev
4) libfreetype6-dev
5) libsqlite3-dev
6) libxml2-dev

 

3、配置Github的认证密钥

由于接下来需要从Github上克隆MINIGUI的安装包,因此这里需要配置Github的密钥认证。

 

  1. 首先去Github上注册一个账号。注册是免费的。记住注册时填写的邮箱。然后在Ubuntu上,执行命令:

 

ssh-keygen -t rsa -C(大写) 你的邮箱地址

 

执行该指令后会有提示信息。第一个提示信息表示生成的公钥私钥的保存位置。一般普通用户保存在~/.ssh内,root用户保存在/root/.ssh内(目录是隐藏的)。第二个提示信息表示登入密码,直接按回车即可(表示不需要密码)。第三个提示信息表示确认密码,也是直接按回车即可。生成公钥私钥后,进入.ssh目录内,查看id_rsa.pub的内容。进入Github,在账号内找到Settings,点击New SSH key,将id_rsa.pub的内容复制到文本框内,注意不要有遗漏否则会认证失败。

 

 

添加完毕后,在Ubuntu内执行ssh -T git@github.com测试连接是否成功。如果出现欢迎信息则表示连接Github成功。若出现Permission denied则表示连接失败。连接失败可能是公钥私钥配置未生效。执行ssh-add ~/.ssh/id_rsa将刚才生成的公钥私钥添加到Github内,再次测试即可。

 

三、下载完全版的MINIGUI安装包

使用git的clone(克隆)功能获取完整的MINIGUI3.2的代码文件。执行命令:

 

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

 

VincentWei是MINIGUI的发明人和维护者。

 

获取完毕后,进入build目录

 

cd build-minigui-3.2

 

运行该目录下的fetch脚本获取全部的MINIGUI的源代码。

 

./fetch-all.sh

 

等待下载完成即可。

 

四、安装过程

以下目录,若未特殊说明,皆以build-minigui-3.2作为基准目录

 

1、安装gvfb依赖库

进入gvfb目录。依次执行以下命令:

 

cmake . (注意这个点(当前目录)不要忽略)

make

sudo make install

 

2、安装chipmunk依赖库

进入3rd-party/chipmunk-5.3.1目录。依次执行以下命令:

 

cmake . (注意这个点(当前目录)不要忽略)

make

sudo make install

 

3、编译MINIGUI源代码

进入minigui-res目录。依次执行以下命令:

 

./autogen.sh

./configure

sudo make install

 

4、建立所有代码

回到build-minigui-3.2目录内,执行命令:

 

./build-all.sh

 

等待build完成。

 

四、验证安装是否成功

等待build完成,若无报错信息,则表示成功安装了MINIGUI3.2编程环境。我们可以用两种方法验证是否安装成功。

 

方法一:

进入到/usr/local/bin目录,发现该目录内有一个名为./mguxdemo的程序。运行该程序。该程序是一个使用MINIGUI编写的类手机系统的应用程序,若可以运行该程序且无崩溃、无报错,则表示MINIGUI安装成功。

 

方法二:

进入到mg-sample目录。在该目录执行命令:

 

./configure

make

 

然后进入到当前目录下的same目录,运行same程序

 

./same

 

该程序是一个消除小游戏。

 

 

注意:编译过程中可能会报错,再次执行一次./build-all.sh脚本即可。

 

五、编写helloworld程序

接下来编写一个helloworld程序。代码参照《miniGUI编程指南》V3.0第二章的程序,但是稍有改动(主要是取消了进程模式改成线程模式)。代码如下:

#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,"HelloWorld!");
   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;
}

 

然后运行gcc进行编译,但是要注意需要链接各种动态库。编译命令如下:

 

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

 

其中:

 

  • 1)lminigui_ths:MINIGUI在线程模式下运行需要的依赖库。注意该参数必须放在第一个因为它需要依赖后续的各种动态库。如果编译器显示无法找到该库,则参照下面的方法安装这个库。//使用gcc编译时需要注意,若库A依赖库B,则A必须处在B的前面。2)-ljpeg、-lpng:jpeg和png格式的图像支持库3)-lz:数据压缩库4)-lpthread:线程库5)-lfreetype:字体库 运行结果如下:

 

 

六、libminigui_ths的安装过程

如果在编译时提示缺少minigui_ths库,则可以按以下步骤安装。

 

1)获取FMsoft的GPG密钥

由于minigui_this库需要使用apt-get在MINIGUI的官方下载安装,因此需要事先获取他们的认证。执行命令:

 

wget -qO - http://files.fmsoft.cn/ubuntu/key/fmsoft.gpg | sudo apt-key add -

 

注意第二个可选项是大写字母欧

 

2)将FMsoft添加到apt的安装服务器

使用vim编辑/etc/apt/source.list文件,在文件最末尾添加:

 

deb http://files.fmsoft.cn/ubuntu/ xenial restricted

 

保存退出后,执行命令更新apt配置。

 

sudo apt update

 

3)下载安装

执行命令下载安装:

 

sudo apt install libminigui-ths-dev