Moodle CodeRunner 插件开发与部署指南

Moodle CodeRunner 插件开发与部署指南

moodle-qtype_coderunner CodeRunner: A moodle quiz question type that runs student-submitted program code in a sandbox to check if it satisfies a given set of tests. 项目地址: https://gitcode.com/gh_mirrors/mo/moodle-qtype_coderunner

1. 项目目录结构及介绍

Moodle CodeRunner是一个允许教师通过运行程序来评分学生答案的Moodle插件。其项目结构详细展示了一个典型的Moodle题型扩展的组织方式。以下是核心目录结构及简要说明：

主要目录与文件：

• classes - 包含了插件的核心类定义，如题型逻辑处理。
• db - 数据库迁移脚本，用于安装或升级时创建或更新数据库表。
• lang - 各语言资源文件夹，存放多语言支持的翻译字符串。
• pix - 图标和其他图像资源。
• samples - 示例问题或者测试数据，供开发者和用户参考。
• templates - 题目模板文件，用于构建可执行的学生代码框架。
• tests - 单元测试代码，确保功能正确性。
• lib.php - 插件的主要逻辑库文件。
• version.php - 插件版本信息和依赖描述。
• README.md - 项目概述和快速入门指南。
• license.txt - 使用的许可证（GPL-2.0）。

每个子目录都承载着特定功能部分，比如classes下的类定义是实现题型逻辑的关键，而db中的文件则是数据库交互的基础。

2. 项目的启动文件介绍

在Moodle的插件中，并没有一个单一的“启动文件”概念。但若要使CodeRunner正常工作，在Moodle环境中激活并配置它涉及以下步骤:

• 安装过程通常从Moodle的后台管理界面开始，通过“ Site administration > Plugins > Install plugins ”导入下载的ZIP文件。
• 完成安装后，需要到插件设置进行必要的配置，包括可能的语言设置、题型选项等，虽然这不是通过一个具体的启动文件触发，但配置项的生效间接影响插件运作。

实际操作上，“启动”指的是Moodle的系统加载该插件的过程，这发生在Moodle启动时自动完成，不需要手动干预特定文件。

3. 项目的配置文件介绍

Moodle CodeRunner的配置主要分布在以下几个方面：

数据库配置 (db/install.xml 和 db/upgrade.php)

• 安装配置 (db/install.xml): 描述了首次安装插件时需要创建的数据库表。
• 升级配置 (db/upgrade.php): 当插件有新版本发布时，用于更新旧版数据库结构至新版要求。

插件主配置 (config.php)

尽管在提供的GitHub仓库链接中未明确指出存在一个显式的config.php文件，Moodle插件通常在自己的根目录下有一个这样的文件，用于存储插件级别的全局配置变量。CodeRunner的具体配置更多地依赖于Moodle自身的插件配置页面。

功能配置和个性化设置

这些通常不在上述传统意义上的“配置文件”内，而是通过Moodle的图形界面进行。管理员可以在插件的设置页面调整沙箱配置、语言支持、以及一些其他插件特有行为的开关。

请注意，对于开发者来说，深入理解lib.php、各配置脚本以及插件内的类定义是非常重要的，因为它们共同构成了插件的配置和运行逻辑。

moodle-qtype_coderunner CodeRunner: A moodle quiz question type that runs student-submitted program code in a sandbox to check if it satisfies a given set of tests. 项目地址: https://gitcode.com/gh_mirrors/mo/moodle-qtype_coderunner