Ubuntu下编译mininim游戏全攻略

一、安装mininim 软件所依赖的库（重点是allegro游戏引擎库）

1. 用apt-get remove命令清除干净之前可能安装过的各项allegro5依赖库（如果系统没有这些库，也不报错）

sudo apt-get remove liballegro5-dev liballegro-image5-dev liballegro-audio5-dev liballegro-acodec5-dev liballegro-dialog5-dev

2.用apt-get install 命令安装各种make、gcc等编译工具链软件（以防Ubuntu系统没有，如果已用有，则会自动下载更新到合适版本或最新版本），gnulib和lua50库等。

sudo apt-get install automake autoconf gcc make cmake gnulib libcanberra-gtk-module lua50 liblua50-dev liblualib50-dev libreadline-dev

3.用 apt-get build-dep 命令检测 allegro5游戏库的环境依赖是否完整，自动下载必要的依赖项，为编译 Allegro5 源码做好环境准备。注意这条命令并不下载 从仓库中下编译好的allegro5库！

sudo apt-get build-dep allegro5

如果前面都顺利完成，遇到的缺少xx包的提示，你都已经通过 apt-get install xx 的方式解决，那么就可以进行到下面最关键的步骤。

4. 从git源码仓库下载mininim 需要的allegro5.x 版本源码。

这个mininim游戏代码latest版本是2017年，作者使用的是当时的 allegro5.2.3 版本（当前2025年最新版本是5.2.10），作者为此特意fork保留了一份allegro5.2.3 版本代码。但是经过验证发现：这个allegro5.2.3 版本在ubuntu18.04存在自身编译错误，而最新版本allegro5.2.10与mininim也不匹配。只有allegro5.2.5版本能够与mininim适配。因此，这里不能按照mininim作者的readme指导下载（ 不使用 git clone https://github.com/oitofelix/allegro5.git 这条命令）。
所以需要使用国内gitee平台上转存的官方的 allegro5.2.5版本。

 cd /home/xxx,  xxx是你的实际用户名。
 pwd
 #应该输出为：
 /home/xxx
 #如果不是检查目前所在目录是否正确

5.用 git命令克隆 我备份的的allegro5.2.5版本完整源码：

git clone https://gitee.com/flycloud2009_cloudlou/allegro5_v5.2.5.git

然后，先cd 进入游戏源代码主目录下, 再ls 显示一下目录中的文件, 你会看见文件中有一个 CMakeLists.txt 文件，但是没有 Makefile 文件。
CMakeLists.txt 是cmake工具的默认输入文件，cmake读取CMakeLists.txt内容，进行各项检查配置，如果没有中间出错提示，将会在cmake运行工作目录下成功生成一个 Makefile文件。 这个Makefile文件是下一步 make工具的默认输入文件

cd allegro5_v5.2.5
ls -l

在此目录下，创建 一个 build 子目录以及cd 进入 build子目录中

mkdir build && cd build 

在这里，验证一下你当前所在的工作目录，作目录应该是：

/home/xxx/Documents/allegro5_v5.2.5/build
ls -l

ls 显示build目录下空空如也。没有任何目录和文件。
然后进入 Linux系统 代码编译流程的常规第一步： cmake 配置代码编译依赖环境。

先运行cmake， 注意后面 带的参数是两个 …， … 代表上一级目录，这条命令是然 cmake 读取上一级目录下的 CMakeLists.txt 文件。

cmake .. 

耐心等待，并注意观察屏幕输出的信息。如果出现错误，cmake会停止工作，从第一条error错误信息进行分析，一般都是缺乏xx库，建议你 sudo apt install xx，你只需要按照提示进行即可。
如果问题都解决了， cmake 会运行完，一般会出现 configure done或类似信息。

此时，在当前目录build 下，你在 ls -l 一下，会看见出现许多目录和文件，其中就用 Makefile文件，文件日期是最新时间。

有了 Makefile文件，就可以进入Linux系统 代码编译流程的常规第二步: make 从源码生成二进制库或可执行文件。

make

make命名后面不带参数，则表示读取当前目录下的Makefile文件。
又需要耐心等待，并注意观察屏幕输出的信息。如果出现错误，make会停止工作，从第一条编译error错误信息进行分析。 如果错误出现在某一个代码文件中xx行某个变量或函数，检查前面步骤是否有遗漏，工作目录、操作命令是否正确。
如果make 成功完成 （没有出现错误信息），在build目录下就会生成lib和include等子目录，如下：

lyy@lyy-virtual-machine:~/allegro5-5.2.5.0/build$ ls -al
total 332
drwxrwxr-x 10 lyy  lyy    4096 5月  15 18:02 .
drwxrwxr-x 16 lyy  lyy    4096 5月  15 17:54 ..
drwxrwxr-x 15 lyy  lyy    4096 5月  15 17:54 addons
-rw-rw-r--  1 lyy  lyy   58293 5月  15 17:54 CMakeCache.txt
drwxrwxr-x  6 lyy  lyy    4096 5月  15 18:02 CMakeFiles

lib目录中主要是allegro5 的各种库，主要是动态库，已经成功创建。文件名一般是 liballegroxxx.so.5.2.5 ，如果你用ls 查看 lib目录下的文件

 ls -al lib

会出现这样一些文件，

