kaichronicles

Kai Chronicles

Novembro de 2021: o aplicativo Kai Chronicles não é mais publicado

Kai Chronicles é um jogador de jogo para livros de jogos de lobos solitários. Somente os livros 1 - 13 são jogáveis. O jogador de jogo pode ser executado como um site ou aplicativo Android. Você pode tocá -lo em https://www.projectaon.org/staff/toni ou baixar o aplicativo do Google Play .

Este repositório não contém dados de livros de jogo. Os dados devem ser baixados no site do projeto AON. Lembre -se de que os dados dos livros de jogos estão sob a licença do projeto AON, então:

• Você não pode colocar este aplicativo em um servidor público da Web (apenas em sua máquina local, para seu próprio uso). O único lugar onde este jogo pode ser publicado é no site do projeto AON
• Você não pode redistribuir os dados dos livros de jogo de forma alguma

A versão suportada mais antiga do Android é 5.1 (API 22). A Web é testada com a versão mais recente do Chrome e Firefox. Outros navegadores ou/e versões mais antigas podem não funcionar.

Configurar

Compile 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

Baixe os dados do jogo do projeto AON:

npm run downloaddata

Isso exigirá Node.js (qualquer versão recente), comando zip e o cliente SVN em seu caminho

Site de configuração do site

npm run serve

Abra seu navegador em http: // localhost: 5000.

Configure o aplicativo Android

Instale o Cordova 9.0 Requisitos de Android. Então:

npm run cordova-prepare
npm run cordova-build

Isso gerará um arquivo SRC/Platforms/Android/Build/Outputs/APK/Android-Debug.apk com o aplicativo Android.

Você pode testar o aplicativo com o emulador. Abra -o com o Android Studio e depois:

npm run cordova-run

O Cordova é instalado como requisito de NPM; portanto, qualquer outro comando está disponível nos node_modules. Exemplo:

node_modules/cordova/bin/cordova plugin list

Por padrão, este aplicativo baixará os livros da Web do Projeto AON. Se você precisar fazer o download dos livros do seu servidor da Web privado, poderá alterá -lo no bookDownloadState.ts, método "DownloadAsync".

Configure uma imagem do Docker

Método opcional para administrar um site local apenas para jogar o jogo

• Faça o download e instale o Docker e verifique se está na sua variável de ambiente de caminho
• Usando um terminal (Linux ou iOS) ou PowerShell (Windows 10) Navegue até o diretório do projeto
• Tipo docker build -t kai:1.0 .
• Tipo docker run -p 8080:8080 kai:1.0
• Aberto http: // localhost: 8080

Mais informações sobre este método aqui

Em desenvolvimento

As regras do jogo para cada livro estão localizadas em www/dados. "Mechanics-x" são as regras do jogo para o livro X. "Objects.xml" são os objetos do jogo

Existe documentação (sem escalada) para regras, formatos de objeto e salvar formato de arquivo de jogo.

A implementação das regras do jogo está no SRC/TS/Controller/Mechanics e WWW/Controller/Mechanics.

Se você adicionar "? Debug = True" ao URL do jogo, algumas ferramentas de depuração aparecerão. Você também pode usar as ferramentas de desenvolvedor do navegador para preparar o gráfico de ação para testar seções individuais. Por exemplo, no console, você pode executar coisas como:

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

Existem alguns scripts para o desenvolvimento:

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" gerará uma versão para fazer upload para o Google Play e o site do Project AON no diretório "Dist". Então "KeyStorePassword" é a senha para a keystore. Se não for especificado, um .APK não assinado será gerado. Suspeito que não seja uma boa ideia publicar Keystores no Github. Opção "--Debug" irá gerar uma versão de debatcle

"NPM Run ReviewChanges" é útil para verificar as alterações da lista da última versão publicada do aplicativo. Requer comandos iconv, dwdiff e menos no seu caminho.

Um "guia" para desenvolver novos livros pode ser encontrado em doc/readme-Developing.md

Testes

Os testes são executados com o Selenium Web Driver e Jest. Atualmente, os testes serão executados apenas com o Chrome, e o Selenium precisará de um "driver do navegador". Consulte https://www.selenium.dev/documentation/en/webdriver/driver_requiements para instruções de instalação. Os testes estão localizados em SRC/TS/testes. Certifique -se de o TypeScript para Node.js ser compilado antes de executar os testes:

npm run ts
npm run test

Licença

Mit. Este aplicativo usa o seguinte código / recursos de terceiros:

• A renderização HTML, os livros de processamento XML e o Projeto AON License HTML contém código retirado de Aventuras Lone Wolf, pela Liquid State Limited
• O logotipo solitário de lobo e salpicos são tomados diretamente ou adaptados do projeto espanhol AON
• Os ícones de botão são criados por Delapouite, Lorc e Willdabeast, e distribuídos em http://game-icons.net/ (licença CC)
• Bootstrap (MIT)
• Toastr (MIT)
• FileSaver.js (MIT)
• jQuery (licença jQuery)
• Apache Cordova (Licença Apache)
• xml.js, código retirado de http://syssgx.github.io/xml.js/ (licença CC)
• Cordova-Plugin-Zip (licença)
• CORDOVA-PLUGIN-ZEEP (Licença Apache 2.0)
• Cordova-Filechooser (Licença Apache 2.0)
• Cordova-Plugin-Copytodownload (MIT)
• Cordova-Plugin-Document-Contract (MIT)

Agradecemos à LSI por nos deixar usar sua conta do Google Play para este aplicativo.