blob: 6547c4d42900d85622238dc68dcb9caa02253d96 [file] [log] [blame]
John Boyercd425392011-06-24 14:47:12 +00001This file describes how to build liblouis.dll That is the only binary
2file needed by someone who wishes to use liblouis in an application. The
3tables are in the tables subdirectory of the liblouis distribution. For
4an overview of liblouis see README.
5
6First, obtain the liblouis source, either by downloading the latest
Davy Kagerd5cb0472017-04-25 16:55:38 +02007tarball or from the Git repository. See HACKING for instructions.
John Boyercd425392011-06-24 14:47:12 +00008If you downloaded the tarball, unpack it.
9
John Boyerab517de2011-06-24 15:06:44 +000010To build liblouis.dll you will need the Microsoft command-line C/C++
Davy Kagerd5cb0472017-04-25 16:55:38 +020011tools. You will also have to set environment variables correctly. You
12can download the Community version of Microsoft Visual Studio, including
13Visual C++, and the Microsoft Windows SDK for free. It has a batch file
14that sets environment variables and then displays a command prompt.
Christian Egli6f290162018-06-28 13:35:20 +020015
16You might have to add the Visual Studio path
moyanming201301d505d2018-06-28 17:55:57 +080017(C:\Program Files (x86)\Microsoft Visual Studio\2017\Community) to the
18"Path" of the environment variables manually.
John Boyerab517de2011-06-24 15:06:44 +000019
Davy Kagerd5cb0472017-04-25 16:55:38 +020020Next, go to the subdirectory windows. Edit the file configure.mk. If you
21want 32-bit Unicode change the 2 in the line UCS=2 to a 4.
John Boyercd425392011-06-24 14:47:12 +000022
Christian Egli6f290162018-06-28 13:35:20 +020023Open the "VS 2017 Developer Command Prompt" from the Start menu and use the
24"cd" command goto the "\liblouis-x.x.x\windows" folder, then type:
25
John Boyercd425392011-06-24 14:47:12 +000026nmake /f Makefile.nmake
27
vsmontalvaocb154512016-10-03 12:29:33 -070028The directory will contain liblouis.dll and liblouis.lib, along with
Christian Egli6f290162018-06-28 13:35:20 +020029object files. Note that those liblouis.dll and liblouis.lib only are for
moyanming201301d505d2018-06-28 17:55:57 +08003032-bit usage.