Sasedev/games
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

0.2.0-0-pre.4-fix.1

Browse Source
This commit is contained in:
SinuS von SifriduS
2026-09-18 15:06:30 +02:00
parent a8ab312a3a
commit 504cc02712
10 changed files with 114 additions and 52 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/studies/000-README.md
View File

@@ -1,5 +1,5 @@
<!-- file: docs/studies/000-README.md -->
<!-- version: 5 -->
<!-- version: 6 -->
# Études
@@ -31,7 +31,7 @@ Ces études sont des propositions à relire. Elles ne deviennent pas automatique
## Études POC plateforme
- [`009-PLATFORM_POC_CANDIDATES.md`](009-PLATFORM_POC_CANDIDATES.md) — inventaire des POC réellement pertinents à partir du code existant.
- [`009-PLATFORM_POC_CANDIDATES.md`](009-PLATFORM_POC_CANDIDATES.md) — inventaire des POC plateforme focalisés sur Snake comme jeu-sonde unique.
- [`010-PLATFORM_POC_REUSE_AND_DELTA.md`](010-PLATFORM_POC_REUSE_AND_DELTA.md) — code réutilisable, modifications minimales et frontières à tester.
- [`011-PLATFORM_POC_VALIDATION_MATRIX.md`](011-PLATFORM_POC_VALIDATION_MATRIX.md) — critères comparables de build, runtime, input, packaging et intégration plateforme.
- [`012-PLATFORM_POC_SEQUENCE.md`](012-PLATFORM_POC_SEQUENCE.md) — ordre proposé des POC pour une future série `0.3.x`.

26
docs/studies/009-PLATFORM_POC_CANDIDATES.md
View File

