Annotation of embedaddon/libiconv/INSTALL.windows, revision 1.1
1.1 ! misho 1: Installation on Microsoft Windows:
! 2:
! 3: There are three ways to create binaries of this package for Microsoft Windows:
! 4: 1) Native binaries, built using the mingw tool chain.
! 5: 2) Native binaries, built using the MS Visual C/C++ tool chain.
! 6: 3) Binaries for the Cygwin environment.
! 7:
! 8: ===============================================================================
! 9: 1) Native binaries, built using the mingw tool chain.
! 10:
! 11: I recommend to use the Cygwin environment as the development environment
! 12: and mingw only as the target (runtime, deployment) environment.
! 13: For this, you need to install
! 14: * Cygwin (from https://cygwin.com/),
! 15: * some packages available from the Cygwin package installer:
! 16: make
! 17: * the mingw cross-compilation tools and runtime package, available from
! 18: the Cygwin package installer (setup-x86_64.exe):
! 19: - for creating 32-bit binaries: packages
! 20: mingw64-i686-gcc-core,
! 21: mingw64-i686-headers,
! 22: mingw64-i686-runtime
! 23: - for creating 64-bit binaries: packages
! 24: mingw64-x86_64-gcc-core,
! 25: mingw64-x86_64-headers,
! 26: mingw64-x86_64-runtime
! 27:
! 28: Building 32-bit binaries for mingw is achieved through the following
! 29: preparation, configure, and build commands:
! 30:
! 31: PATH=/usr/local/mingw32/bin:$PATH
! 32: export PATH
! 33: ./configure --host=i686-w64-mingw32 --prefix=/usr/local/mingw32 \
! 34: CC=i686-w64-mingw32-gcc \
! 35: CPPFLAGS="-I/usr/local/mingw32/include -Wall" \
! 36: LDFLAGS="-L/usr/local/mingw32/lib"
! 37: make
! 38: make check
! 39:
! 40: Building 64-bit binaries for mingw is achieved through the following
! 41: preparation, configure, and build commands:
! 42:
! 43: PATH=/usr/local/mingw64/bin:$PATH
! 44: export PATH
! 45: ./configure --host=x86_64-w64-mingw32 --prefix=/usr/local/mingw64 \
! 46: CC=x86_64-w64-mingw32-gcc \
! 47: CPPFLAGS="-I/usr/local/mingw64/include -Wall" \
! 48: LDFLAGS="-L/usr/local/mingw64/lib"
! 49: make
! 50: make check
! 51:
! 52: Installation:
! 53:
! 54: make install
! 55:
! 56: ===============================================================================
! 57: 2) Native binaries, built using the MS Visual C/C++ tool chain.
! 58:
! 59: Note that binaries created with MSVC have a distribution constraint: They
! 60: depend on a closed-source library ('msvcr90.dll' for MSVC 9.0,
! 61: 'vcruntime140.dll' for MSVC 14.0, and so on) which is not normally part of
! 62: a Windows installation.
! 63: You cannot distribute 'vcruntime*.dll' with the binaries - this would be a
! 64: violation of the GPL and of the Microsoft EULA.
! 65: You can distribute the binaries without including 'vcruntime*.dll'. Users
! 66: who don't have this library on their system will require to pull some files
! 67: (api-ms-win*.dll) through the Windows Update mechanism, see
! 68: https://support.microsoft.com/en-us/kb/2999226 .
! 69:
! 70: This recipe requires MS Visual C/C++ 9.0 or newer.
! 71: You don't need the Visual Studio IDE, just the C/C++ tool chain.
! 72: As of 2016, you can install the MS Visual C/C++ 14.0 tool chain from
! 73: http://landinghub.visualstudio.com/visual-cpp-build-tools (it's the file
! 74: visualcppbuildtools_full.exe).
! 75:
! 76: This recipe requires also a Cygwin environment (with 'bash', the common POSIX
! 77: commands, and 'make') as a build environment. Building with 'nmake' is not
! 78: supported.
! 79: For this, you need to install
! 80: * Cygwin (from https://cygwin.com/),
! 81: * some packages available from the Cygwin package installer:
! 82: make
! 83:
! 84: You also need the scripts 'ar-lib' and 'compile' from
! 85: https://git.savannah.gnu.org/gitweb/?p=automake.git;a=blob_plain;f=lib/ar-lib;hb=HEAD
! 86: https://git.savannah.gnu.org/gitweb/?p=automake.git;a=blob_plain;f=lib/compile;hb=HEAD
! 87: respectively.
! 88: They may also be included in this package, in directory 'build-aux/'.
! 89: Save them; the instructions below assume that you stored them in $HOME/msvc/.
! 90: Make them executable:
! 91: chmod a+x ar-lib compile
! 92:
! 93: Start a bash (from Cygwin).
! 94:
! 95: Make sure that the MSVC tools ("cl" etc.) are found in PATH and the
! 96: environment variables INCLUDE and LIB are set appropriately.
! 97: In a typical MSVC 9.0 installation, it can be achieved by running
! 98: C:\Program Files\Microsoft Visual Studio 9.0\Common7\Tools\vsvars32.bat
! 99: In a typical MSVC 14.0 installation on Windows 10, it can be achieved
! 100: - for creating 32-bit binaries: through the following bash commands:
! 101:
! 102: # Set environment variables for using MSVC 14,
! 103: # for creating native 32-bit Windows executables.
! 104:
! 105: # Windows C library headers and libraries.
! 106: WindowsCrtIncludeDir='C:\Program Files (x86)\Windows Kits\10\Include\10.0.10240.0\ucrt'
! 107: WindowsCrtLibDir='C:\Program Files (x86)\Windows Kits\10\Lib\10.0.10240.0\ucrt\'
! 108: INCLUDE="${WindowsCrtIncludeDir};$INCLUDE"
! 109: LIB="${WindowsCrtLibDir}x86;$LIB"
! 110:
! 111: # Windows API headers and libraries.
! 112: WindowsSdkIncludeDir='C:\Program Files (x86)\Windows Kits\8.1\Include\'
! 113: WindowsSdkLibDir='C:\Program Files (x86)\Windows Kits\8.1\Lib\winv6.3\um\'
! 114: INCLUDE="${WindowsSdkIncludeDir}um;${WindowsSdkIncludeDir}shared;$INCLUDE"
! 115: LIB="${WindowsSdkLibDir}x86;$LIB"
! 116:
! 117: # Visual C++ tools, headers and libraries.
! 118: VSINSTALLDIR='C:\Program Files (x86)\Microsoft Visual Studio 14.0'
! 119: VCINSTALLDIR="${VSINSTALLDIR}"'\VC'
! 120: PATH=`cygpath -u "${VCINSTALLDIR}"`/bin:"$PATH"
! 121: INCLUDE="${VCINSTALLDIR}"'\include;'"${INCLUDE}"
! 122: LIB="${VCINSTALLDIR}"'\lib;'"${LIB}"
! 123:
! 124: export INCLUDE LIB
! 125:
! 126: - for creating 64-bit binaries: through the following bash commands:
! 127:
! 128: # Set environment variables for using MSVC 14,
! 129: # for creating native 64-bit Windows executables.
! 130:
! 131: # Windows C library headers and libraries.
! 132: WindowsCrtIncludeDir='C:\Program Files (x86)\Windows Kits\10\Include\10.0.10240.0\ucrt'
! 133: WindowsCrtLibDir='C:\Program Files (x86)\Windows Kits\10\Lib\10.0.10240.0\ucrt\'
! 134: INCLUDE="${WindowsCrtIncludeDir};$INCLUDE"
! 135: LIB="${WindowsCrtLibDir}x64;$LIB"
! 136:
! 137: # Windows API headers and libraries.
! 138: WindowsSdkIncludeDir='C:\Program Files (x86)\Windows Kits\8.1\Include\'
! 139: WindowsSdkLibDir='C:\Program Files (x86)\Windows Kits\8.1\Lib\winv6.3\um\'
! 140: INCLUDE="${WindowsSdkIncludeDir}um;${WindowsSdkIncludeDir}shared;$INCLUDE"
! 141: LIB="${WindowsSdkLibDir}x64;$LIB"
! 142:
! 143: # Visual C++ tools, headers and libraries.
! 144: VSINSTALLDIR='C:\Program Files (x86)\Microsoft Visual Studio 14.0'
! 145: VCINSTALLDIR="${VSINSTALLDIR}"'\VC'
! 146: PATH=`cygpath -u "${VCINSTALLDIR}"`/bin/amd64:"$PATH"
! 147: INCLUDE="${VCINSTALLDIR}"'\include;'"${INCLUDE}"
! 148: LIB="${VCINSTALLDIR}"'\lib\amd64;'"${LIB}"
! 149:
! 150: export INCLUDE LIB
! 151:
! 152: Building 32-bit binaries with MSVC is achieved through the following
! 153: preparation, configure, and build commands:
! 154:
! 155: PATH=/usr/local/msvc32/bin:$PATH
! 156: export PATH
! 157:
! 158: win32_target=_WIN32_WINNT_WINXP # for MSVC 9.0
! 159: win32_target=_WIN32_WINNT_VISTA # possibly for MSVC >= 10.0
! 160: win32_target=_WIN32_WINNT_WIN7 # possibly for MSVC >= 10.0
! 161: win32_target=_WIN32_WINNT_WIN8 # possibly for MSVC >= 10.0
! 162:
! 163: ./configure --host=i686-w64-mingw32 --prefix=/usr/local/msvc32 \
! 164: CC="$HOME/msvc/compile cl -nologo" \
! 165: CFLAGS="-MD" \
! 166: CXX="$HOME/msvc/compile cl -nologo" \
! 167: CXXFLAGS="-MD" \
! 168: CPPFLAGS="-D_WIN32_WINNT=$win32_target -I/usr/local/msvc32/include" \
! 169: LDFLAGS="-L/usr/local/msvc32/lib" \
! 170: LD="link" \
! 171: NM="dumpbin -symbols" \
! 172: STRIP=":" \
! 173: AR="$HOME/msvc/ar-lib lib" \
! 174: RANLIB=":"
! 175: make
! 176: make check
! 177:
! 178: Building 64-bit binaries with MSVC is achieved through the following
! 179: preparation, configure, and build commands:
! 180:
! 181: PATH=/usr/local/msvc64/bin:$PATH
! 182: export PATH
! 183:
! 184: win32_target=_WIN32_WINNT_WINXP # for MSVC 9.0
! 185: win32_target=_WIN32_WINNT_VISTA # possibly for MSVC >= 10.0
! 186: win32_target=_WIN32_WINNT_WIN7 # possibly for MSVC >= 10.0
! 187: win32_target=_WIN32_WINNT_WIN8 # possibly for MSVC >= 10.0
! 188:
! 189: ./configure --host=x86_64-w64-mingw32 --prefix=/usr/local/msvc64 \
! 190: CC="$HOME/msvc/compile cl -nologo" \
! 191: CFLAGS="-MD" \
! 192: CXX="$HOME/msvc/compile cl -nologo" \
! 193: CXXFLAGS="-MD" \
! 194: CPPFLAGS="-D_WIN32_WINNT=$win32_target -I/usr/local/msvc64/include" \
! 195: LDFLAGS="-L/usr/local/msvc64/lib" \
! 196: LD="link" \
! 197: NM="dumpbin -symbols" \
! 198: STRIP=":" \
! 199: AR="$HOME/msvc/ar-lib lib" \
! 200: RANLIB=":"
! 201: make
! 202: make check
! 203:
! 204: Installation:
! 205:
! 206: make install
! 207:
! 208: ===============================================================================
! 209: 3) Binaries for the Cygwin environment.
! 210:
! 211: The generic instructions in the INSTALL file apply. But here are more
! 212: specific ones.
! 213:
! 214: You need to install
! 215: * Cygwin (from https://cygwin.com/),
! 216: * some packages available from the Cygwin package installer:
! 217: make
! 218: * the Cygwin [cross-]compilation tools package, available from
! 219: the Cygwin package installer (setup-x86_64.exe):
! 220: - for creating 32-bit binaries: packages
! 221: cygwin32-gcc-core,
! 222: cygwin32
! 223: - for creating 64-bit binaries: packages
! 224: gcc-core
! 225:
! 226: Building 32-bit binaries for Cygwin must be done in a directory *outside*
! 227: the Cygwin /home and /usr hierarchies. It is achieved through the following
! 228: preparation, configure, and build commands:
! 229:
! 230: PATH=/usr/local/cygwin32/bin:/usr/i686-pc-cygwin/sys-root/usr/bin:$PATH
! 231: export PATH
! 232: ./configure --host=i686-pc-cygwin --prefix=/usr/local/cygwin32 \
! 233: CC=i686-pc-cygwin-gcc \
! 234: CPPFLAGS="-I/usr/local/cygwin32/include -Wall" \
! 235: LDFLAGS="-L/usr/local/cygwin32/lib"
! 236: make
! 237: make check
! 238:
! 239: Building 64-bit binaries for Cygwin is achieved through the following
! 240: preparation, configure, and build commands:
! 241:
! 242: PATH=/usr/local/cygwin64/bin:$PATH
! 243: export PATH
! 244: ./configure --host=x86_64-pc-cygwin --prefix=/usr/local/cygwin64 \
! 245: CC=x86_64-pc-cygwin-gcc \
! 246: CPPFLAGS="-I/usr/local/cygwin64/include -Wall" \
! 247: LDFLAGS="-L/usr/local/cygwin64/lib"
! 248: make
! 249: make check
! 250:
! 251: Installation:
! 252:
! 253: make install
! 254:
! 255: ===============================================================================
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to INSTALL.windows CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / libiconv