Installation

Installation du SDK Documentize

Documentize peut être installé de plusieurs manières, chacune adaptée à différents environnements de développement et préférences. Voici les méthodes recommandées pour installer Documentize :

1. NuGet (Méthode préférée)

NuGet est la méthode la plus simple et la plus recommandée pour installer Documentize, vous assurant d’avoir toujours la dernière version et les mises à jour directement dans votre environnement de développement. Consultez plus de détails sur cette méthode d’installation à l’adresse Comment installer les SDK Documentize avec NuGet.

2. Installateur MSI

L’installateur MSI est une option pratique si vous souhaitez que les DLL de Documentize soient installées directement sur votre système. Cette méthode est idéale pour les développeurs qui veulent utiliser Documentize dans plusieurs projets sans devoir gérer manuellement les fichiers DLL. Consultez plus de détails sur cette méthode d’installation à l’adresse Comment installer les SDK Documentize avec MSI.

3. Archive ZIP

Pour les développeurs qui préfèrent une approche manuelle, l’archive ZIP contient les DLL de Documentize, qui peuvent être extraites et ajoutées directement à votre projet. Consultez plus de détails sur cette méthode d’installation à l’adresse Comment installer les SDK Documentize avec ZIP.

3 nov. 2026

Sous-sections de Installation

Installing Documentize via NuGet

Astuce

NuGet est un gestionnaire de packages gratuit et open source pour .NET qui simplifie l’ajout, la suppression et la mise à jour des bibliothèques dans les projets Visual Studio. Il gère automatiquement les fichiers de bibliothèque, les références et les modifications de configuration.

Comment installer via la console du Gestionnaire de packages NuGet

  1. Ouvrez votre projet :

    • Lancez Visual Studio et ouvrez votre application .NET.
  2. Accédez à la console du Gestionnaire de packages :

    • Naviguez vers Outils > Gestionnaire de packages NuGet > Console du Gestionnaire de packages.
  3. Installez le package :

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

Comment mettre à jour le package via la console du Gestionnaire de packages NuGet

Si vous avez déjà installé Documentize via NuGet et que vous souhaitez le 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 packages :

    • Naviguez vers Outils > Gestionnaire de packages NuGet > Console du Gestionnaire de packages.
  3. Mettez à jour le package :

    • Pour mettre à jour vers la dernière version complète, saisissez Update-Package Documentize.
    • Pour mettre à jour vers la dernière version incluant 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 packages NuGet

  1. Ouvrez votre projet :

    • Lancez Visual Studio et ouvrez votre application .NET.
  2. Accédez à Gérer les packages NuGet :

    • Dans le menu Projet, sélectionnez Gérer les packages NuGet.
  3. Recherchez Documentize :

    • Allez dans l’onglet Parcourir et saisissez Documentize dans la zone de recherche.
  4. Installez le package :

    • Cliquez sur Installer/Mettre à 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 :

    • Mettre à jour les packages est simple avec NuGet, que ce soit via la console du Gestionnaire de packages ou l’interface graphique. Cela facilite le maintien de vos bibliothèques à jour avec les dernières fonctionnalités et corrections de bugs.
  • Intégré à Visual Studio :

    • NuGet est parfaitement intégré à Visual Studio, offrant une interface conviviale pour gérer les packages 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 à des versions antérieures 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 être utilisé dans Visual Studio. Bien qu’il puisse être utilisé dans d’autres environnements, l’intégration est la plus robuste dans Visual Studio.
  • Risques de conflits de version :

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

    • L’installation et la mise à jour des packages nécessitent une connexion Internet. Si vous travaillez dans un environnement avec un accès Internet limité ou inexistant, vous devrez recourir à des méthodes hors ligne ou pré‑télécharger les packages.
  • Complexité pour les gros projets :

    • Pour des projets très volumineux avec des arbres de dépendances étendus, la surcharge de gestion des packages via NuGet peut devenir fastidieuse. Dans ce 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

Astuce

L’installateur MSI est une option pratique et conviviale pour installer Documentize, notamment si vous préférez que les DLL soient installées à l’échelle du système. Cette méthode simplifie le processus d’installation en automatisant de nombreuses étapes.

