Installing the ABBYY FineReader Engine Library in Manual Mode
To install the ABBYY FineReader Engine library manually, we recommend creating a package (let us call it a Library Package), which is a folder with the files necessary for ABBYY FineReader Engine functioning.
Note: To simplify creating a custom package, unpack the files using the /extract option for installRnt**.exe in the command line from the distribution package to a certain folder without installation. Inside it, there will be three folders:
- FineReader Engine - with the ABBYY FineReader Engine files
- Inc - with the FREngine.tlb (use it for registering of the FREngine.dll)
- Licensing - with the Licensing Service files
The example of the command line:
installRnt64.exe /extract INSTALLDIR="C:\MyFolder"
- Add to the Library Package on your computer:
- Folder with the ABBYY FineReader Engine files listed in the ABBYY FineReader Engine Distribution Kit section:
- Files marked as "mandatory". They are system modules and main recognition databases.
- Recognition databases for handprinted text, if you want to recognize handprinted text.
- Resource files for interface languages that will be used in your application.
- Dictionary support files for recognition languages that your application will support. If the recognition languages include languages with the Latin alphabet, make sure that you copy the Univers.amd and Univers.amm files.
- Scanning modules, scanning-specific resources and Twain modules if your application will perform scanning via the ABBYY FineReader Engine interface.
- If your application uses the OfficeConverters module (opens input digital documents with the same methods that open the images), copy the files for internal office converter.
- Visual Components modules and corresponding specific resources, if your application uses ABBYY FineReader Engine Visual Components. Register VisualComponentsX.dll using regsvr32.exe.
Note: You can use the FREngineDistribution.csv file and the unpacked FineReader Engine folder to automatically create a list of files required for your application to function. - Other software components:
- KB2999226 update or the Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912. If you are not installing the Windows Update package, you can install the redistributable from the External Components\VC_Redist folder in the distribution package:
- For 32-bit Windows, use vc_redist.x86.exe.
- For 64-bit Windows, use both vc_redist.x86.exe and vc_redist.x64.exe.
- .NET Framework 4.5 or above if you intend to use the OfficeConverters module.
- Copy the Library Package on the workstation.
Important! The easiest way to make sure all resource files can be located by the program is to maintain the same folder structure and include in your distribution package the SharedFiles.ini file you will find in the Bin (or Bin64) folder. If you prefer not to use this file, instead of maintaining the folder structure do the following:
- Copy the Data\Resource folder with all subfolders into Bin (Bin64) folder.
- Copy contents of the Data\ExtendedDictionaries folder directly into Bin (Bin64) folder.
- Copy other files contained in the Data folder into Bin (Bin64) folder.
- Install the necessary software components on the workstation:
- the Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912.
- .NET Framework if it is needed.
- Copy the folder with the ABBYY FineReader Engine files from the Library Package to the directory on the workstation you expected the library to be.
- Create the folders which will be used by ABBYY FineReader Engine. In the list below, the default values for these folders are denoted:
- folder %ProgramData%\ABBYY\SDK\12\FineReader Engine (full control permission is required)
- folder %ProgramData%\ABBYY\SDK\12\Licenses (full control permission is optional)
Note: To specify the license data folder during installation, see an example in Working with the LicensingSettings.xml File. You may also use the InitializeEngine function or method of the IEngineLoader interface.
- Register the dynamic libraries you will need:
- If your application loads the Engine object by means of the IEngineLoader interface, register FREngine.dll using the following command line:
regsvr32 /s /n /i:"<path to the Inc folder>" "<path to FREngine.dll>"
- If your application uses Visual Components, register VisualComponentsX.dll using the following command line:
regsvr32 /s "<path to VisualComponentsX.dll>"
- If your application uses OfficeConverters, register the .NET assembly DcAooConverter.dll using the following command line:
regasm /nologo /tlb /codebase "<path to DcAooConverter.dll>"
After you have installed the required software components and copied all necessary ABBYY FineReader Engine library files, you need to activate the library.
Important! Notes:
- In case you have problems when using COM loaders, working with OfficeConverters or Visual Components, please check the paths to these components in the registry and, if there are errors, repeat the procedure of registration.
- Installing the latest version of ABBYY FineReader Engine over the previous version is not supported. In this case, you have to reinstall ABBYY FineReader Engine.
Uninstalling the Library in Manual Mode
Follow the instructions:
- Unregister the dynamic libraries (FREngine.dll, VisualComponentsX.dll, DcAooConverter.dll) if they were registered during manual installation.
regsvr32.exe /u "<path to FREngine.dll>" regsvr32.exe /u "<path to VisualComponentsX.dll>" regasm /u "<path to DcAooConverter.dll>"
- Remove all files of the ABBYY FineReader Engine library from the workstation.
- Delete the folders used to store ABBYY FineReader Engine data (%ProgramData%\ABBYY\SDK\12\FineReader Engine and %ProgramData%\ABBYY\SDK\12\Licenses by default) or their analogs, if the paths to these folders were changed.
See also
9/17/2024 3:14:40 PM