kaichronicles

Кай Хроники

Ноябрь 2021 года: приложение Kai Chronicles больше не опубликовано

Kai Chronicles - игра для игр Lone Wolf. Только книги 1 - 13 можно играть. Игрочный игрок может работать как веб -сайт или приложение для Android. Вы можете сыграть его по адресу https://www.projectaon.org/staff/toni или скачать приложение из Google Play Анкет

Этот репозиторий не содержит данных игровых книг. Данные должны быть загружены с веб -сайта Project AON. Помните, что данные об игровых книгах находятся под лицензией Project AON, так что:

• Вы не можете поместить это приложение на общедоступный веб -сервер (только на вашей локальной машине, для вашего собственного использования). Единственное место, где может быть опубликована эта игра, находится на веб -сайте Project AON
• Вы не можете перераспределить данные об игровых книгах каким -либо образом

Поддержанная версия Android - 5,1 (API 22). Интернет тестируется с последней версией Chrome и Firefox. Другие браузеры или/и более старые версии могут не работать.

Настраивать

Компиляция TypeScript

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

Загрузите Data Project Aon Game:

npm run downloaddata

Это потребует node.js (любая недавняя версия), команда ZIP и клиент SVN на вашем пути

Настройка веб -сайта

npm run serve

Откройте свой браузер на http: // localhost: 5000.

Настройка приложения Android

Установите Cordova 9.0 Android Repcorments. Затем:

npm run cordova-prepare
npm run cordova-build

Это генерирует файл src/platforms/android/build/outputs/apk/android-debug.apk с приложением Android.

Вы можете проверить приложение с помощью эмулятора. Откройте его с Android Studio, а затем:

npm run cordova-run

Cordova устанавливается в качестве требования NPM, поэтому любая другая команда доступна в Node_Modules. Пример:

node_modules/cordova/bin/cordova plugin list

По умолчанию это приложение будет загружать книги из Project Aon Web. Если вам нужно загрузить книги с вашего частного веб -сервера, вы можете изменить их в bookdownloadstate.ts, метод «Скачать асинх».

Настройка изображения 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. «Механика-X»-это правила игры для книги X. «Objects.xml»-это игровые объекты

Существует (непочтительная) документация для правил, форматов объектов и сохранения формата файла игры.

Реализация правил игры выполнена в SRC/TS/Controller/Mechanics и WWW/Controller/Mechanics.

Если вы добавите "? Debug = true" в URL -адрес игры, появятся некоторые инструменты отладки. Вы также можете использовать инструменты разработчика браузеров для подготовки диаграммы действий для тестирования отдельных разделов. Например, в консоли вы можете выполнить такие вещи, как:

 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 PrepareVersion» генерирует версию для загрузки на Google Play и веб -сайт Project AON в каталоге "DIST". Затем «KeyStorPassword» - это пароль для хранилища ключей. Если это не указано, будет сгенерирована Unsigned .apk. Я подозреваю, что это не очень хорошая идея, чтобы публиковать ключевые магазины на Github. Опция "-debug" будет генерировать отзывающуюся версию

«NPM Run ReviewChanges» полезен для проверки изменений в книге из последней версии. Это требует команд ICONV, DWDIFF и меньше на вашем пути.

«Руководство» по разработке новых книг можно найти на doc/readme-developing.md

Тесты

Тесты запускаются с веб -драйвером Selenium и Jest. В настоящее время тесты будут выполняться только с Chrome, а Selenium потребуется «драйвер браузера». См. Тесты расположены на SRC/TS/тестах. Убедитесь, что TypeScript для node.js собирается перед запуском тестов:

npm run ts
npm run test

Лицензия

Грань В этом приложении используется следующий сторонний код / ​​ресурсы:

• Рендеринг HTML, Книги XML Обработка и лицензия Project AON HTML содержит код, взятый из Lone Wolf Adventures, Liquid State Limited
• Логотип и всплески одинокого волка взяты непосредственно или адаптируются из испанского проекта AON
• Значки кнопок создаются Delapouite, Lorc и Willdabeast и распределяются по http://game-icons.net/ (лицензия CC)
• Начальная загрузка (MIT)
• Toastr (MIT)
• Filesaver.js (MIT)
• jQuery (лицензия jquery)
• Apache Cordova (лицензия Apache)
• xml.js, код, взятый с http://syssgx.github.io/xml.js/ (лицензия CC)
• Cordova-Plugin-Zip (лицензия)
• Cordova-plugin-zeep (Apache License 2.0)
• Cordova-Filechooser (Apache License 2.0)
• Cordova-Plugin-Copytodownload (MIT)
• Cordova-Plugin-Document-Contract (MIT)

Спасибо LSI за то, что позволили нам использовать его учетную запись Google Play для этого приложения.