Comment installer via l’installateur MSI

  1. Télécharger l’installateur MSI :

    • Cliquez sur le v26.11 MSI pour télécharger l’installateur MSI de la dernière version de Documentize.
  2. Exécuter l’installateur :

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

    • Suivez les instructions affichées à l’écran. Vous devrez peut‑être accepter le contrat de licence et sélectionner les options d’installation.
  4. Terminer 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 dans un autre emplacement spécifié.
  5. Vérifier l’installation :

    • Vérifiez que les DLL sont correctement installées en confirmant leur présence dans le répertoire d’installation désigné ou dans 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 à l’échelle du système :

    • La méthode MSI installe Documentize dans le Global Assembly Cache (GAC) du système ou dans un autre emplacement central. Cela permet à toute application du système d’accéder aux DLL sans devoir les référencer individuellement dans chaque projet.
  • Mises à jour automatisées :

    • Si Documentize propose 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 de manière fluide.
  • Cohérence :

    • L’utilisation de l’installateur MSI garantit que tous les fichiers requis sont installés correctement et de façon consistante sur 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 système, ce qui peut ne pas convenir à tous les environnements de développement. Il peut manquer de souplesse pour gérer des configurations ou des versions spécifiques à un projet.
  • Surcharge potentielle :

    • Installer des DLL dans le GAC peut introduire une surcharge et une complexité, notamment dans les scénarios où plusieurs versions de Documentize pourraient être nécessaires simultanément.
  • Désinstallation manuelle :

    • Si vous devez désinstaller Documentize, vous devez utiliser le programme de désinstallation fourni par le MSI, qui peut laisser des fichiers ou des configurations résiduelles s’il n’est pas géré correctement.
  • Conflits de version :

    • Les installations à l’échelle du système peuvent entraîner des conflits de version si différents projets nécessitent des versions différentes de Documentize. La gestion de ces conflits peut nécessiter des configurations ou un nettoyage supplémentaires.

Installation de Documentize via ZIP

Astuce

L’archive ZIP est idéale pour les développeurs qui préfèrent une approche manuelle de la gestion des bibliothèques. Cette méthode vous permet de télécharger et d’extraire directement les fichiers DLL nécessaires sans dépendre d’un gestionnaire de paquets ou d’un installateur.

Comment installer via une archive ZIP

  1. Télécharger l’archive ZIP :

    • Cliquez sur le v26.11 ZIP pour télécharger la dernière version de Documentize au format archive.
  2. Extraire le contenu :

    • Après le téléchargement, extrayez le contenu du fichier ZIP dans le répertoire de votre choix. Vous pouvez choisir de conserver ces fichiers dans un répertoire partagé ou au sein de la structure de votre projet.
  3. Ajouter les références à votre projet :

    • Ouvrez votre projet dans votre IDE (par ex., Visual Studio).
    • Allez dans Project > Add Reference > Browse et naviguez jusqu’au répertoire où vous avez extrait les DLL.
    • 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 les anciennes DLL dans votre projet par les nouvelles.

Avantages de l’utilisation de l’archive ZIP

  • Contrôle total :

    • Vous avez un contrôle complet sur l’endroit où les DLL sont stockées et la façon dont elles sont référencées dans votre projet. Cela peut être bénéfique si vous privilégiez une configuration personnalisée ou 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 effectuer les installations. Cela peut être avantageux dans des environnements où les gestionnaires de paquets ne sont pas disponibles ou souhaité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 les projets qui doivent être portables ou distribués sans recourir à des 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 DLL requises sont correctement référencées.
  • Risque de conflits de version :

    • Si vous gérez plusieurs projets ou travaillez en équipe, il existe un risque de conflits de version si différents projets utilisent des versions différentes des DLL. Cela nécessite un suivi minutieux des versions à travers les projets.
  • Pas de mises à jour automatiques :

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

Environnement non Windows

Travailler avec les DLL .NET Core dans un environnement non Windows

Comme Documentize for .NET fournit la prise en charge de .NET Standard 2.0 (.NET Core 2.0), il peut être utilisé dans des applications Core s’exécutant sur des systèmes d’exploitation de type Linux. Nous travaillons constamment à améliorer le support de .NET Core dans notre API. Cependant, certaines opérations sont recommandées à nos clients afin d’obtenir de meilleurs résultats lors de l’utilisation des fonctionnalités de Documentize for .NET. Veuillez installer :

  • paquet libgdiplus
  • Paquet contenant des polices compatibles Microsoft : ttf‑mscorefonts‑installer (par ex., sudo apt-get install ttf-mscorefonts-installer). Ces polices doivent être placées dans le répertoire /usr/share/fonts/truetype/msttcorefonts car Documentize for .NET analyse ce dossier sur les systèmes d’exploitation de type Linux. Si le système d’exploitation utilise un autre répertoire par défaut pour les polices, vous devez ajouter la ligne de code suivante avant d’exécuter toute opération utilisant Documentize :
Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<chemin de l'utilisateur vers les polices ms>"));
 Français