Abstract Scorm XBlock

为Open edX®提供的另一个SCORM XBlock。

支持课程的导出/导入。在Open edx Studio中可编辑。保存学生状态并将成绩报告到课程的进度标签页。目前支持SCORM 1.2和SCORM 2004标准。

由Abstract Technology开发，基于edx_xblock_scorm，由Raccoon Gang 提供。

安装

使用以下命令安装包

pip install abstract-scorm-xblock

用法

• 将abstract_scorm_xblock添加到课程的高级设置中高级模块列表。
• 将scorm组件添加到您的单元中。
• 上传包含您内容包的zip文件。 imsmanifest.xml文件必须位于zip包的根目录中。请确保zip归档的根目录中没有额外的目录。
• 按常规方式发布您的内容。

开发

设置

要设置开发环境

• 创建一个Python3虚拟环境。如果已安装direnv，则direnv allow足够。
• 使用pip install -r requirements.txt安装derex
• 设置derex项目。阅读https://derex.page/quickstart.html#quickstart以获取更多信息。

开发和调试

为了能够有效地进行开发和调试，可以采取以下步骤

• 在容器内部获取shell

  cd derex_project
  ddc-project exec cms sh
  

• 以可编辑模式设置包。这将允许在不重新安装包的情况下测试更改

  pip install -e /openedx/derex.requirements/abstract_scorm_xblock
  

• 手动启动Django调试服务器并将其绑定到端口81

  python manage.py cms runserver 0:81
  

• 在您的浏览器中，现在应该可以通过https://studio.scorm.localhost:81访问。现在，您应该能够在Python和JS文件中插入调试代码，并从Django runserver自动重新加载功能中受益。

运行测试

可以使用以下命令运行测试

ddc-project run --rm lms python manage.py lms test abstract_scorm_xblock --keepdb

第一次运行此命令时，它将初始化测试数据库。如果您想每次都创建/销毁测试数据库，请删除--keepdb标志。

要运行覆盖率报告

ddc-project run -e COVERAGE_RCFILE=../derex.requirements/abstract_scorm_xblock/.coveragerc --rm lms sh -c "coverage run manage.py lms test abstract_scorm_xblock --keepdb && coverage html"

这将在abstract_scorm_xblock/htmlcov目录中生成HTML覆盖率报告。

您还可以使用Makefile快捷方式

make test
make coverage

注意事项

• 如果从课程的“文件 & 上传”部分删除SCORM包，导入/导出功能将导出一个包含损坏XBlock的课程。

待办事项

• 从默认存储中删除提取的旧SCORM包