esup-multi

Arborescence des pages

Comparaison des versions

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.

...

Sommaire

Nom de l'app, bundle ID et Version

Dans le fichier /dev/user-frontend-ionic/capacitor.ts paramétrer :

...

Bloc de code
const config: CapacitorConfig = {
  appId: 'fr.esupportail.mobile.multi',
  appName: 'Esup-Multi',

Chemins vers le backend

Dans le fichier /dev/user-frontend-ionic/src/environments/environment.ts paramétrer paramétrer :

  • apiEndpoint : l'URL du backend. Il s'agit de celle du µService main.
  • cmsPublicAssetsEndpoints : l'URL des assets (images) saisie au travers du CMSHeadless et adressable publiquement.
Bloc de code
export const environment = {
  [...] 
  tenants: [
    {
      apiEndpoint: 'http://localhost:3000',
     cmsPublicAssetsEndpoint: 'http://localhost:8055/assets/', ...
    }
  [...] 
};

Modules

...

voir le détail pou pour chaque module Paramétrage des modules

Langues

Dans le fichier /dev/user-frontend-ionic/src/environments/environment.ts paramétrer :

...

Bloc de code
export const environment = {
  [...]
  languages: ['fr', 'en'],
  defaultLanguage: 'fr',
  [...] 
};
Avertissement
titleTODO

Ajouter les logo drapeau, les i18n et le CMS Headless...

CMSHeadless

Firebase pour les notifications

Titre de l'application et numéro de version

Dans le fichier /dev/user-frontend-ionic/src/environments/environment.ts paramétrer :

  • appTitle : Titre de l'application
  • appVersion : version de l'app
Bloc de code
export const environment = {
  [...]
  appTitle: 'Titre de l\'application',
  appVersion: '1.0.1'
  [...] 
};
Remarque

Le numéro de version tel qu'il est spécifié dans le fichier environment.ts ne sera utilisé que dans la version PWA du client.
Pour les clients natifs, la version sera celle spécifiée lors du build Android ou iOs et sera récupérée et affichée via un plugin Capacitor.

Firebase pour les notifications

Firebase Cloud Messaging (FCM) est un outil de Google qui permet de faire de la notification push sur plusieurs types de plateforme (Android, iOs, Web).
Vous trouverez plus d'information sur comment ajouter Firebase à votre projet, et notamment comment récupérer les fichiers nécessaires ici : https://capawesome.io/blog/the-push-notifications-guide-for-capacitor/

Ajouter les fichiers requis

Pour activer firebase vous trouverez Pour activer firebase ajouter dans le répertoire /dev/user-frontend-ionic/src/environments le sous-repertoire firebase et l'arborescence suivante : 

...

Y placer les fichiers téléchargés depuis Firebase pour iOs et Android.

Pour les notifications web, dans /dev/user-frontend-ionic/src/environments/firebase/web dupliquer et renommer le fichier firebase-environment.pwa.json.dist en firebase-environment.pwa.json et compléter avec les informations fournies par firebase.

Une fois complété, il devra ressembler à cela :

Bloc de code
{
  "apiKey": "",
  "authDomain": "universite-lorraine.firebaseapp.com",
  "projectId": "universite-lorraine",
  "storageBucket": "universite-lorraine.appspot.com",
  "messagingSenderId": "123456789",
  "appId": "1:123456789azerty987654321qsdfg",
  "measurementId": "G-A1Z2E3R4T5",
  "vapidKey": "xxxx la cle fournie xxxx"
}

Configurer Multi pour qu'il prenne en compte les fichiers Firebase

Décommenter les deux lignes dans le fichier et décommenter les deux lignes de /dev/user-frontend-ionic/src/environments/environment.ts

Bloc de code
import firebasePwaEnvironment from './firebase/web/firebase-environment.pwa-development.json';

export const environment = {
  [...]
  firebase: firebasePwaEnvironment,
  [...]
};

...

Bloc de code
plugins: {
     FirebaseMessaging: {
      presentationOptions: ['badge', 'sound', 'alert'],
    },

...

Tour guidé

Dans le fichier fichier /dev/user-frontend-ionic/src/environments/trapeze-config.yml décommenterenvironment.ts paramétrer :

  • guidedTourEnabled : Activer ou non le tour guidé true/false
Bloc de code
export const environment = {
  
Bloc de code
platforms:
  android:
[...]
    copy:
      - src: ../src/environments/firebase/android/google-services-dev.json
        dest: app/google-services.json

  ios:
[...]
    copy:
      - src: ../../src/environments/firebase/ios/GoogleService-Info-dev.plist
        dest: App/GoogleService-Info.plistguidedTourEnabled: true
};

Pour personnaliser le tour guidé, consultez Personnalisation du thème.

SI vous souhaitez éventuellement supprimer les sources liées au tour guidé pour réduire la taille de votre application, vous pouvez supprimer les répertoires suivants :

  • /dev/user-frontend-ionic/src/theme/app-theme/assets/guided-tour/
  • /dev/user-frontend-ionic/src/theme/app-theme/i18n/guided-tour/
  • /dev/user-frontend-ionic/src/theme/app-theme/guided-tour/

Il faudra aussi penser à retirer le module de la commande de build npm, dans le fichier package.json
Image Added