Historique de la page

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

Image Added

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 

Image Added

(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écharger depuis firebase

et décommenter les deux ligens de environment.ts

Quickstart

Récupération des sources

Sur Git

Paramétrages de l'application

Thème par défaut

Pour utiliser le thème par défaut disponible avec la démo, dirigez-vous dans le sous-dossier /src/theme et renommez le fichier theme.scss.dist en theme.scss 

Compilation

...

Trapeze

Installer Trapeze

https://trapeze.dev/

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

npx trapeze run config.yaml --android-project android --ios-project ios/App

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 defaut dans /src/theme/default/resources 

Respecter les conventions de nommage, préférer des SVG et le mode simple (recommandé dans la documentation https://github.com/ionic-team/capacitor-assets

logo.png

logodark.png

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

Lancement des app mobiles

...