Installation

Prérequis

Avant toute chose, pour utiliser l'application, tu dois t'assurer d'avoir téléchargé et installé sur ta machine :

• Npcap

• .Net Runtime (8)

1.a - Installation sans les sources

Je peux vous fournir une version de l'application compilée et full fonctionnelle, ce qui vous évite de faire la compilation / construction de l'app vous même. Cependant, ce service n'est accessible qu'au travers des donations. Si tu ne souhaites pas faire de donation, tu peux compiler toi même l'application à partir des sources.

1.b - Installation avec les sources

a - Avec Github Action

Rendez-vous sur le dépôt principal, puis faites un fork du repo. Rendez-vous ensuite sur le dépôt que vous avec fork (sur github). Vous avez accès à l'onglet "Action", qui va vous permettre de lancer une build. Si tout se passe bien, une fois la build finit, vous pourrez la télécharger depuis la page de la job complétée. Le reste des procédures se trouve à la suite.

b - En local

Prérequis :

• Visual Studio (2022 ou plus)

• Installer MAUI sur Visual Studio (Visual Studio Installer > Extensions)

• Net.8

Pour construire l'application, vous allez devoir cloner le projet de l'app et les subomdules (ici), ouvrez la solution, téléchargez les packages nuggets manquants (si c'est le cas) puis buildez l'application directement depuis Visual Studio.

Déplacez le dossier "Data" qui se trouve à la racine du dépôt git vers la racine de l'app construite.

Le reste des procédures se trouve à la suite.

2 - Ajouter un thème

Pour que l'application fonctionne correctement, vous devez définir un "Thème", que je définis "ComponentProvider". Les ComponentProvider (voir la section dédiée), permettent de créer vos propres thème et de les changer sans avoir a recompiler l'application. Pour l'instant il n'y a qu'un seul thème que vous pouvez retrouver sur ce dépo. J'essaye de fournir une release à chaque mises à jour téléchargeable depuis la page Github. Vous pouvez néanmoins compiler vous même le thème (voir section dédiée).

Lorsque vous intégrez un thème il y a deux opérations à suivre.

• Ajouter le contenu nécessaire dans le dossier wwroot (wwwroot/themes/<VOTRE_THEME>) Vous allez ajouter ici tout ce qui est css/js et images qui seront utilisés par l'app

• Ajouter le contenu nécessaire dans le dossier themes (themes/<VOTRE_THEME>) Vous allez ajouter ici toutes les dll nécessaires au chargement du thême

3 - Ajouter des plugins

Pour ajouter des plugins, commencer par créer un dossier "plugins" si il n'existe pas. Pour trouver la liste des plugins, et les télécharger (ou les compiler vous même) Rendez vous dans la Liste des Plugins

Lorsque vous téléchargez un plugin, lorsqu'il s'agit d'un simple plugin (sans vue) vous n'aurez qu'à déplacer le dossier obtenu dans votre dossier "plugins". Dans le cas d'une vue, c'est un peu comme pour les themes, vous devez déplacer deux dossiers, un dans wwroot/plugins/<VOTRE_PLUGIN>, et l'autre dans plugins/<VOTRE_PLUGIN> Dans le cas où vous compilez vous même un plugin, veuillez vous rendre sur la page dédié au développement des plugins (section publication)

Parfait, si vous avez respecté toutes les procédures, vous êtes en mesure de lancer l'exécutable (Dtwo.App.DesktopApp.exe) Si tu rencontres des soucis ou que tu as des questions, viens sur notre Discord !