【Super Point】在进迭时空 K3 Pico-ITX 上构建与运行优化版本的 Godot 引擎

【RISC-V游戏生态】在进迭时空 K3 Pico-ITX 上构建与运行优化版本的 Godot 引擎

前言

本文介绍如何在进迭时空 K3(SpacemiT X100)Pico-ITX 开发板上,从安装预编译版本到一键源码编译,快速获得原生 RISC-V Godot 编辑器和导出模板,并运行游戏项目。

K3的性能很高,能胜任2D游戏开发,详细性能评测可以观看我下面的评测视频:

【全球首颗 RVA23 量产 RISC-V AI 芯片!进迭时空 K3 最详细测评来啦!】 https://www.bilibili.com/video/BV1RBReBdEzp/?share_source=copy_web&vd_source=c011e600289db00bf69b28358596e7fb

系统环境

在预装的 Bianbu 4.0 或者 openKylin 2.0 sp2 安装 Clang 17、GCC 14、mold、scons 等构建工具,然后直接使用我写的rvgdbuild

源码编译(性能调优)

使用 rvgdbuild 统一构建工具,可从源码构建针对 K3 优化过的 Godot 版本。

1. 获取工具

git clone https://gitee.com/openkylin/godot-riscv.git
cd godot-riscv
pip install scons
sudo apt install -y mold clang build-essential git python3 pkg-config \
  libx11-dev libxcursor-dev libxinerama-dev libgl1-mesa-dev \
  libasound2-dev libpulse-dev libudev-dev libxi-dev libxrandr-dev libwayland-dev

2. 构建编辑器与导出模板(普通版)

# 针对 K3 的 X100 架构优化,建议启用 LLVM 和 mold,并使用进迭的编译工具链
rvgdbuild build \
    --version 4.5.1-stable \
    --targets editor,template_debug,template_release \
    --cpu generic \
    --use-llvm yes \
    --scons-arg "CXX=clang++" \
    --scons-arg "CC=clang" \
    --scons-arg "linker=mold" \
    --package \
    --jobs $(nproc)

可通过 --scons-arg 传递 -mcpu=spacemit-x100 等 K3 专属标志,以获得向量化加速和游戏体积优化。

  • -mcpu=spacemit-x100:使用 X100 调度和 Fusion 信息。
  • -mcpu=spacemit-a100:使用 A100 调度和 Fusion 信息。
  • -fuse-ld=lld:使用 lld 链接器。
  • -march=rv64gc_zba_zbb_zbc_zbs:启用 gc 和 bitmanip 扩展指令。

详细参数解析请查看官方文档:

https://www.spacemit.com/community/document/info?lang=zh&nodepath=tools/user_guide/cross_compiler_user_guide.md

也可以看下面我做的视频教程:

【【开发指南】在openKylin使用进迭时空RISC-V Clang工具链交叉编译】 https://www.bilibili.com/video/BV1WbEnzfESY/?share_source=copy_web&vd_source=c011e600289db00bf69b28358596e7fb

4. 验证与运行

构建产物输出至 godot-output/,生成 build-manifest.json 清单。

# 启动编辑器(K3支持 vulkan 硬件加速)
./godot.linuxbsd.editor.rv64.llvm --display-driver wayland vulkan

在 RISC-V 上享受游戏开发,从 K3 开始!

1 Like

恭喜点亮 【K3 共建计划】 Super Point 精选反馈!相关权益和后续进展我们会通过论坛或社群同步。