我爱E-Learning在线学习社区

Adapt 响应式课程开发框架(4): 安装Adapt (下)

本文是Adapt 响应式课程开发框架系列第4篇文章,请点击下面的链接阅读该系列其他文章。


本文是安装Adapt的下篇。在上篇中我们介绍了如何配置Adapt课件开发所需的系统环境,本文将讨论如何使用adapt-cli工具来安装Adapt并创建你的第一个课件。另外我们还会介绍在遇到问题时,如何手动安装Adapt。

使用Adapt-cli安装

在上篇中我们安装的Adapt-cli (Adapt Command Line Interface)是安装Adapt最快捷方便的方法。

打开一个终端窗口,然后输入下面的命令:

adapt create course

随后安装程序会让你确认以下4项:

  1. type (类别,按回车键接受默认值course)
  2. name (你的课件项目的文件夹名称,你可以选择输入你喜欢的名称或现在接受默认值以后更改)
  3. branch (使用那个项目分支,绝大多数情况下接受默认值master)
  4. create now? (是否创建,接受默认值y)
使用Adapt-cli安装

Adapt-cli就会为你在当前目录内创建一个以你上面输入的名称(或默认)的文件夹,然后将所需的Adapt课件开发框架、插件和各种构建课件所需的第三方软件依赖包下载到这个文件夹里。

手动安装

更新说明:

Adapt的程序员已经修复了我下面提到这个问题,修复代码已经提交就等着合并了。相信在下一版本的adapt-cli(v2.1.7) 就会解决这个问题了。

更新日期:2019年3月13日

我最近在使用Adapt-cli(v2.1.6) 安装时会遇到一些奇怪的错误(见下图),导致无法下载Adapt课件开发工具和其他构建课件所需的软件包。

使用adapt-cli安装时出错界面

遇到这种情况时我们就需要手动安装,手动安装分为以下3个步骤:

  1. 下载Adapt课件开发框架源代码
  2. 下载Adapt课件开发框架插件集
  3. 下载构建课件所需第三方软件依赖包

下面我们就这3个步骤逐一介绍。

1. 下载Adapt开发框架源码

在一个终端窗口中输入下面的命令,用我们先前安装的git工具来克隆Adapt课件开发框架的源代码库。

git clone https://github.com/adaptlearning/adapt_framework.git my-adapt-course

完成后就会将Adapt课件开发框架的源代码下载到一个叫my-adapt-course (或你自己命名的)的文件夹中。

2. 下载Adapt课件开发框架插件

在终端窗口中输入cd my-adapt-course(默认你没有修改这个名称)进入到我们的项目文件夹,然后在my-adapt-course路径下运行下面的命令来安装插件:

adapt install
adapt install 安装插件成功后的终端信息

3. 下载第三方软件依赖包

最后我们在项目根目录下(即在my-adapt-course路径下)运行下面的命令来安装构建课件所需的第三方软件依赖包:

npm install

下面是安装成功后的终端信息,如果你发现一些WARN的字样,不要担心,这些一般不会影响我们的使用,只是提醒我们有些依赖的软件包需要更新什么的。

npm install 第三方软件依赖包

现在我们就可以构建我们的第一个课件了。


构建框架内置示范课件

注意:无论你使用的是上面哪种安装方法,下面的步骤都一样适用。

Adapt课件开发框架自带一套默认的示范课件文件,方便新用户快速构建一个课件来体验Adapt。

运行下面的命令来构建课件:

grunt build

课件构建完成后,你会看到一个像下面这样的信息显示构建课件成功。

课件构建成功的终端窗口信息

然后我们运行下面的命令来浏览这个课件:

grunt server

这个命令会自动使用你的默认浏览器打开这个刚刚构建好的课件,浏览器默认地址是:http://localhost:9001

恭喜你!如果你成功走到这一步,那你已经掌握了Adapt课件开发框架的安装和构建你的第一个默认课件的全过程。你可以奖励自己一杯咖啡什么的,休息一下!在接下来的Adapt系列文章中我将会向您介绍如何创建你自己的课件。


* 题头图来自 Pixabay

《Adapt 响应式课程开发框架》系列原创文章由我爱E-Learning电子学习社区独家发布,转载请署名并给出原文链接。

我要评论

社交媒体

现在就跟我们在微博上进行互动吧!有什么问题和建议,也可以发邮件给我们。