Historique de la page

Avant tout chose...

Pour personnaliser le thème de l'application, vous devez dupliquer le dossier default app-theme-dist dans le répertoire /dev/user-frontend-ionic/src/theme et le renommer avec le nom de votre choixen app-theme (le nom du nouveau dossier doit être respecté, car certains éléments comme les modules importent les feuilles de style via un chemin absolu déjà établi). Si ce n'est pas déjà fait, il faudra également également renommer le fichier theme.scss.dist en theme.scss. 

...

Installer Capacitor Assets https://github.com/ionic-team/capacitor-assets avec la ligne de commande :

...

Le logo et le splashscreen se trouvent par défaut dans /dev/user-frontend-ionic/src/theme/defaultapp-theme-dist/resources

Placer vos ressources à l'identique dans /dev/user-frontend-ionic/src/theme/<themeapp-name>theme/resources

Respecter les conventions de nommage et le mode simple (recommandé dans la documentation https://github.com/ionic-team/capacitor-assets)

/dev/user-frontend-ionic/src/theme/<themeapp-name>theme/resources
|--logo.png

Lancer la commande

cd /dev/user-frontend-ionic/
npx capacitor-assets generate --assetPath /src/theme/<themeapp-name>theme/resources

Il faudra au minimum une image nommée logo afin de générer toutes les assets nécessaires.

...

Enfin, ionic propose des options supplémentaires grâce à un plugin SplashScreen déclaré dans le fichier /dev/user-frontend-ionic/capacitor.ts

plugins: {
    SplashScreen: {
      androidScaleType: 'CENTER_CROP',
      splashFullScreen: true,
      splashImmersive: false,
      backgroundColor: '#ffffff',
    },

Les feuilles de style

Pour que le thème soit pris en compte, il faut modifier les imports dans le fichier theme.scss.

...

Tous les éléments dans le répertoire /src/theme sont ignorés du git, sauf le fichier theme.scss.dist et le dossier /app-theme-dist.

Modules

Les feuilles de style des modules sont dans le répertoire /src/theme/app-theme/styles.

Pour personnaliser le style des modules, vous pouvez modifier directement les fichiers présents dans le répertoire, ilsne seront pas pris en compte dans les commits.

Les icônes, logo, et polices

Tous les fichiers ressources (icones, police, logos) appelés depuis les fichiers scss doivent se trouver dans un répertoire /assets du thème.

Ajouter des icônes personnalisées

Un mécanisme a été mis en place pour permettre l'ajout d'icônes et les utiliser comme des icônes natives Ionic. Par exemple : <ion-icon name="[nom-icône]">, où [nom-icône] représente simplement le nom du fichier SVG.

Pour ajouter une nouvelle icône, collez simplement celle-ci au format SVG dans un des dossiers d'icônes features/, flag/, navigation/, social-network/, static-pages/ présents dans src/theme/app-theme/assets/icons/

Vous avez également la possibilité d'ajouter une nouvelle collection d'icônes au format SVG à votre client.
Pour cela, placez votre dossier dans src/theme/app-theme/assets/icons/ et déclarez le dossier dans le fichier angular.json au niveau la propriété projects.app.architect.build.options.assets

{
	"glob": "**/*.svg",
	"input": "src/theme/app-theme/assets/icons/nouveau_dossier",
	"output": "./svg"
},

Votre nouveau set d'icônes sera automatiquement intégré par ionic.

Traductions

Tous les fichiers de traduction i18n doivent se trouver dans un répertoire /assets/i18n du thème.

Tour guidé

Tous les fichiers images appelés depuis tour guidé doivent se trouver dans un répertoire /assets/guided-tour du thème.

Le tour guidé repose sur un module Angular, guided-tour, placé à la racine du répertoire du thème. Les fichiers chargés de déclarer la navigation du tour guidé doivent se trouver dans ce module.

Les tours guidés à exporter sont :

• anonymousSteps : tour guidé lorsque l'utilisateur n'est pas connecté
• loggedSteps : tour guidé lorsque l'utilisateur est connecté

Pour désactiver le tour guidé, référez-vous à Paramétrages des clients.

Tous les éléments dans le répertoire /src/theme seront ignorés du git, sauf le fichier theme.scss.dist et le dossier /default, vous êtes donc libre d'organiser la structure du sous-répertoire.

Les icônes, logo, et polices

...