Installer Documentize via NuGet

Comment Installer via la Console du Gestionnaire de Paquets NuGet

1. Ouvrez Votre Projet:

   • Lancez Visual Studio et ouvrez votre application .NET.

2. Accédez à la Console du Gestionnaire de Paquets:

   • Allez dans Outils > Gestionnaire de Paquets NuGet > Console du Gestionnaire de Paquets.

3. Installer le Paquet:

   • Pour installer la dernière version complète, saisissez la commande Install-Package Documentize.
   • Pour installer la dernière version avec les correctifs, utilisez Install-Package Documentize -prerelease.
   • Appuyez sur Entrée pour exécuter la commande.

Comment Mettre à Jour le Paquet via la Console du Gestionnaire de Paquets NuGet

Si vous avez déjà installé Documentize via NuGet et que vous souhaitez mettre à jour vers la dernière version:

1. Ouvrez Votre Projet:

   • Lancez Visual Studio et ouvrez votre application .NET.

2. Accédez à la Console du Gestionnaire de Paquets:

   • Allez dans Outils > Gestionnaire de Paquets NuGet > Console du Gestionnaire de Paquets.

3. Mettez à Jour le Paquet:

   • Pour mettre à jour vers la dernière version complète, entrez Update-Package Documentize.
   • Pour mettre à jour vers la dernière version avec les correctifs, utilisez Update-Package Documentize -prerelease.
   • Appuyez sur Entrée pour exécuter la commande.

Comment Installer via l’Interface Graphique du Gestionnaire de Paquets NuGet

1. Ouvrez Votre Projet:

   • Lancez Visual Studio et ouvrez votre application .NET.

2. Accédez à Gérer les Paquets NuGet:

   • Dans le menu Projet, sélectionnez Gérer les Paquets NuGet.

3. Recherchez Documentize:

   • Accédez à l’onglet Parcourir et entrez Documentize dans la boîte de recherche.

4. Installez le Paquet:

   • Cliquez sur Installer/Mise à jour à côté de la dernière version de Documentize.
   • Confirmez en cliquant sur Accepter dans la fenêtre contextuelle.

Avantages de l’Utilisation de NuGet

• Gestion Automatique des Dépendances:

  • NuGet gère automatiquement les dépendances, garantissant que toutes les bibliothèques requises sont incluses et mises à jour correctement. Cela réduit le risque de dépendances manquantes ou incompatibles.

• Mises à Jour Simplifiées:

  • La mise à jour des paquets est simple avec NuGet, que ce soit via la Console du Gestionnaire de Paquets ou l’interface graphique. Cela facilite le maintien à jour de vos bibliothèques avec les dernières fonctionnalités et correctifs.

• Intégré à Visual Studio:

  • NuGet est parfaitement intégré à Visual Studio, offrant une interface conviviale pour gérer les paquets sans quitter l’environnement de développement.

• Gestion des Versions:

  • NuGet vous permet de spécifier et de gérer différentes versions de bibliothèques, vous permettant de revenir facilement aux versions précédentes ou de tester de nouvelles versions sans perturber votre développement.

Inconvénients de l’Utilisation de NuGet

• Limité à Visual Studio:

  • NuGet est principalement conçu pour une utilisation au sein de Visual Studio. Bien qu’il puisse être utilisé dans d’autres environnements, l’intégration est la plus robuste dans Visual Studio.

• Potentiel de Conflits de Versions:

  • Dans les projets plus grands avec de nombreuses dépendances, la gestion des versions et la résolution des conflits peuvent devenir complexes. NuGet fournit des outils pour gérer cela, mais cela nécessite une attention particulière.

• Dépendance au Réseau:

  • L’installation et la mise à jour des paquets nécessitent une connexion Internet. Si vous travaillez dans un environnement avec un accès Internet restreint ou inexistant, vous devrez peut-être utiliser des méthodes hors ligne ou pré-télécharger des paquets.

• Complexité pour de Grands Projets:

  • Pour les très grands projets avec des arbres de dépendances étendus, la gestion des paquets via NuGet peut devenir lourde. Dans de tels cas, des outils ou des stratégies supplémentaires peuvent être nécessaires pour gérer efficacement les dépendances.

Installation de Documentize via MSI

Comment Installer via l’Installateur MSI

1. Téléchargez l’Installateur MSI:

   • Cliquez sur le v24.12 MSI pour télécharger l’installateur MSI pour la dernière version de Documentize.

2. Exécutez l’Installateur:

   • Double-cliquez sur le fichier MSI téléchargé pour lancer l’assistant d’installation.

3. Suivez l’Assistant d’Installation:

   • Suivez les instructions à l’écran fournies par l’installateur. Vous devrez peut-être accepter le contrat de licence et sélectionner des options d’installation.

4. Complétez l’Installation:

   • Une fois l’installation terminée, les DLL de Documentize seront installées dans le Global Assembly Cache (GAC) de votre système ou à un autre emplacement spécifié.

5. Vérifiez l’Installation:

   • Vérifiez que les DLL sont correctement installées en vérifiant leur présence dans le répertoire d’installation désigné ou le GAC.

Avantages de l’Utilisation de l’Installateur MSI

• Facilité d’Utilisation:

  • L’installateur MSI propose un processus d’installation simple et guidé. Il gère toutes les configurations nécessaires et place les DLL dans un emplacement central, facilitant l’utilisation de Documentize dans plusieurs projets.

• Installation au Niveau Système:

  • La méthode MSI installe Documentize dans le Global Assembly Cache (GAC) du système ou à un autre emplacement central. Cela permet à n’importe quelle application sur le système d’accéder aux DLL sans avoir besoin de les référencer individuellement dans chaque projet.

