kaichronicles

凯编年史

2021年11月：Kai Chronicles应用不再出版

Kai Chronicles是孤独的狼游戏书籍的游戏玩家。只有书1-13是可以玩的。游戏玩家可以作为网站或Android应用程序运行。您可以在https://www.projectaon.org/staff/toni上播放它或从Google Play下载应用程序。

该存储库不包含游戏书籍数据。数据必须从项目AON网站下载。请记住，游戏书籍数据在项目AON许可下，因此：

• 您不能将此应用程序放在公共网络服务器上（仅在本地计算机上，供您自己使用）。该游戏可以在项目AON网站上发布该游戏的唯一地方
• 您不能以任何方式重新分配游戏书籍数据

Android较旧的支持版本为5.1（API 22）。该网络通过最新版本的Chrome和Firefox进行了测试。其他浏览器或/和旧版本可能无法正常工作。

设置

编译打字稿

npm install
npm run ts    # This compiles for node.js, generates code in src/js
npm run build # This compiles for browser, generates code in www/js

下载项目AON游戏数据：

npm run downloaddata

这将需要node.js（任何最近版本），zip命令和路径上的SVN客户端

设置网站

npm run serve

在http：// localhost：5000上打开浏览器。

设置Android应用

安装Cordova 9.0 Android申请。然后：

npm run cordova-prepare
npm run cordova-build

这将与Android应用程序生成文件SRC/Platforms/Android/build/upputs/apk/android-debug.apk。

您可以使用模拟器测试该应用程序。与Android Studio一起打开它，然后：

npm run cordova-run

Cordova是作为NPM要求安装的，因此可以从Node_modules获得任何其他命令。例子：

node_modules/cordova/bin/cordova plugin list

默认情况下，此应用程序将从项目aon Web下载书籍。如果您需要从私有Web服务器下载书籍，则可以在bookdownloadstate.ts，方法“ downloadAsync”中更改它。

设置Docker映像

运行本地网站的可选方法只玩游戏

• 下载并安装Docker并确保它在您的路径环境变量中
• 使用终端（Linux或iOS）或PowerShell（Windows 10）导航到项目目录
• 类型docker build -t kai:1.0 .
• 类型docker run -p 8080:8080 kai:1.0
• 打开http：// localhost：8080

有关此方法的更多信息

发展

每本书的游戏规则位于www/data。 “ Mechanics-X”是书X的游戏规则。“ Objects.xml”是游戏对象

有（未完整的）规则，对象格式并保存游戏文件格式的文档。

游戏规则实现位于SRC/TS/Controller/Mechanics和www/Controller/Mechanics。

如果您在游戏URL中添加“？debug = true”，将会出现一些调试工具。您还可以使用浏览器开发人员工具来准备操作图表以测试各个部分。例如，在控制台中，您可以执行类似：

 kai . actionChartController . pick ( 'axe' )
kai . actionChartController . increaseMoney ( - 10 )

有一些开发脚本：

npm run downloaddata [booknumber] # Download books data from the Project Aon. Specify "booknumber" to download a single book
npm run lint          # Runs tslint over the Typescript code
npm run prepareversion [ -- [--debug] [KEYSTOREPASSWORD] ] # Prepare a version to upload on "dist" dir.
npm run cleandist     # Delete the "dist" dir
npm run ts            # Compile Typescript code for execution with node.js
npm run build         # Compile and pack Typescript code for execution with browser
npm run cleants       # Remove all code generated by the Typescript compiler
npm run reviewchanges BOOKNUMBER LANGUAGE # Compare the currently publised app book version with the latest version on the PAON SVN
npm run test          # Run tests

“ NPM Run Preparversion”将生成一个版本，以将其上传到Google Play和“ DIST”目录上的Project AON网站。然后，“ keystorepassword”是密钥库的密码。如果未指定，将生成一个未签名的.APK。我怀疑在Github上发布密钥店不是一个好主意。选项“ -Debug”将生成可辩论的版本

“ NPM Run Reviewschanges”非常有用，可用于检查上一个应用程序版本的“更改”。它需要命令ICONV，DWDIFF，而您的路径则少。

可以在doc/readme-developing.md上找到开发新书的“指南”

测试

测试与Selenium Web驱动程序和Jest一起进行。目前的测试仅使用Chrome进行，硒将需要一个“浏览器驱动程序”。有关安装说明，请参见https://www.selenium.dev/documentation/en/webdriver/driver_requirements。测试位于SRC/TS/测试中。在运行测试之前，请确保node.js的打字稿：

npm run ts
npm run test

执照

麻省理工学院。该应用程序使用以下第三方代码 /资源：

• HTML渲染，书籍XML处理和项目AON许可证HTML包含Liquid State Limited摘自Lone Wolf Adventures的代码
• 孤独的狼徽标和飞溅是从西班牙项目aon直接或改编的
• 按钮图标由Delapouite，Lorc和Willdabeast创建，并从http://game-icons.net/（CC许可证）分发
• 引导（麻省理工学院）
• 托斯特（麻省理工学院）
• filesaver.js（麻省理工学院）
• JQuery（jQuery许可证）
• Apache Cordova（Apache许可证）
• XML.JS，从http://syssgx.github.io/xml.js/获取的代码（CC许可证）
• Cordova-Plugin-ZIP（许可证）
• Cordova-Plugin-Zeep（Apache许可证2.0）
• Cordova-Filechooser（Apache许可证2.0）
• CORDOVA-PLUGIN-COPYTODOWNLOAD（MIT）
• Cordova-Plugin-document-Contract（MIT）

感谢LSI让我们为此应用使用其Google Play帐户。