手把手教你安裝MINIGUI編程環境 （MINIGUI版本3.2.0）
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. 下載地址
本文參照MINIGUI的官方安裝文檔，文檔地址：http://www.minigui.com/blog/minigui-3.2.0-released/
操作系統請選用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的密鑰認證。
首先去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
本文轉載自微信公眾號「一口Linux」
