搭建 Raylib 开发环境 (Linux)

回首页

本文以 Debian 11 Linux 为例，参考 raylib Github wiki 说明，介绍 raylib 开发环境的安装步骤。开发工具为 CodeBlocks 20.03。

1. raylib 介绍

[百科] raylib 是一个跨平台的开源库，该库用于图形应用和游戏开发。受 Borland BGI 图形库和 XNA 框架启发， raylib 也非常适合原型类、工具类、图形应用、嵌入式软件的开发。raylib 使用纯C语言开发， 采用 zlib/libpng 开源许可协议，目前支持 Windows，Linux，macOS，FreeBSD，安卓，树莓派，HTML5 平台。raylib 支持2D和3D图形界面软件开发，官网和源码中提供了丰富的示例，方便参考学习。官网地址：https://www.raylib.com，代码托管地址：https://github.com/raysan5/raylib。

2. 准备

操作系统：Debian 11，内核版本 5.10.0-18-amd64，桌面环境 GNOME3

开发工具：CodeBlocks 20.03

3. 安装步骤

• 使用 git 命令下载 raylib 的源代码，需要先安装 git 命令：

sudo apt-get install git -y

• 接下来下载代码到本地电脑：

git clone https://github.com/raysan5/raylib.git

• 代码下载完成后，安装编译工具，为编译 raylib 做准备：

sudo apt-get install build-essential make -y

• raylib 依赖一些底层开发包，包括音频、OpenGL等，使用如下命令进行安装：

sudo apt install libasound2-dev mesa-common-dev libx11-dev libxrandr-dev libxi-dev xorg-dev libgl1-mesa-dev libglu1-mesa-dev libwayland-dev libxkbcommon-dev -y

• 切换到上面通过 git 下载的源码目录，然后使用 make 编译。编译过程会出现一些警告，没有影响，只要最后提示 raylib static library generated 即可：

cd raylib/src/

make PLATFORM=PLATFORM_DESKTOP

编译过程显示的内容较多，以上只截取了命令开始和结尾的部分。

• 安装 raylib ：

sudo make install

• 安装 CodeBlocks 开发工具 ：

sudo apt-get install codeblocks -y

4. 测试

以上完成了 raylib 的安装，现在写段测试代码验证一下。当然，我们也可以使用 raylib 源码中 examples 目录下的某个示例进行测试。

打开 CodeBlocks IDE，选择 File->New->Project (对应的中文菜单是 文件->新建->项目) ↓

选择 Empty Project (空项目)，单击 Go (开始) ↓

输入 Project title (项目名称)，比如 TestRaylib；再选择 Folder to create project in (新建项目所在文件夹)。其余选项默认即可，然后点击 Next (下一步) ↓

接下来的界面，Compiler (编译器)选择 GNU GCC Compiler (gcc 编译器)，其余选项保持默认。单击 Finish (完成) ↓

这样我们就新建了一个空项目。此时项目中还没有源码文件，所以需要新建一个C源码文件。继续选择菜单 File->New->File (文件->新建->文件) ↓

选择 C/C++ source (C/C++ 源码)，单击 Go (开始) ↓

开发语言选择 C，单击 Next (下一步) ↓

在 Filename with full path 栏 (源码文件所在完整路径)，输入源码文件要保存的完整路径，比如 /home/lck/games/TestRaylib/main.c 。也可以单击输入栏后面的浏览按钮，选择要保存的路径并输入源码文件名称。记得勾选 Add file to active project (将源码文件添加到活动项目)，并勾选 Debug 和 Release 。单击 Finish (完成) ↓


上面的步骤是在 CodeBlocks 里创建一个项目的基本步骤。接下来的设置与 raylib 直接相关，我们继续操作。

在 CodeBlocks 左侧界面中，右键选择项目名称 TestRaylib -> Build options (构建选项) ↓

在弹出的窗口中，选择 Linker settings (链接设置)，然后单击 Add (添加)，在 Add library (添加库) 里输入 raylib 并 单击 OK (确定)。这样就把 raylib 库添加到项目链接属性中了。最后单击窗口中的 OK (确定)按钮。↓

将以下代码粘贴到 CodeBlocks 里的 main.c 源码文件中：↓ 

#include <raylib.h>

int main(void)
{
    InitWindow(800, 600, "Raylib 测试！");
    SetTargetFPS(30);

    while (!WindowShouldClose())
    {
        BeginDrawing();
            ClearBackground(RAYWHITE);
            DrawText("Hello Raylib!", 800/2 - MeasureText("Hello Raylib!",20)/2, 100, 20, RED);
            DrawFPS(10, 10);
        EndDrawing();
    }

    CloseWindow();
    return 0;
}

接下来编译项目。右键左侧项目名称 TestRaylib ，选择 Build (构建)，此时在 CodeBlocks 界面下方 Build log (构建日志) 会显示编译链接信息，正常应该是 0 error(s), 0 warning(s) ↓

单击工具栏中的绿色三角形按钮，即 Run (运行)按钮 ↓

程序运行效果如下：↓


至此，raylib 开发环境安装配置完毕。


注：也可以参考 raylib 的 github wiki 教程来进行配置。在某种程度上来说，github wiki 上的教程更加完善一些，地址为 https://github.com/raysan5/raylib/wiki/Working-on-GNU-Linux 。安装过程如有疑问，可点击右下角“联系我”。

回首页
联系我