1.4 KiB
1.4 KiB
issueRef, version, updatedBy, updatedAt
| issueRef | version | updatedBy | updatedAt | ||||
|---|---|---|---|---|---|---|---|
| #130 | 5 |
|
1785669830933 |
Problème
Un plugin de développement doit souvent lire ou modifier des documents structurés. Sans primitive publique, chaque plugin doit réimplémenter parsing, validation et patching, avec un risque élevé de corruption ou d’incohérence.
Pourquoi c’est global
Le besoin concerne JSON, YAML, TOML, XML, propriétés, DSL de config, et potentiellement d’autres formats. Android n’est qu’un consommateur parmi d’autres.
Ce que ce ticket doit produire
Une API publique de documents/config structurés permettant idéalement :
- lecture d’un document typé ou semi-structuré
- édition contrôlée/patch ciblé
- sérialisation stable
- erreurs structurées
- capacité d’évolution format par format
Dépendances
- Dépend de
#124car il faut d’abord un accès fichier/workspace public.
Garde-fous
- Commencer petit si nécessaire; ne pas promettre tous les formats d’un coup.
- Préférer une abstraction extensible plutôt qu’un parser universel monolithique.
- Ne pas embarquer des helpers Android-only.
Critères d’acceptation
- Le SDK expose une primitive réutilisable pour lire et mettre à jour un document de config sans bricolage spécifique par plugin.
- Le contrat précise clairement quels formats sont supportés dans le premier lot.