本项目采用 grunt 管理编译,有关 Grunt 系统的使用请参考官方文档 脚本弹幕部分的编译还需要 TypeScript 。这些库还会依赖于 NodeJS环境。
CommentCoreLibrary在库外提供了很多可扩展的空间,你可以相对简单的增加新的弹幕格式的支持,新的弹幕 运行模式的支持和挂载各种不同的定时元件。CCL提供了丰富的扩展支持,通过预处理过滤器和运行时过滤器可以 实现非常多的特殊功能支持。编译库意味着你可能需要一些默认环境没有的软件,比如 NodeJS 平台,为此需要 付出一些架设精力。
当然自己编译也会带来一些优势,比如更小的库大小和更加专注的功能支持。还有,希望帮助CCL实现更多支持的 开发者们也需要知道如何有效的编译。
初次编译请确保你安装了 node>=0.8.0
,为全局系统安装 grunt 请执行:
npm install -g grunt-cli
有些系统下可能需要管理员权限(如 sudo
)。有关具体如何配置Grunt请参考官方文档。
接下来你需要安装编译所需的库,可以简单的通过 npm install
进行安装。CommentCoreLibrary在
运行时没有任何依赖关系,但是开发环境需要依赖 grunt 的一些部件和 TypeScript(参考下面“代码弹幕”
章节)。
编译项目请在根目录直接运行:
grunt
即可按照默认模板编译。除此之外,你还可以改变编译目标:
- build : 只编译项目,不会clean掉build文件夹下的产物
- build-core : 只编译弹幕核心,不包括Acfun和Bilibili的解析器。这个更加适用各种二次开发不需要 已有的弹幕格式的
- build-scripting : 只编译代码弹幕支持
默认模式会自动看管 src
源码文件夹,并且在产生变化的时候自动生成新版。
本地调试的话,可以在本地架设Web Server。默认的 demo
文件夹下也有一套简易的调试界面。同时你还
可以参考这个界面来实现你自己的嵌入调试。
默认的代码弹幕支持需要使用 TypeScript 编译。这需要你安装 TypeScript 支持,通过
npm install -g typescript
即可安装。目前编译项目不会引入代码弹幕支持(考虑到架设难度的增高
,编译速度降低和潜在受众面相对于弹幕支持要少一些),相关库需要手动引入。
如果希望直接 Grunt 编译现在也已经支持。
参考 docs/scripting
了解代码弹幕系统和它的编译方法。