Building LuaPlus for Windows

Prerequisites

• Download Wget. One location to grab it from is https://eternallybored.org/misc/wget/. Put wget.exe in your PATH.
• Download unzip from http://www.info-zip.org/UnZip.html. Put unzip.exe in your PATH.

For Visual Studio:

• From https://kb.firedaemon.com/support/solutions/articles/4000121705, Download OpenSSL 1.1.1e and extract it to c:\openssl-1.1 so that c:\openssl-1.1\x64\include exists.

Build LuaPlus

• If you haven't already, clone LuaPlus from GitHub with:

d:\>git clone https://github.com/jjensen/luaplus51-all.git luaplus

• Bootstrap the JamPlus build tool by launching x64 Native Tools Command Prompt for whichever version of Visual Studio you are using and running:

  • BootstrapJamPlus-win64.bat

• Close the x64 Native Tools Command Prompt.

• To create a workspace, run one of the following batch files.

  • CreateVS2019Workspace.bat - Create a Visual Studio 2019-capable workspace.
  • CreateVS2017Workspace.bat - Create a Visual Studio 2017-capable workspace.

• Choose the version of Lua to build within the workspace. Note that the -luaplus versions build additional LuaPlus-specific features into the Lua environment; these are the preferred environments for LuaPlus.

• If you want lua-curl support, run the following (where build201x is your own build directory):

d:\luaplus\build201x>jam download:curl

• If you want the PCRE module to build, run the following (where build201x is your own build directory):

d:\luaplus\Src\modules.jambuild>getpcre.bat

If you want to build from an IDE:

• Within Visual Studio, navigate to build201x\_workspace_\vs201x\ (replace the vs201x with the IDE version your are building for) and open LuaPlus.sln.
• Build the solution.

If you want to build from the command-line, use:

rem Builds to d:\luaplus\build201x\bin.lua5x-luaplus.vs20xx.win64
d:\luaplus\build201x>jam c.toolchain=win64/release

rem Builds to d:\luaplus\build201x\bin.lua5x-luaplus.vs20xx.win64
d:\luaplus\build201x>jam c.toolchain=win64/debug

rem Builds to d:\luaplus\build201x\bin.lua5x-luaplus.vs20xx.win32
d:\luaplus\build201x>jam c.toolchain=win32/release

rem Builds to d:\luaplus\build201x\bin.lua5x-luaplus.vs20xx.win32
d:\luaplus\build201x>jam c.toolchain=win32/debug

Building LuaPlus for Mac

Prerequisites

• FILL ME IN.

Build LuaPlus

• If you haven't already, clone LuaPlus from GitHub with:

[~]git clone https://github.com/jjensen/luaplus51-all.git luaplus

• Bootstrap the JamPlus build tool by running:

  • BootstrapJamPlus-macosx64

• To create an Xcode workspace, run ~/luaplus/CreateJamXcodeWorkspace.sh.

• Choose the version of Lua to build within the workspace. Note that the -luaplus versions build additional LuaPlus-specific features into the Lua environment; these are the preferred environments for LuaPlus.

• If you want lua-curl support, run the following:

FILL ME IN

• If you want the PCRE module to build, run the following:

FILL ME IN

If you want to build from an IDE:

• Open ~/luaplus/.build/_workspace_/xcode/LuaPlus.xcworkspace.
• Change the active scheme to !BuildWorkspace-macosx64-release.
• Build.

If you want to build from the command-line, use:

# Builds to ~/luaplus/.build/bin.lua5x-luaplus.clang.macosx64
[~/luaplus/.build]./jam c.toolchain=macosx64/release

Building LuaPlus for Linux

Prerequisites

As an example, a fresh install of Ubuntu 17.10 will require the following packages.

sudo apt install git build-essential libreadline-dev uuid-dev libssl-dev libcurl4-openssl-dev

Build LuaPlus

• If you haven't already, clone LuaPlus from GitHub with:

[~]git clone https://github.com/jjensen/luaplus51-all.git luaplus

• Bootstrap the JamPlus build tool by running:

  • BootstrapJamPlus-linux64

• To create a build environment, run ~/luaplus/CreateJamLinuxWorkspace.sh.

• Choose the version of Lua to build within the workspace. Note that the -luaplus versions build additional LuaPlus-specific features into the Lua environment; these are the preferred environments for LuaPlus.

• If you want lua-curl support, run the following for Ubuntu (or the equivalent for your Linux):

sudo apt install libcurl4-openssl-dev

• If you want the PCRE module to build, run the following:

FILL ME IN

To build from the command-line, use:

# Builds to ~/luaplus/.build/bin.lua5x-luaplus.gcc.linux64
[~/luaplus/.build]./jam

# or this:

[~/luaplus/.build]./jam c.toolchain=linux64/release