RVScript 项目使用教程

RVScript 项目使用教程

rvscript Fast RISC-V-based scripting backend for game engines 项目地址: https://gitcode.com/gh_mirrors/rv/rvscript

1. 项目目录结构及介绍

rvscript/
├── engine/
│   ├── src/
│   ├── ext/
│   ├── programs/
│   └── tests/
├── github/
│   └── workflows/
├── .clang-format
├── .gitignore
├── .gitmodules
├── README.md
└── setup.sh

目录结构说明

• engine/: 包含项目的主要代码，包括引擎的核心代码、外部扩展、示例程序和测试代码。
  • src/: 引擎的核心代码。
  • ext/: 外部扩展代码。
  • programs/: 示例程序代码。
  • tests/: 测试代码。
• github/workflows/: GitHub Actions 的工作流配置文件。
• .clang-format: 代码格式化配置文件。
• .gitignore: Git 忽略文件配置。
• .gitmodules: Git 子模块配置。
• README.md: 项目介绍和使用说明。
• setup.sh: 项目初始化脚本。

2. 项目启动文件介绍

启动文件

• engine/src/main.cpp: 这是项目的启动文件，包含了主函数 main()，负责初始化引擎并启动游戏循环。

启动流程

1. 初始化引擎: 在 main() 函数中，首先会初始化引擎的各个组件，包括虚拟机、脚本系统和渲染系统。
2. 加载脚本: 引擎会加载预先编译好的 RISC-V 脚本程序。
3. 启动游戏循环: 引擎进入游戏循环，处理用户输入、更新游戏状态并渲染画面。

3. 项目配置文件介绍

配置文件

• setup.sh: 这是一个 Bash 脚本，用于初始化项目所需的依赖项和环境。

配置文件说明

• 安装依赖: setup.sh 脚本会检查并安装项目所需的依赖项，包括 CMake、Git 和 RISC-V 工具链。
• 初始化子模块: 脚本会初始化 Git 子模块，确保所有依赖项都被正确下载。
• 构建项目: 脚本会调用 build.sh 脚本，自动构建项目并生成可执行文件。

使用方法

# 进入项目根目录
cd rvscript

# 运行初始化脚本
./setup.sh

注意事项

• 如果系统中没有安装所需的依赖项，脚本会提示用户手动安装。
• 如果使用的是旧版本的 Ubuntu 或其他不支持的发行版，建议使用 distrobox 创建一个 Ubuntu 22.04 的容器来运行项目。

rvscript Fast RISC-V-based scripting backend for game engines 项目地址: https://gitcode.com/gh_mirrors/rv/rvscript