• Mises à Jour Automatisées:

  • Si Documentize fournit un installateur mis à jour, vous pouvez facilement mettre à jour votre installation en exécutant le nouveau fichier MSI, qui gère généralement le processus de mise à jour en douceur.

• Cohérence:

  • L’utilisation de l’installateur MSI garantit que tous les fichiers requis sont installés correctement et de manière cohérente dans différents environnements, réduisant le risque de DLL manquantes ou mal placées.

Inconvénients de l’Utilisation de l’Installateur MSI

• Flexibilité Limitée:

  • L’installateur MSI installe Documentize dans un emplacement au niveau système, ce qui peut ne pas convenir à tous les environnements de développement. Il peut manquer de flexibilité pour accommoder des configurations ou des versions spécifiques aux projets.

• Surcharge Potentielle:

  • L’installation de DLL dans le GAC peut introduire une surcharge et de la complexité, notamment dans les scénarios où plusieurs versions de Documentize pourraient être nécessaires simultanément.

• Suppression Manuelle:

  • Si vous devez désinstaller Documentize, vous devez utiliser le désinstallateur fourni par le MSI, qui peut laisser des fichiers ou des configurations résiduels s’ils ne sont pas correctement gérés.

• Conflits de Version:

  • Les installations au niveau système peuvent entraîner des conflits de version si différents projets nécessitent des versions différentes de Documentize. Gérer ces conflits peut nécessiter des configurations ou un nettoyage supplémentaires.

Installer Documentize via ZIP

Comment Installer via Archive ZIP

1. Téléchargez l’Archive ZIP :

   • Cliquez sur le v24.12 ZIP pour télécharger la dernière version de Documentize au format archive.

2. Extrayez le Contenu :

   • Après le téléchargement, extrayez le contenu du fichier ZIP dans un répertoire de votre choix. Vous pouvez choisir de conserver ces fichiers dans un répertoire partagé ou dans la structure de votre projet.

3. Ajoutez des Références à Votre Projet :

   • Ouvrez votre projet dans votre IDE (par exemple, Visual Studio).
   • Allez dans Projet > Ajouter une référence > Parcourir et naviguez jusqu’au répertoire où vous avez extrait les DLLs.
   • Sélectionnez les fichiers DLL pertinents et ajoutez-les en tant que références à votre projet.

4. Mises à Jour Manuelles :

   • Si une nouvelle version de Documentize est publiée, vous devrez télécharger manuellement l’archive ZIP mise à jour et remplacer l’ancienne DLL dans votre projet par les nouvelles.

Avantages de l’Utilisation de l’Archive ZIP

• Contrôle Complet :

  • Vous avez un contrôle total sur l’emplacement et la façon dont les DLLs sont stockées et référencées dans votre projet. Cela peut être bénéfique si vous préférez une configuration personnalisée ou si vous devez gérer les dépendances manuellement.

• Pas de Dépendance aux Gestionnaires de Paquets :

  • Contrairement à NuGet, vous ne dépendez pas d’un gestionnaire de paquets pour gérer les installations. Cela peut être avantageux dans des environnements où les gestionnaires de paquets ne sont pas disponibles ou préférés.

• Portabilité :

  • L’archive ZIP peut être facilement partagée et déplacée entre différents systèmes, ce qui la rend idéale pour des projets qui doivent être portables ou distribués sans dépendre d’outils externes.

Inconvénients de l’Utilisation de l’Archive ZIP

• Gestion Manuelle :

  • Contrairement à NuGet, où les mises à jour et la gestion des dépendances sont automatisées, avec l’archive ZIP, vous devez gérer manuellement les mises à jour et vous assurer que toutes les DLLs requises sont correctement référencées.

• Risque de Conflits de Versions :

  • Si vous gérez plusieurs projets ou travaillez en équipe, il y a un risque de conflits de versions si différents projets utilisent différentes versions des DLLs. Cela nécessite une attention particulière à la gestion des versions à travers les projets.

• Pas de Mises à Jour Automatiques :

  • Vous ne recevrez pas de mises à jour automatiques ou de notifications lorsqu’une nouvelle version est disponible. Cela peut entraîner le risque d’utiliser des bibliothèques obsolètes à moins que vous ne vérifiiez régulièrement les mises à jour.

Environnement Non-Windows

Travailler avec des DLL .NET Core dans un Environnement Non-Windows

Comme Documentize pour .NET prend en charge .NET Standard 2.0 (.NET Core 2.0), il peut être utilisé dans des applications Core fonctionnant sur des systèmes d’exploitation de type Linux. Nous travaillons constamment à améliorer la prise en charge de .NET Core dans notre API. Cependant, il y a certaines opérations que nous recommandons à nos clients d’effectuer pour obtenir de meilleurs résultats lors de l’utilisation des fonctionnalités de Documentize pour .NET. Veuillez installer :

• le package libgdiplus
• Package avec des polices compatibles Microsoft : ttf-mscorefonts-installer (par exemple, sudo apt-get install ttf-mscorefonts-installer). Ces polices doivent être placées dans le répertoire /usr/share/fonts/truetype/msttcorefonts car Documentize pour .NET scanne ce dossier sur des systèmes d’exploitation de type Linux. Dans le cas où le système d’exploitation dispose d’un autre dossier/répertoire par défaut pour les polices, vous devez utiliser la ligne de code suivante avant d’effectuer toute opération utilisant Documentize :

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<user's path to ms fonts>"));