@@ -1,5 +1,5 @@
<!-- file: docs/studies/009-PLATFORM_POC_CANDIDATES.md -->
<!-- version: 1 -->
<!-- version: 2 -->
# Candidats POC plateforme
@@ -30,16 +30,16 @@ Le projet dispose déjà de :
Les POC futurs doivent partir de cette base.
## POC A — Tauri Android avec Reflex
## POC A — Tauri Android avec Snake
### Question
Le chemin Tauri Android peut-il exécuter le même gameplay Reflex déjà utilisé par Tauri Desktop/WASM avec une intégration mobile acceptable ?
Le chemin Tauri Android peut-il exécuter le gameplay Snake avec une intégration mobile acceptable, en réutilisant au maximum les briques déjà validées par le POC Tauri/WASM Reflex ?
### Réutilisation visée
- `game-reflex-poc` ;
- `game-reflex-poc-wasm` si le modèle reste Wasm/WebView ;
- `game-snake-poc` ;
- abstractions et bridge Tauri/WASM déjà validés avec Reflex, après généralisation minimale ;
- frontend Vite/TypeScript existant ;
- tracing frontend/Tauri ;
- assets existants ;
@@ -67,16 +67,16 @@ Le chemin Tauri Android peut-il exécuter le même gameplay Reflex déjà utilis
- faisabilité ads/auth plus tard ;
- coût de maintenance par rapport au chemin SDL Android.
## POC B — Web navigateur direct avec Reflex
## POC B — Web navigateur direct avec Snake
### Question
Le même gameplay WASM peut-il être livré comme jeu Web direct, sans Tauri, avec un packaging propre et un input navigateur fiable ?
Le gameplay Snake peut-il être livré comme jeu Web direct, sans Tauri, avec un packaging propre et un input clavier/tactile fiable ?
### Réutilisation visée
- `game-reflex-poc` ;
- crate WASM existante ;
- `game-snake-poc` ;
- adaptation/généralisation de la crate WASM existante ;
- Vite/TypeScript partagé autant que pertinent ;
- assets communs.
@@ -97,7 +97,7 @@ Le même gameplay WASM peut-il être livré comme jeu Web direct, sans Tauri, av
### Question
La voie Tauri/WASM validée avec Reflex est-elle réellement générique ou trop spécifique au premier POC ?
La voie Tauri/WASM validée avec Reflex peut-elle être généralisée proprement pour Snake sans duplication structurelle ?
### Pourquoi Snake
@@ -123,7 +123,7 @@ Le runner SDL3 natif et le workspace Rust se construisent-ils proprement sur Win
### Périmètre
Reflex ou Snake, selon la cible la plus simple.
Snake, afin de conserver le même jeu-sonde sur toutes les plateformes.
### À tester
@@ -200,7 +200,7 @@ Peut-on remplacer les scripts Python POC par un outil de build explicite, reprod
- `x86_64` ;
- éventuellement autres ABI seulement si réellement supportées ;
- Debug/Release ;
- Reflex/Snake ;
- Snake ;
- placement contrôlé des artefacts ;
- Gradle orchestration ;
- diagnostic clair des prérequis.
@@ -220,7 +220,7 @@ Ne pas lancer immédiatement :
## Résultat attendu
La première vague doit surtout comparer trois chemins :
La première vague doit surtout comparer trois chemins autour du même gameplay Snake :
```text
SDL native

34
docs/studies/010-PLATFORM_POC_REUSE_AND_DELTA.md
View File

@@ -1,5 +1,5 @@
<!-- file: docs/studies/010-PLATFORM_POC_REUSE_AND_DELTA.md -->
<!-- version: 1 -->
<!-- version: 2 -->
# Réutilisation et delta attendu des POC plateforme
@@ -58,30 +58,24 @@ Candidats :
Aucune extraction n'est imposée avant d'avoir vu la duplication réelle.
## Reflex comme sonde
## Snake comme sonde unique des POC plateforme
Reflex reste un bon POC de plateforme parce qu'il est petit.
Snake devient le jeu-sonde de référence pour les POC plateforme de la future série `0.3.x`.
Il permet d'isoler :
Il exerce simultanément :
- pointer/touch ;
- timing ;
- rendu simple ;
- WASM ;
- bridge ;
- startup.
## Snake comme seconde sonde
Snake vérifie que la solution n'est pas façonnée uniquement pour Reflex.
Il ajoute :
- keyboard/swipe ;
- keyboard/swipe/touch ;
- update continu ;
- grille et déplacements ;
- plusieurs entités ;
- état de jeu persistant plus longtemps ;
- besoin potentiel de virtual controls.
- état de jeu persistant ;
- obstacles/collision ;
- score/lives potentiels ;
- resize/orientation ;
- besoin potentiel de virtual controls ;
- future extension multi-snake/multiplayer.
Les briques Tauri/WASM déjà construites avec Reflex restent des références techniques à réutiliser, mais les nouveaux POC ne doivent plus utiliser Reflex comme jeu principal.
## Règle de modification minimale

8
docs/studies/011-PLATFORM_POC_VALIDATION_MATRIX.md
View File

@@ -1,5 +1,5 @@
<!-- file: docs/studies/011-PLATFORM_POC_VALIDATION_MATRIX.md -->
<!-- version: 1 -->
<!-- version: 2 -->
# Matrice de validation des POC plateforme
@@ -16,8 +16,8 @@ Chaque POC doit produire des observations comparables.
| Build | commande reproductible, dépendances, durée indicative |
| Artifact | type, taille, emplacement |
| Startup | lancement réussi, erreurs, temps indicatif |
| Render | frame visible, resize/orientation |
| Input | actions principales, latence perçue, touch/keyboard/pointer |
| Render | grille/Snake visibles, multi-entités, resize/orientation |
| Input | Snake : directions, keyboard/swipe/touch, latence perçue |
| Lifecycle | pause/resume/background/quit selon host |
| Logging | domaines visibles sur le canal plateforme |
| Assets | chargement sans chemin hardcodé |
@@ -25,7 +25,7 @@ Chaque POC doit produire des observations comparables.
| Packaging | APK/AAB/app bundle/static web/binary selon cible |
| Distribution | contraintes de signature/store identifiées |
| Platform integration | faisabilité auth/ads/IAP/notifications sans implémentation finale |
| Code reuse | part de gameplay/adapters/front réutilisée |
| Code reuse | part de `game-snake-poc`, adapters et front réutilisée |
| Duplication | duplication nouvelle explicitement recensée |
| Maintenance | complexité qualitative et outils nécessaires |

12
docs/studies/012-PLATFORM_POC_SEQUENCE.md
View File

@@ -1,5 +1,5 @@
<!-- file: docs/studies/012-PLATFORM_POC_SEQUENCE.md -->
<!-- version: 1 -->
<!-- version: 2 -->
# Séquence proposée des POC plateforme
@@ -15,16 +15,18 @@ La future série `0.3.x` pourra être dédiée aux POC plateforme, mais la numé
Ordre candidat :
1. Tauri Android + Reflex ;
2. Web navigateur direct + Reflex ;
1. Tauri Android + Snake ;
2. Web navigateur direct + Snake ;
3. Tauri Desktop + Snake ;
4. builder Android multi-ABI.
4. builder Android multi-ABI centré sur Snake.
Raisons :
- réutilisation maximale ;
- un seul gameplay de référence sur toutes les plateformes ;
- réutilisation maximale de `game-snake-poc` ;
- environnement déjà proche de celui utilisé ;
- comparaison directe SDL / Web / Tauri ;
- préparation directe du futur super Snake ;
- détection rapide des abstractions manquantes.
## Vague 2 — plateformes natives supplémentaires