Desenvolupament de mòduls MADS a VS Code
L'extensió MADS V5 per a Visual Studio Code és l'entorn recomanat per treballar amb MADS. No substitueix l'eina mads: l'executa per tu, de manera que tot el que fas a l'editor es pot repetir al terminal o en un servidor d'integració contínua.
La vista Mads
Quan obres una carpeta que conté mòduls MADS, apareix la vista Mads a l'Explorador. Per a cada mòdul mostra:
| Secció | Què conté | Accions habituals |
|---|---|---|
| Customization | Els fitxers XML de metadades | Editar dominis, model de dades, textos i paràmetres |
| Runtimes | Les configuracions d'execució | Afegir un runtime, triar el per defecte, executar i depurar |
| Dependencies | Els mòduls dels quals depèn | Editar les dependències del mòdul |
| Deployment | El descriptor de desplegament | Publicar el mòdul o l'app a WAPP |
Des de la barra de la vista pots afegir un mòdul nou (Add a new mads module) o actualitzar-la.
Editors i inspectors
- Editors de metadades: Edit domains, Edit data model, Edit strings, Edit parameters, Edit default runtime, Edit module dependencies i Edit POM descriptor.
- Mads: Domains inspector i Mads: Metadata model inspector: consulta els dominis i el model de base de dades del mòdul.
- Mads: Metadata model generator: genera l'esquema de base de dades a partir d'una base de dades existent.
- Mads: Database syncronizer: compara i sincronitza el model amb una base de dades.
- Mads: Resources translator: tradueix els textos del mòdul.
- Mads: Security utility: gestiona la seguretat del mòdul.
Metodologia recomanada
- Comença pel model. Defineix dominis i taules abans que pantalles. Un bon domini (per exemple, un import o un codi d'estat) es reutilitza en moltes columnes i en manté la coherència.
- Genera després de cada canvi de metadades. Mads: Generate module actualitza entitats, Peers, Filters i textos. Per a un sol tipus de recurs tens Generate java model, Generate flutter/dart model i Generate text resources.
- Deixa que el compilador et guiï. Després de regenerar, els errors de compilació assenyalen exactament el codi afectat pel canvi. Corregeix-los abans de continuar.
- No escriguis mai noms de columnes com a text. Fes servir sempre l'enumerat generat (
FacturaField.estado), també en renderers i editors de taula. - Prova en local. Mads: Run & Debug app llança el mòdul amb el seu runtime per defecte; Mads: Run module tests n'executa els tests.
- Construeix i versiona. Mads: Build module compila, empaqueta i instal·la al teu repositori Maven local. Abans de lliurar, Mads: Update module version fixa la nova versió.
- Desplega i publica. Mads: Deploy module publica l'artefacte al repositori Maven; Mads: Publish module i Mads: Publish app el publiquen a WAPP.
Treball en equip
- Versiona les metadades (
src/main/res) igual que el codi: són la font de veritat del mòdul. - Revisa els canvis de metadades juntament amb el codi regenerat a la mateixa revisió (pull request).
- Mantén els textos traduïts al dia amb Mads: Resources translator abans de cada versió.
Següent pas: automatitzar el cicle amb Maven.