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帳戶。