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
Parametrages de l'application
Dans src copier, coller et renommer le fichier capacitor.ts.dist en capacitor.ts
Paramétrer :
- appId
- appName
Pour aller plus loin on peut la couleur de fond et le centrage du splashscreen
L'environnement
Dans src/environments copier, coller et renommer le fichier environment.ts.dist en environment.ts
Paramétrer :
- apiEndpoint
- cmsPublicAssetsEndpoints
(laisser les 2 lignes firebase en commentaire)
Pour aller plus loin : Pour activer firebase ajouter dans le rep environments le sous-rep
firebase
android
ios
web
y placer les documents téléchargés depuis firebase
et décommenter les deux ligens de environment.ts
Thème par défaut
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
Compilation Trapeze
Installer Trapeze
Dans src copier, coller et renommer le fichier trapeze-config.yml.dist en trapeze-config.yml
Adapter la variable PACKAGE_NAME et éventuellement VERSION_NAME et BUILD_NUMBER si vous ne souhaitez pas l'indiquer dans la ligne de commande (Attention il faudra donc le changer à chaque nouvelle version)
Lancer la commande
Exemple
VERSION_NAME="11.0.21" BUILD_NUMBER="110021" npx trapeze run trapeze-config.yml -y
Pour aller plus loin, décommentez la copie des fichier firebase dans les répertoire des application Android et iOs générée (à lancer une fois que les répertoires des app auraont été créés une 1ère fois.
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 /src/theme/default/resources
Respecter les conventions de nommage et le mode simple (recommandé dans la documentation https://github.com/ionic-team/capacitor-assets
logo.png
logodark.png
Attention
Bug de l'outil constaté avec les fichiers SVG dans la génération des ressources pour la PWA
Lancer la commande
npx capacitor-assets generate --assetPath /src/theme/default/resources
Directus
Compilation des clients
ionic capacitor build
Lancement de l'app
Lancement de la pwa
TODO
A détailler
Lancement des app mobiles
TODO
A détailler
