kaichronicles

Kai Chronicles

November 2021: Kai Chronicles App wird nicht mehr veröffentlicht

Kai Chronicles ist ein Spielspieler für Lone Wolf Game Books. Nur Bücher 1 - 13 sind spielbar. Der Game Player kann als Website oder Android -App ausgeführt werden. Sie können es unter https://www.projectaon.org/staff/toni abspielen oder die App von Google Play herunterladen .

Dieses Repository enthält keine Spielbücherdaten. Daten müssen auf der Website von Projekt AON heruntergeladen werden. Denken Sie daran , dass die Datenbücherdaten unter der Project AON -Lizenz stehen: also:

• Sie können diese Anwendung nicht auf einen öffentlichen Webserver (nur auf Ihrem lokalen Computer, für Ihre eigene Verwendung) einsetzen. Der einzige Ort, an dem dieses Spiel veröffentlicht werden kann
• Sie können die Datenbücherdaten in keiner Weise umverteilen

Die Android ältere unterstützte Version ist 5.1 (API 22). Das Web wird mit der neuesten Version von Chrome und Firefox getestet. Andere Browser oder/und ältere Versionen funktionieren möglicherweise nicht.

Aufstellen

TypeScript kompilieren

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

Laden Sie das Projekt AON GAME -Daten herunter:

npm run downloaddata

Dies erfordert Node.js (jede aktuelle Version), den ZIP -Befehl und den SVN -Client auf Ihrem Weg

Website einrichten

npm run serve

Öffnen Sie Ihren Browser unter http: // localhost: 5000.

Setup Android App

Installieren Sie Cordova 9.0 Android -Anforderungen. Dann:

npm run cordova-prepare
npm run cordova-build

Dadurch wird mit der Android-App eine Datei SRC/Plattformen/Android/Build/Output/APK/Android-Debug.apk generiert.

Sie können die App mit dem Emulator testen. Öffnen Sie es mit Android Studio und dann:

npm run cordova-run

Cordova ist als NPM -Anforderung installiert, sodass jeder andere Befehl bei node_modules verfügbar ist. Beispiel:

node_modules/cordova/bin/cordova plugin list

Standardmäßig lädt diese App die Bücher aus dem Projekt Aon Web herunter. Wenn Sie die Bücher von Ihrem privaten Webserver herunterladen müssen, können Sie sie in bookdownloadState.ts, Methode "DownloadaSync" ändern.

Richten Sie ein Docker -Bild ein

Optionale Methode zum Ausführen einer lokalen Website nur zum Spielen des Spiels

• Laden Sie Docker herunter und installieren Sie Docker und stellen Sie sicher, dass es sich in Ihrer Pfadumgebungsvariable befindet
• Verwenden eines Terminals (Linux oder iOS) oder PowerShell (Windows 10) Navigieren Sie zum Verzeichnis des Projekts
• Typ docker build -t kai:1.0 .
• Typ docker run -p 8080:8080 kai:1.0
• Öffnen Sie http: // localhost: 8080

Weitere Informationen zu dieser Methode hier

Entwicklung

Die Spielregeln für jedes Buch finden Sie unter www/data. "Mechanics-X" sind die Spielregeln für das Buch X. "Objects.xml" sind die Spielobjekte

Es gibt (ungezwungene) Dokumentation für Regeln, Objektformate und Speichern von Spieldatei.

Die Implementierung der Spielregeln erfolgt bei SRC/TS/Controller/Mechanik und www/Controller/Mechanik.

Wenn Sie "Debug = True" zur Spiel -URL hinzufügen, werden einige Debug -Tools angezeigt. Sie können auch die Browser -Entwickler -Tools verwenden, um das Aktionsdiagramm zu erstellen, um einzelne Abschnitte zu testen. In der Konsole können Sie beispielsweise Dinge ausführen wie:

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

Es gibt einige Skripte für die Entwicklung:

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 Prepeversion" generiert eine Version, die auf das Google Play und die Projekt AON auf dem Verzeichnis "Dist" hochgeladen werden soll. Dann ist "KeystorePassword" das Kennwort für den Keystore. Wenn es nicht angegeben ist, wird ein nicht signiertes .APK erzeugt. Ich vermute, es ist keine gute Idee, Keystores auf GitHub zu veröffentlichen. Option "-Debug" generiert eine debuggierbare Version

"NPM Run ReviewChanges" ist nützlich, um Buchänderungen aus der letzten App -Version zu überprüfen. Es erfordert Befehle Iconv, DWDIFF und weniger auf Ihrem Weg.

Ein "Leitfaden" zur Entwicklung neuer Bücher finden Sie unter DOC/Readme-Developing.md.md

Tests

Tests werden mit Selenium -Web -Treiber und Scherz durchgeführt. Derzeit werden die Tests nur mit Chrome ausgeführt, und Selen benötigt einen "Browser -Treiber". Siehe https://www.selenium.dev/documentation/en/webdriver/driver_requirements für Installationsanweisungen. Die Tests befinden sich bei SRC/TS/Tests. Stellen Sie sicher, dass TypeScript für node.js vor dem Ausführen von Tests kompiliert wird:

npm run ts
npm run test

Lizenz

MIT. Diese Anwendung verwendet den folgenden Code / Ressourcen von Drittanbietern:

• Das HTML -Rendering, die Bücher XML -Verarbeitung und das Projekt AON Lizenz HTML enthält Code aus einzelnen Wolf Adventures, von Liquid State Limited
• Das einsame Wolf -Logo und die Spritzer werden direkt aus dem spanischen Projekt AON genommen oder angepasst
• Schaltflächensymbole werden von Delapouite, Lorc und Willdabeast erstellt und von http://game-icons.net/ (CC-Lizenz) verteilt.
• Bootstrap (MIT)
• Toastr (MIT)
• Fileaver.js (MIT)
• JQuery (JQuery -Lizenz)
• Apache Cordova (Apache -Lizenz)
• xml.js, Code von http://sysssgx.github.io/xml.js/ (CC -Lizenz)
• Cordova-Plugin-Zip (Lizenz)
• Cordova-Plugin-Zeep (Apache-Lizenz 2.0)
• Cordova-Filechooser (Apache-Lizenz 2.0)
• Cordova-Plugin-CopyTodownload (MIT)
• Cordova-Plugin-Dokument-Vertreter (MIT)

Vielen Dank an LSI für die Verwendung seines Google Play -Kontos für diese App.