Cette section fournit des guides pour installer manuellement votre application sur un poste de travail local.Documentation Index
Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
Use this file to discover all available pages before exploring further.
L’installation manuelle en mode autonome n’est possible que si vous utilisez Software ou la protection en ligne.
Protection en ligne
Protection en ligne
Dans ce scénario, vous déployez votre application sur une instance cloud, une machine virtuelle privée ou un poste de travail local, à l’aide d’un programme d’installation de votre choix, d’un script shell ou en copiant manuellement les fichiers. Vous aurez besoin de :Nous recommandons de créer un package ABBYY FineReader Engine (que nous appellerons Package), c’est-à-dire un dossier contenant les fichiers nécessaires au fonctionnement et à la gestion de licence d’ABBYY FineReader Engine.Création des dossiers qui seront utilisés par ABBYY FineReader Engine :Dans la liste ci-dessous, les valeurs par défaut de ces dossiers sont indiquées :Spécifiez la balise OnlineLicensing uniquement en cas d’utilisation d’une licence en ligne avec un serveur proxy (dans les autres cas, ne spécifiez pas cette balise) et laissez les autres paramètres par défaut (ne les incluez pas dans votre fichier). Le schéma XML auquel il doit se conformer se trouve dans le fichier LicensingSettings.xsd, situé dans le dossier Inc de votre installation développeur ou dans le dossier CADF\Inc du package de distribution.Copiez le jeton de licence dans un dossier par défaut sur chaque poste de travail ou dans un dossier dont le chemin est utilisé par votre application dans la fonction InitializeEngine.
- un fichier de jeton d’une licence en ligne (nommé par exemple SWRTXXXXXXXXXXXXXXXXXXXX.ABBYY.ActivationToken).
Une connexion à Internet est requise lorsque l’application est en cours d’exécution.
Pour simplifier la création d’un package personnalisé, extrayez les fichiers à l’aide de l’option /extract pour installRnt**.exe ou installLS.exe en ligne de commande depuis le package de distribution vers un dossier donné, sans lancer l’installation. Il contiendra les dossiers suivants :
-
pour installRnt**.exe :
- FineReader Engine - avec les fichiers d’ABBYY FineReader Engine
- Inc - avec le fichier FREngine.tlb (pour l’enregistrement de FREngine.dll)
- Licensing - avec les fichiers du service de licence
-
pour installLS.exe :
- Licensing - avec les fichiers du service de licence
- License Server - avec les fichiers de License Server
Ajout au package sur votre ordinateur :
-
Package de la bibliothèque. Il s’agit d’un dossier contenant les fichiers d’ABBYY FineReader Engine répertoriés dans la section ABBYY FineReader Engine Distribution Kit de l’Aide du développeur. La liste comprendra :
- Fichiers marqués comme “obligatoires” dans ABBYY FineReader Engine Distribution Kit. Il s’agit des modules système et des principales bases de données de reconnaissance.
- Bases de données de reconnaissance pour le texte écrit en lettres moulées, si vous souhaitez reconnaître ce type de texte.
- Fichiers de ressources pour les langues d’interface qui seront utilisées dans votre application.
- Fichiers de support des dictionnaires pour les langues de reconnaissance prises en charge par votre application. Si ces langues incluent des langues utilisant l’alphabet latin, veillez à sélectionner les fichiers Univers.amd et Univers.amm.
- Modules de numérisation, ressources propres à la numérisation et modules Twain si votre application effectue la numérisation via l’interface ABBYY FineReader Engine.
- Modules des composants visuels Windows et ressources spécifiques correspondantes, si votre application utilise les composants visuels ABBYY FineReader Engine.
-
Package License Server. Il comprend deux dossiers contenant les fichiers du service de licence et de l’utilitaire License Manager :
- Dossier service de licence contenant tous les fichiers copiés depuis le dossier Licensing décompressé.
- Dossier License Manager (License Manager64) contenant les fichiers suivants copiés depuis le dossier License Server décompressé : AbbyyZlib.dll, Awl.dll, concrt140.dll, FineFormats.dll, FineNet.dll, FineObj.dll, LicenseManager.exe, LicenseManager12.chm, LicensingSchema.xe, msvcp140.dll, ProductLicensingSchema.xe, Protection.dll, ProtectionRes0.dll, ProtectionResShared.dll, ProtectionUI.dll, vccorlib140.dll, vcruntime140.dll.
-
Autres composants logiciels :
- La mise à jour KB2999226 ou Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912. Si vous n’installez pas le package Windows Update, vous pouvez installer le redistribuable à partir du dossier External Components\VC_Redist du package de distribution : vc_redist.x86.exe et vc_redist.x64.exe.
- .NET Framework 4.6.2 si vous prévoyez d’utiliser le module OfficeConverters.
Copie du package sur le poste de travail :
Le moyen le plus simple de s’assurer que le programme peut localiser tous les fichiers de ressources consiste à conserver la même structure de dossiers et à inclure dans votre package de distribution le fichier SharedFiles.ini que vous trouverez dans le dossier Bin (or Bin64), selon votre système d’exploitation. Si vous préférez ne pas utiliser ce fichier, au lieu de conserver la structure de dossiers, procédez comme suit :
- Copiez le dossier Data\Resource avec tous ses sous-dossiers dans le dossier suivant :
- Bin
- Bin64
- Copiez le contenu du dossier Data\ExtendedDictionaries directement dans le dossier Bin ou Bin64.
- Copiez les autres fichiers du dossier Data dans le dossier Bin ou Bin64.
Installation des composants logiciels nécessaires :
- Le redistribuable Microsoft Visual C++ 2015-2019 14.28.29912.
- .NET Framework si nécessaire.
Enregistrement des bibliothèques dynamiques :
- Si votre application charge l’objet Engine via l’interface IEngineLoader, enregistrez FREngine.dll à l’aide de la ligne de commande suivante :
- Si votre application utilise les composants visuels, enregistrez VisualComponentsX.dll à l’aide de la ligne de commande suivante :
- dossier %ProgramData%\ABBYY\SDK\12\FineReader Engine (des droits de contrôle total sont requis)
- dossier %ProgramData%\ABBYY\SDK\12\Licenses (une autorisation de contrôle total est requise pour le serveur de licences, facultative pour les postes de travail)
Pour spécifier le dossier des données de licence lors de l’installation, reportez-vous à l’exemple présenté dans Utilisation du fichier LicensingSettings.xml. Vous pouvez également utiliser la fonction InitializeEngine ou la méthode de l’interface IEngineLoader.
Installation du License Server :
- Copiez les dossiers du package License Server dans le répertoire du poste de travail destiné à héberger le License Server.
Nous vous recommandons d’organiser les fichiers ABBYY FineReader Engine dans une arborescence de dossiers facile à retrouver et à utiliser. Voir l’exemple ci-dessous :
- <YourApplicationFolder>/ABBYY FineReader Engine Library.
- <YourApplicationFolder>/License Server/service de licence.
- <YourApplicationFolder>/License Server/License Manager (License Manager64).
- Créez ou sélectionnez un dossier dans lequel votre application recherche le fichier de jeton de licence, puis placez-y le fichier de jeton. Vous pouvez choisir %ProgramData%\ABBYY\SDK\12\Licenses, qui est le comportement par défaut, ou un autre dossier servant à stocker les données de licence. Le groupe Tout le monde doit disposer d’autorisations de contrôle total sur ces dossiers.
- Créez un fichier LicensingSettings.xml contenant le contenu indiqué ci-dessous. Consultez Utilisation du fichier LicensingSettings.xml pour plus de détails
-
Copiez le fichier LicensingSettings.xml configuré dans les dossiers suivants :
- service de licence.
- License Manager (License Manager64).
- Dossier contenant les fichiers d’ABBYY FineReader Engine, à côté de FREngine.dll.
- Lancez LicensingService.exe avec le paramètre “/install” :
Activation de la licence :
Une licence en ligne ne nécessite pas d’activation : les informations de licence sont reçues au moment de l’exécution de l’application depuis les services de licence en ligne ABBYY. Pour s’authentifier, l’application envoie un fichier de jeton de licence et un mot de passe de licence. Vous devez placer le fichier de jeton à l’emplacement attendu par l’application. Cet emplacement doit être spécifié par le développeur (la valeur par défaut est %ProgramData%\ABBYY\SDK\12\Licenses).Au moment de l’exécution, l’application doit se connecter périodiquement aux services de licence en ligne ABBYY pour recevoir les informations de licence et envoyer des statistiques d’utilisation. Aucune information privée n’est échangée avec les serveurs ABBYY.- Vérifiez que vous autorisez les connexions à *.abbyy.com sur le port 443 (HTTPS). Si la connexion est interrompue, l’application cessera de fonctionner une fois le délai de reconnexion dépassé. La période de synchronisation et le délai de reconnexion sont des paramètres spécifiques de chaque licence en ligne.
Il n’est pas possible d’utiliser simultanément deux licences en ligne ou davantage sur le même hôte. Lorsque l’application est en cours d’exécution et que la connexion aux services de licence ABBYY fonctionne, vous pouvez afficher les détails de la licence en ligne actuellement active à l’aide de l’Utilitaire du gestionnaire de licences.
Protection logicielle
Protection logicielle
Dans ce scénario, vous installez manuellement votre application utilisant la bibliothèque ABBYY FineReader Engine sur un poste de travail local. Vous aurez besoin de :
- le numéro de série d’une licence Runtime autonome.
Pour simplifier la création d’un package personnalisé, extrayez les fichiers à l’aide de l’option /extract pour installRnt**.exe ou installLS.exe en ligne de commande depuis le package de distribution vers un dossier donné, sans lancer l’installation. Il contiendra les dossiers suivants :
-
pour installRnt**.exe :
- FineReader Engine - avec les fichiers d’ABBYY FineReader Engine
- Inc - avec le fichier FREngine.tlb (pour l’enregistrement de FREngine.dll)
- Licensing - avec les fichiers du service de licence
-
pour installLS.exe :
- Licensing - avec les fichiers du service de licence
- License Server - avec les fichiers de License Server
Ajout au package sur votre ordinateur :
-
Package de la bibliothèque. Il s’agit d’un dossier contenant les fichiers d’ABBYY FineReader Engine répertoriés dans la section ABBYY FineReader Engine Distribution Kit de l’Aide du développeur. La liste comprendra :
- Fichiers marqués comme “obligatoires” dans ABBYY FineReader Engine Distribution Kit. Il s’agit des modules système et des principales bases de données de reconnaissance.
- Bases de données de reconnaissance pour le texte écrit en lettres moulées, si vous souhaitez reconnaître ce type de texte.
- Fichiers de ressources pour les langues d’interface qui seront utilisées dans votre application.
- Fichiers de support des dictionnaires pour les langues de reconnaissance prises en charge par votre application. Si ces langues incluent des langues utilisant l’alphabet latin, veillez à sélectionner les fichiers Univers.amd et Univers.amm.
- Modules de numérisation, ressources propres à la numérisation et modules Twain si votre application effectue la numérisation via l’interface ABBYY FineReader Engine.
- Modules des composants visuels Windows et ressources spécifiques correspondantes, si votre application utilise les composants visuels ABBYY FineReader Engine.
-
Package License Server. Il comprend deux dossiers contenant les fichiers du service de licence et de l’utilitaire License Manager :
- Dossier service de licence contenant tous les fichiers copiés depuis le dossier Licensing décompressé.
- Dossier License Manager (License Manager64) contenant les fichiers suivants copiés depuis le dossier License Server décompressé : AbbyyZlib.dll, Awl.dll, concrt140.dll, FineFormats.dll, FineNet.dll, FineObj.dll, LicenseManager.exe, LicenseManager12.chm, LicensingSchema.xe, msvcp140.dll, ProductLicensingSchema.xe, Protection.dll, ProtectionRes0.dll, ProtectionResShared.dll, ProtectionUI.dll, vccorlib140.dll, vcruntime140.dll.
-
Autres composants logiciels :
- La mise à jour KB2999226 ou Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912. Si vous n’installez pas le package Windows Update, vous pouvez installer le redistribuable à partir du dossier External Components\VC_Redist du package de distribution : vc_redist.x86.exe et vc_redist.x64.exe.
- .NET Framework 4.6.2 si vous prévoyez d’utiliser le module OfficeConverters.
Copie du package sur le poste de travail :
Le moyen le plus simple de s’assurer que le programme peut localiser tous les fichiers de ressources consiste à conserver la même structure de dossiers et à inclure dans votre package de distribution le fichier SharedFiles.ini que vous trouverez dans le dossier Bin (or Bin64), selon votre système d’exploitation. Si vous préférez ne pas utiliser ce fichier, au lieu de conserver la structure de dossiers, procédez comme suit :
- Copiez le dossier Data\Resource avec tous ses sous-dossiers dans le dossier suivant :
- Bin
- Bin64
- Copiez le contenu du dossier Data\ExtendedDictionaries directement dans le dossier Bin ou Bin64.
- Copiez les autres fichiers du dossier Data dans le dossier Bin ou Bin64.
Installation des composants logiciels nécessaires :
- Le redistribuable Microsoft Visual C++ 2015-2019 14.28.29912.
- .NET Framework si nécessaire.
Enregistrement des bibliothèques dynamiques :
- Si votre application charge l’objet Engine via l’interface IEngineLoader, enregistrez FREngine.dll à l’aide de la ligne de commande suivante :
- Si votre application utilise les composants visuels, enregistrez VisualComponentsX.dll à l’aide de la ligne de commande suivante :
Création des dossiers qui seront utilisés par ABBYY FineReader Engine :
Dans la liste ci-dessous, les valeurs par défaut de ces dossiers sont indiquées :- dossier %ProgramData%\ABBYY\SDK\12\FineReader Engine (des droits de contrôle total sont requis)
- dossier %ProgramData%\ABBYY\SDK\12\Licenses (une autorisation de contrôle total est requise pour le serveur de licences, facultative pour les postes de travail)
Pour spécifier le dossier des données de licence lors de l’installation, reportez-vous à l’exemple présenté dans Utilisation du fichier LicensingSettings.xml. Vous pouvez également utiliser la fonction InitializeEngine ou la méthode de l’interface IEngineLoader.
Installation du License Server
- Copiez les dossiers du package License Server dans le répertoire du poste de travail destiné à héberger le License Server.
Nous vous recommandons d’organiser les fichiers ABBYY FineReader Engine dans une arborescence de dossiers facile à retrouver et à utiliser. Voir l’exemple ci-dessous :
- <YourApplicationFolder>/ABBYY FineReader Engine Library.
- <YourApplicationFolder>/License Server/service de licence.
- <YourApplicationFolder>/License Server/License Manager (License Manager64).
- Créez un fichier LicensingSettings.xml et spécifiez les paramètres dans la balise LocalLicenseServer si nécessaire. Le schéma XML auquel il doit se conformer se trouve dans le fichier LicensingSettings.xsd, situé dans le dossier Inc de votre installation développeur ou dans le dossier CADF\Inc du package de distribution. Consultez Utilisation du fichier LicensingSettings.xml pour plus de détails
-
Copiez le fichier LicensingSettings.xml configuré dans les dossiers suivants :
- service de licence.
- License Manager (License Manager64).
- Dossier contenant les fichiers d’ABBYY FineReader Engine, à côté de FREngine.dll.
- Lancez LicensingService.exe avec le paramètre “/install” :
