# godot-riscv **Repository Path**: openkylin/godot-riscv ## Basic Information - **Project Name**: godot-riscv - **Description**: Godot RISC-V 构建计划，由openKylin RISC-V SIG维护 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 3 - **Forks**: 1 - **Created**: 2025-04-28 - **Last Updated**: 2025-07-26 ## Categories & Tags **Categories**: Uncategorized **Tags**: Game-engine, Godot, openKylin ## README # Godot RISC-V 构建计划 & RVGDVM ## 项目简介 Godot RISC-V 构建计划，由openKylin RISC-V SIG维护，旨在为 RISC-V 架构提供 Godot 引擎的构建和安装支持，并确保其与 openKylin RISC-V 发行版的兼容性。 RVGDVM（RISC-V Godot 版本管理工具）是一个用于管理 RISC-V 架构下 Godot 引擎版本的命令行工具。它支持编辑器、导出模板的安装和卸载。项目分为以下几部分： - RVGDVM：RISC-V Godot 版本管理工具，用于管理 Godot 引擎的安装和卸载。 - Godot RISC-V 二进制包：在Release提供预编译的Godot引擎二进制包，用于openKylin RISC-V发行版。 - Godot RISC-V 构建脚本：在项目的build_scripts目录下，包含用于构建 Godot 引擎的脚本和配置文件，针对部分CPU优化。 ## RVGDVM 使用方法 ### 安装依赖一般情况下，openKylin 2.0已经包含了所需的依赖，如果没有，请执行以下命令安装： ```bash sudo apt install curl p7zip-full ``` 如果使用其他Linux发行版，请使用发行版包管理器安装相应的依赖。 ### 安装和卸载安装RVGDVM： ```bash curl -fsSL https://gitee.com/openkylin/godot-riscv/raw/master/install.sh | bash && source ~/.bashrc ``` 卸载RVGDVM： ```bash curl -fsSL https://gitee.com/openkylin/godot-riscv/raw/master/uninstall.sh | bash && source ~/.bashrc ``` ### 命令用法 RVGDM 提供了以下命令： ### 安装 Godot 版本 ```bash rvgdvm install ``` 将 `` 替换为你想要安装的 Godot 版本号，例如 4.4.1 ### 卸载 Godot 版本 ```bash rvgdvm uninstall ``` 将 `` 替换为你想要卸载的 Godot 版本号。 ### 启动 Godot 版本 ```bash rvgdvm start ``` 将 `` 替换为你想要启动的 Godot 版本号。 ### 列出本地安装的版本 ```bash rvgdvm list ``` ### 列出远程可用的版本 ```bash rvgdvm list-remote ``` ### 安装导出模板 ```bash rvgdvm install-template ``` 将 `` 替换为你想要安装导出模板的 Godot 版本号。 ### 卸载导出模板 ```bash rvgdvm uninstall-template ``` 将 `` 替换为你想要卸载导出模板的 Godot 版本号。 ### 显示信息 ```bash rvgdvm info ``` ## 构建脚本使用方法 ### 构建脚本该项目提供构建脚本 `build_xxx.sh` 用于构建 Godot 的编辑器以及导出模板。请确保在构建之前已经安装了所有必需的依赖项。默认请使用 `./build_xxx_riscv64_universal.sh` 构建编辑器和导出模板，带有架构后缀的表示针对对应处理器架构的构建，只能在对应处理器上运行。 `cross_build_xxx.sh` 表示交叉编译，可以在非目标处理器上运行，但需要安装目标处理器架构的交叉编译工具链。 ### 使用方法 1. 克隆 Godot 源代码仓库到本地。 2. 进入 Godot 源代码目录。 3. cp `build_xxx.sh` 到 Godot 源代码目录，并赋予执行权限。 ```bash cp build_xxx.sh ../godot-source-dir/ chmod +x ../godot-source-dir/build_xxx.sh ./../godot-source-dir/build_xxx.sh ``` ## 添加更多 Godot 版本如果你想要的 Godot 版本没有在列表中，但是想向 rvgdvm 添加它，欢迎提交 issue 或 pull request。 PR规范如下： 1. 编译好可以正常运行的 Godot 版本（编辑器、Release导出模板、Debug导出模板），并上传到可公开访问的存储库。 2. 在 `release.json` 文件中添加新版本的条目，请按照版本从高到低的顺序添加。 "4.2.3": { "download_url": "https://gitee.com/openkylin/godot-riscv/releases/download/4.2/godot.linuxbsd.editor.rv64.llvm.7z", "release_template_url": "https://gitee.com/openkylin/godot-riscv/releases/download/4.2/godot.linuxbsd.template_release.rv64.llvm.7z", "debug_template_url": "https://gitee.com/openkylin/godot-riscv/releases/download/4.2/godot.linuxbsd.template_debug.rv64.llvm.7z" }, 3. 提交 pull request，并在 PR 中提供编译环境信息。 ## 手动安装 Godot ### 下载openKylin RISC-V镜像下载对应板卡的RISC-V镜像：https://www.openkylin.top/downloads/index-cn.html 待补充 ## Godot 版本支持我们为 RISC-V 架构维护以下 Godot 版本，对于 Godot官方已经停止维护的版本，我们不再维护。如果您需要特定版本的 Godot，请提issue告知我们，我们将尽力提供支持。 | 版本号 | 发布时间 | 官方状态 | openKylin RISC-V SIG 维护的版本 | |-----------------|-------------------|--------------------|--------------------------------------------------------------------------| | Godot 4.4 | 2025 年 3月 | 受支持的 | https://gitee.com/openkylin/godot-riscv/releases/tag/4.4 | | Godot 4.3 | 2024 年 8 月 | 受支持的 | https://gitee.com/openkylin/godot-riscv/releases/tag/4.3 | | Godot 4.2 | 2023 年 11 月 | 受支持的 | https://gitee.com/openkylin/godot-riscv/releases/tag/4.2 | | Godot 4.1 | 2023 年 7 月 | 受支持的 | https://gitee.com/openkylin/godot-riscv/releases/tag/4.1 | | Godot 4.0 | 2023 年 3 月 | 生命结束 | https://gitee.com/openkylin/godot-riscv/releases/tag/4.0 | 以下是3.x以下的旧版本，Godot 3.4版本开始支持RISC-V架构： | 版本号 | 发布时间 | 官方状态 | openKylin RISC-V SIG 维护的版本 | |-----------------|-------------------|--------------------|--------------------------------------------------------------------------| | Godot 3.7 | 暂无预计时间 | 受支持的测试版 | 无构建计划 | | Godot 3.6 | 2024 年 9 月 | 受支持的 | https://gitee.com/openkylin/godot-riscv/releases/tag/3.6 | | Godot 3.5 | 2022 年 8 月 | 受支持的 | 无构建计划 | | Godot 3.4 | 2021 年 11 月 | 生命结束 | 无构建计划 | | Godot 3.3 | 2021 年 4 月 | 生命结束 | 无构建计划 | | Godot 3.2 | 2020 年 1 月 | 生命结束 | 无构建计划 | | Godot 3.1 | 2019 年 3 月 | 生命结束 | 无构建计划 | | Godot 3.0 | 2018 年 1 月 | 生命结束 | 无构建计划 | | Godot 2.1 | 2016 年 7 月 | 生命结束 | 无构建计划 | | Godot 2.0 | 2016 年 2 月 | 生命结束 | 无构建计划 | | Godot 1.1 | 2015 年 5 月 | 生命结束 | 无构建计划 | | Godot 1.0 | 2014 年 12 月 | 生命结束 | 无构建计划 | 暂时没有.NET版本的计划，由于ASP .NET Core 截止目前还没有支持RISC-V架构，无法正常运行Godot .NET版本，需要等待后续上游支持，当然如果您有兴趣，可以自行尝试编译。 ## 设置项目启动参数在调试项目时，Godot仍会使用默认的软渲染管线，因此需要将`--display-driver wayland opengl_es3`添加到项目设置中，以启用硬件渲染。有AMD GPU的机器，可以忽略上述设置，直接使用默认的OpenGL渲染管线。 ## 硬件支持以下版本的处理器以及板卡通过了运行验证： - Spacemit K1/M1（Spacemit x60）系列 - StarFive JH7110 系列 - SG2042（C910）系列 - TH1520（C910）系列 ## 构建宿主机环境以下是环境参考，可以使用最新的openKylin 2.0版本RISC-V镜像，也可以使用x86_64版本镜像，然后自行安装RISC-V交叉编译工具链（工具链使用详见对应板卡厂商文档）。 openKylin 2.0 ```bash Linux openkylin 6.1.22 #11 SMP Mon Apr 10 10:16:05 CST 2023 riscv64 riscv64 riscv64 GNU/Linux ``` Clang Version 17.0.6 (9ok4) ```bash Openkylin clang version 17.0.6 (9ok4) Target: riscv64-unknown-linux-gnu Thread model: posix InstalledDir: /usr/bin Found candidate GCC installation: /usr/bin/../lib/gcc/riscv64-linux-gnu/12 Found candidate GCC installation: /usr/bin/../lib/gcc/riscv64-linux-gnu/14 Found candidate GCC installation: /usr/bin/../lib/gcc/riscv64-linux-gnu/8 Selected GCC installation: /usr/bin/../lib/gcc/riscv64-linux-gnu/14 ``` GCC Version 14.2.0 (openKylin 14.2.0-5) ```bash Using built-in specs. COLLECT_GCC=gcc COLLECT_LTO_WRAPPER=/usr/libexec/gcc/riscv64-linux-gnu/14/lto-wrapper Target: riscv64-linux-gnu Configured with: ../src/configure -v --with-pkgversion='openKylin 14.2.0-5' --with-bugurl=file:///usr/share/doc/gcc-14/README.Bugs --enable-languages=c,ada,c++,go,d,fortran,objc,obj-c++,m2,rust --prefix=/usr --with-gcc-major-version-only --program-suffix=-14 --program-prefix=riscv64-linux-gnu- --enable-shared --enable-linker-build-id --libexecdir=/usr/libexec --without-included-gettext --enable-threads=posix --libdir=/usr/lib --enable-nls --enable-clocale=gnu --enable-libstdcxx-debug --enable-libstdcxx-time=yes --with-default-libstdcxx-abi=new --enable-libstdcxx-backtrace --enable-gnu-unique-object --disable-libquadmath --disable-libquadmath-support --enable-plugin --with-system-zlib --enable-libphobos-checking=release --with-target-system-zlib=auto --enable-objc-gc=auto --enable-multiarch --disable-multilib --with-arch=rv64gc --with-abi=lp64d --enable-checking=release --build=riscv64-linux-gnu --host=riscv64-linux-gnu --target=riscv64-linux-gnu --with-build-config=bootstrap-lto-lean --enable-link-serialization=4 Thread model: posix Supported LTO compression algorithms: zlib zstd gcc version 14.2.0 (openKylin 14.2.0-5) ``` SCons Version 4.9.1 ```bash SCons by Steven Knight et al.: SCons: v4.9.1.39a12f34d532ab2493e78a7b73aeab2250852790, Thu, 27 Mar 2025 11:44:24 -0700, by bdbaddog on M1Dog2021 SCons path: ['/usr/local/lib/python3.12/dist-packages/SCons'] Copyright (c) 2001 - 2025 The SCons Foundation ``` Mold Version 2.4.1 ```bash mold 2.4.1 (compatible with GNU ld) ``` 编译指南请参考 [Compile](./Compile.md) ## 开源许可 Godot 引擎遵循 [MIT 许可证](https://github.com/godotengine/godot/blob/master/LICENSE.txt) 发布。该仓库遵循 MIT 许可证发布。