kaichronicles

Kai Chronicles

November 2021: Aplikasi Kai Chronicles tidak lagi diterbitkan

Kai Chronicles adalah pemain permainan untuk buku -buku game Lone Wolf. Hanya buku 1 - 13 yang bisa dimainkan. Pemutar game dapat berjalan sebagai situs web atau aplikasi Android. Anda dapat memainkannya di https://www.projectaon.org/staff/toni atau unduh aplikasi dari Google Play .

Repositori ini tidak berisi data buku game. Data harus diunduh dari situs web proyek AON. Ingatlah bahwa data buku game berada di bawah lisensi proyek AON, jadi:

• Anda tidak dapat meletakkan aplikasi ini di server web publik (hanya pada mesin lokal Anda, untuk Anda sendiri). Satu -satunya tempat di mana game ini dapat dipublikasikan adalah di situs web proyek aon
• Anda tidak dapat mendistribusikan kembali data buku game dengan cara apa pun

Versi Android yang lebih lama didukung adalah 5.1 (API 22). Web diuji dengan versi terbaru Chrome dan Firefox. Browser lain atau/dan versi yang lebih tua mungkin tidak berfungsi.

Pengaturan

Kompilasi naskah

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

Unduh Data Game AON Proyek:

npm run downloaddata

Ini akan membutuhkan node.js (versi terbaru), perintah zip dan klien svn di jalur Anda

Situs Web Pengaturan

npm run serve

Buka browser Anda di http: // localhost: 5000.

Siapkan Aplikasi Android

Instal Permintaan Android Cordova 9.0. Kemudian:

npm run cordova-prepare
npm run cordova-build

Ini akan menghasilkan file src/platform/android/build/output/apk/android-debug.apk dengan aplikasi android.

Anda dapat menguji aplikasi dengan emulator. Buka dengan Android Studio dan kemudian:

npm run cordova-run

Cordova diinstal sebagai persyaratan NPM, sehingga perintah lain tersedia dari node_modules. Contoh:

node_modules/cordova/bin/cordova plugin list

Secara default, aplikasi ini akan mengunduh buku dari proyek AON Web. Jika Anda perlu mengunduh buku dari server web pribadi Anda, Anda dapat mengubahnya di bookdownloadstate.ts, metode "downloadAsync".

Siapkan gambar Docker

Metode opsional untuk menjalankan situs web lokal hanya untuk memainkan game

• Unduh dan instal Docker dan pastikan itu ada di variabel lingkungan jalur Anda
• Menggunakan terminal (Linux atau iOS) atau PowerShell (Windows 10) Navigasi ke Direktori Proyek
• Jenis docker build -t kai:1.0 .
• Jenis docker run -p 8080:8080 kai:1.0
• Buka http: // localhost: 8080

Informasi lebih lanjut tentang metode ini di sini

Berkembang

Aturan permainan untuk setiap buku terletak di www/data. "Mechanics-X" adalah aturan permainan untuk buku X. "Objects.xml" adalah objek game

Ada dokumentasi (Unfishing) untuk aturan, format objek, dan simpan format file game.

Implementasi aturan permainan berada di SRC/TS/Controller/Mechanics dan WWW/Controller/Mechanics.

Jika Anda menambahkan "? Debug = true" ke URL game, beberapa alat debug akan muncul. Anda juga dapat menggunakan alat pengembang browser untuk menyiapkan bagan tindakan untuk menguji bagian individu. Misalnya, di konsol Anda dapat menjalankan hal -hal seperti:

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

Ada beberapa skrip untuk pengembangan:

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" akan menghasilkan versi untuk mengunggah ke Google Play dan situs web Project AON di direktori "Dist". Kemudian "KeyStorePassword" adalah kata sandi untuk keystore. Jika tidak ditentukan, .Apk yang tidak ditandatangani akan dihasilkan. Saya menduga itu bukan ide yang baik untuk menerbitkan Keystores di GitHub. Opsi "--debug" akan menghasilkan versi debuggable

"NPM Run ReviewChanges" berguna untuk memeriksa perubahan buku dari versi yang diterbitkan aplikasi terakhir. Ini membutuhkan perintah ICONV, DWDIFF, dan lebih sedikit di jalan Anda.

"Panduan" untuk mengembangkan buku baru dapat ditemukan di Doc/Readme-Developing.md

Tes

Tes dijalankan dengan Driver Web Selenium dan Jest. Saat ini tes hanya akan berjalan dengan Chrome, dan Selenium akan membutuhkan "pengemudi browser". Lihat https://www.selenium.dev/documentation/en/webdriver/driver_requirements untuk instruksi instalasi. Tes terletak di SRC/TS/Tes. Pastikan naskah untuk node.js dikompilasi sebelum menjalankan tes:

npm run ts
npm run test

Lisensi

Mit. Aplikasi ini menggunakan kode / sumber daya pihak ketiga berikut:

• Rendering HTML, Buku Pemrosesan XML dan Proyek Lisensi AON HTML berisi kode yang diambil dari Lone Wolf Adventures, oleh Liquid State Limited
• Logo dan percikan serigala tunggal diambil secara langsung, atau diadaptasi, dari Proyek Spanyol AON
• Tombol ikon dibuat oleh delapouite, lorc dan willdabeast, dan didistribusikan dari http://game-icons.net/ (lisensi cc)
• Bootstrap (MIT)
• Toastr (MIT)
• Filever.js (MIT)
• jQuery (lisensi jQuery)
• Apache Cordova (lisensi Apache)
• xml.js, kode yang diambil dari http://syssgx.github.io/xml.js/ (lisensi CC)
• cordova-plugin-zip (lisensi)
• Cordova-Plugin-Zeep (Lisensi Apache 2.0)
• Cordova-FileChooser (Lisensi Apache 2.0)
• Cordova-plugin-copytodownload (MIT)
• Cordova-plugin-Document-Contract (MIT)

Terima kasih kepada LSI karena telah mengizinkan kami menggunakan akun Google Play untuk aplikasi ini.