lrwxrwxrwx  1 lyy lyy      24 5月  15 17:55 liballegro_acodec.so -> liballegro_acodec.so.5.2
lrwxrwxrwx  1 lyy lyy      26 5月  15 17:55 liballegro_acodec.so.5.2 -> liballegro_acodec.so.5.2.5
-rwxrwxr-x  1 lyy lyy  221560 5月  15 17:55 liballegro_acodec.so.5.2.5
lrwxrwxrwx  1 lyy lyy      23 5月  15 17:55 liballegro_audio.so -> liballegro_audio.so.5.2
lrwxrwxrwx  1 lyy lyy      25 5月  15 17:55 liballegro_audio.so.5.2 -> liballegro_audio.so.5.2.5
-rwxrwxr-x  1 lyy lyy  435744 5月  15 17:55 liballegro_audio.so.5.2.5
lrwxrwxrwx  1 lyy lyy      23 5月  15 17:55 liballegro_color.so -> liballegro_color.so.5.2
lrwxrwxrwx  1 lyy lyy      25 5月  15 17:55 liballegro_color.so.5.2 -> liballegro_color.so.5.2.5
-rwxrwxr-x  1 lyy lyy   74840 5月  15 17:55 liballegro_color.so.5.2.5

重点注意是否生成 liballegro.so.5.2.5，liballegro_dialog.so.5.2.5，liballegro_image.so.5.2.5，liballegro_video.so.5.2.5，liballegro_primitives.so.5.2.5 文件。

这些库只是保存在build目录，需要将它们安装到 ubuntu系统的公共目录中 （一般是 /usr/local/lib等目录下）。

运行下面命令，make 会按照Makefile中 install对应的项目规则（主要是一些 cp 命名），把相关库文件复制到公共系统目录中。

sudo make install

安装游戏引擎allegro5 （准确是5.2.5 版本）就完成了。 为了稳妥起见，可以运行一下上面make编译 allegro5.2.5 库时，它顺带编译生成的一些demo游戏程序，看是否能正常运行。

做法如下，进入examples目录，选择一个程序运行：

cd examples

./ex_multiwin 

如果程序出现窗口，表示代码正常运行，就可以退出了。

二、编译mininim 软件

接着上面的步骤继续。 下载mininim仓库源码，进行编译。 此时你的工作目标应该重新返回到home目录下

cd  /home/xxx

然后下载mininim仓库源码。

git clone https://gitee.com/flycloud2009_cloudlou/mininim.git

下载成功后，进入游戏目录，进行环境准备（运行作者写的脚本文件 bootstrap），执行常规的环境依赖配置（运行作者写的configure）

./bootstrap
./configure LUA_LIB="-llua50 -llualib50"

如果上面都没有出错，目录下将生成 Makefile 文件。
正式编译 mininim 源代码：

make

耐心等待。如果没有出错，当前目录下 出现一个游戏程序文件 mininim，运行它

./mininim

此时你可以参看一下 mininim 具体依赖哪些动态支持库，运行

ldd ./mininim

显示信息类似这样

linux-vdso.so.1 (0x00007ffdb15c3000)
libm.so.6 => /lib/x86_64-linux-gnu/libm.so.6 (0x00007faa84fc6000)
libreadline.so.7 => /lib/x86_64-linux-gnu/libreadline.so.7 (0x00007faa84d7d000)
liballegro.so.5.2 => /usr/local/lib/liballegro.so.5.2 (0x00007faa84a7d000)
liballegro_image.so.5.2 => /usr/local/lib/liballegro_image.so.5.2 (0x00007faa8486f000)
liballegro_audio.so.5.2 => /usr/local/lib/liballegro_audio.so.5.2 (0x00007faa84653000)
liballegro_acodec.so.5.2 => /usr/local/lib/liballegro_acodec.so.5.2 (0x00007faa84447000)
liballegro_font.so.5.2 => /usr/local/lib/liballegro_font.so.5.2 (0x00007faa8423d000)
liballegro_primitives.so.5.2 => /usr/local/lib/liballegro_primitives.so.5.2 (0x00007faa84028000)
liballegro_dialog.so.5.2 => /usr/lib/x86_64-linux-gnu/liballegro_dialog.so.5.2 (0x00007faa83e1b000)

如果运行 mininim 不报错，那么就应该看到游戏第一关界面

三、将mininim打包给另一个Ubuntu系统使用

1.将mininim整个文件压缩成.zip文件，发送到Windows系统当作转站，又由Win系统发送到另一个Ubuntu系统，也可通过文件传输软件比如FileZilla Client更方便传输；
2.在2号Ubuntu中提取mininim.zip文件，在终端cd到运行程序mininim所在目录，运行命令

./mininim

发现打包的文件并没有顺利运行，因为环境配置不足的问题而无法加载模型，所以仍然需要按照上面的环境配置和游戏配置的步骤，让游戏得以运行。

四、安卓手机运行mininim

1.把Mininim文件打包发送到安卓手机上，运行命令解压该mininim.tar.xz文件：

xz -d mininim.tar.xz
tar -xvf mininim.tar

cd到mininim运行程序目录下，运行命令：

./mininim

出现如下问题

~/downloads/mininim-200927-gnu-linux64 $ ./mininim                                              
./mininim: line 14: 
/data/data/com.termux/files/home/downloads/mininim-200927-gnu-linux64/lib/mininim: cannot execute binary file: Exec format error

通过分析错误得到如下可能的原因：

1. 文件与系统架构不兼容。
2. 文件可能损坏。
3. 文件没有可执行权限。
4. 依赖库不完整。