Dans cette page nous allons procéder à une installation quickstart de l'application c'est à dire que cette dernière...
- Fonctionnera de manière autonome avec des mock pas de connexion au SI
- Présentera la liste exhaustive des services qu'elle offre
- Ne proposera aucune personnalisation graphique
Cette installation vise plutôt le test de l'application ou la création d'un démonstrateur.
Récupération des sources
Cloner les sources disponibles sous gitHub https://github.com/univlorraine/esup-multi
git clone https://github.com/univlorraine/esup-multi.git
Le CMS Headless
=> va permettre de fournir du contenu dynamique au client mobile
TODO
Documenter l'installation du CMS et l'import des structures et data
Le Backend
Prérequis
Nécessite d'avoir Docker sur la machine de dev, notamment pour disposer des briques suivantes en local :
- Instance de Directus (cf. section Le CMS Headless)
- Serveur Nats
- Base Redis
Configuration des variable d'environnement
TODO
Mettre les mocks en place
TODO
Créer les fichiers .env.dist dans le main et les microservices
=> Lister tous les dossiers dans lesquels renommer le fichier .env.dist en .env (selon les modules qu'on aura décidé de mettre en place / activer côté client pour la démo)
Démarrer la gateway et les microservices
Dans chaque microservices :
$ npm start
TODO
Voir si on ne met pas en place un script sh qui permet de tout démarrer en une commande
Le Client
Parametrages minimal de l'application cliente
Dans /dev/user-frontend-ionic copier, coller et renommer le fichier capacitor.ts.dist en capacitor.ts. Ce fichier permet de paramétrer le nom de l'app et son identifiant, on laissera les valeur par défaut pour le quickstart.
Dans /dev/user-frontend-ionic/src/environments copier, coller et renommer le fichier environment.ts.dist en environment.ts. (Laisser les 2 lignes qui concernent firebase en commentaire)
Pour utiliser le thème par défaut disponible avec la démo, dans le sous-dossier /src/theme et renommer le fichier theme.scss.dist en theme.scss
Pour personnaliser tout ces éléments voir la documentation
Création des clients
ionic capacitor build
Compilation Trapeze
Installer Trapeze (https://trapeze.dev/)
Dans /dev/user-frontend-ionic/src copier, coller et renommer le fichier trapeze-config.yml.dist en trapeze-config.yml
Lancer la commande
cd /dev/user-frontend-ionic npx trapeze run trapeze-config.yml -y
Logo et spashscreen
Installer Capacitor Assets (https://github.com/ionic-team/capacitor-assets) avec la ligne de commande :
npm install --save-dev @capacitor/assets
Le logo et le splashscreen se trouvent par défaut dans /dev/user-frontend-ionic/src/theme/default/resources
Lancer la commande
cd /dev/user-frontend-ionic npx capacitor-assets generate --assetPath /src/theme/default/resources
Compilation et lancement de l'app
Lancement de la pwa
TODO
A détailler
Lancement des app mobiles
TODO
A détailler