FreeKill 的包管理策略 ===================== FreeKill使用git进行包管理,具体而言是使用libgit2库进行管理。 包的组织 -------- 所有拓展包都位于packages/目录下。其中,standard(标包)、standard_cards(标包卡牌)和manuvering_cards(军争卡牌, TODO )属于基础拓展,其直接处于FreeKill的项目仓库之下。其他所有的拓展均处于项目之外。 每个拓展包都是一个单独的文件夹,内含代码文件(init.lua,以及诸如其他lua文件和fkp文件等等)和音图等资源文件。关于具体如何组织各种文件,请参照已有的拓展包。 包的管理 -------- 包管理使用git,以下使用类似git命令行的方式解说。 首先,packages中除了基本的三个包之外,其他的包都要从仓库中排除掉。这方面由一个.gitignore文件控制。 然后,在packages目录下,有一个名为packages.db的文件统领所有拓展包。这是个sqlite数据库,结构详见\ :doc:`./database`\ 。 下面从连接过程中简要分析这个文件的作用: 1. 当一个客户端尝试对服务端发起连接请求的时候,首先它们之间会先比较MD5值。 2. 如果MD5通过则无事发生,否则服务端会把自己的packages.db中的关键信息发送给客户端。 3. 客户端根据文件内容检查自己的拓展包。如果那个文件夹存在,那么就git fetch -> git checkout 。 4. 如果文件夹不存在,那么先git clone,然后再checkout。 5. 做完这些后,客户端再次发起请求。若仍不通过,则向用户通知错误信息。 在这个过程中,如果出现任何一个文件夹内有未提交的更改(拓展包开发者有时候可能因为疏忽而未通过MD5检查),或者出现根本不是git仓库的文件夹,那么都会直接进入报错环节。 有时候客户端会包含服务端所没有的拓展包,这时候比起直接删除之,更加明智的选择是将其标记为禁用。将拓展包文件夹的名字设为xxx.disabled即可将拓展包标记为禁用的拓展包。禁用的拓展包不会被游戏加载,也不会被MD5检测计入。 包的托管 -------- 一般来说都是推荐将项目放在github上面的,但由于FreeKill暂且不考虑国际化且必须照顾广大玩家的体验,因此将拓展包托管到github可能不是一个明智的选择。推荐将拓展包托管到gitee平台,或者其他的好办法也行。 总之有一点要注意的是,packages.db中的url需要是国内访问比较方便的网站才行。 包的部署 -------- 此处不讨论具体如何编写代码,单论在这个管理框架下如何进行开发。 一般来说,在对一个仓库进行开发时,由于目前各托管平台都用SSH Key认证而非用户名密码,因此仓库的URL通常为git@gitxxx.com:xxxx/xxxx.git。这样的URL有一个问题就在于只有认证过的用户可以clone,而非所有人。 因此在部署的时候,一定要保证所有url都是https://xxxx。这一点FreeKill是不会进行检测的。 包的下载与更新(TODO) ---------------------- 客户端使用GUI,服务端使用Fk shell或者直接编辑packages.db。