Difference between revisions of "Documentation/Building Guide AOO/Building on Windows"
Line 34: | Line 34: | ||
!style="width: 20%"|How to install | !style="width: 20%"|How to install | ||
|- | |- | ||
− | | Windows | + | | Windows 7 (recommended), Windows Vista, Windows XP |
| | | | ||
| | | | ||
|- | |- | ||
| Cygwin | | Cygwin | ||
− | | http://www.cygwin.com, minimum version: 1.5.10, preferred: current version] | + | | http://www.cygwin.com, 32bit, minimum version: 1.5.10, preferred: current version] |
See [[#Setting up Cywin|below]] for setting up cygwin and the required packages. | See [[#Setting up Cywin|below]] for setting up cygwin and the required packages. | ||
| (default) | | (default) | ||
|- | |- | ||
− | | | + | | Microsoft Windows SDK for Windows 7 and .NET Framework 3.5 SP1 |
− | + | | http://www.microsoft.com/en-us/download/details.aspx?id=3138 | |
− | | http://www.microsoft.com/ | ||
− | |||
− | + | It brings the Visual Studio 2008 C++ compiler with it. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
This is either a DVD image or a net installer. You can either mount the DVD with a suitable tool, burn it do a DVD or use tools like winrar or 7zip to extract files from the ISO file directly. You don't need to install samples or documentation (saves a lot of disk space). It will also install the .NET Framework 3.5 SDK. It might be best to install the Windows SDK into the default directory, and if not that into one without capital letters in the path. | This is either a DVD image or a net installer. You can either mount the DVD with a suitable tool, burn it do a DVD or use tools like winrar or 7zip to extract files from the ISO file directly. You don't need to install samples or documentation (saves a lot of disk space). It will also install the .NET Framework 3.5 SDK. It might be best to install the Windows SDK into the default directory, and if not that into one without capital letters in the path. | ||
| | | | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
| Microsoft Visual C++ 2008 SP1 Redistributable Package (x86) | | Microsoft Visual C++ 2008 SP1 Redistributable Package (x86) | ||
Line 85: | Line 65: | ||
The exact download URL may have changed. In that case you have to search Microsoft's website. | The exact download URL may have changed. In that case you have to search Microsoft's website. | ||
| main/external/vcredist | | main/external/vcredist | ||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | + | | GDI+ Redistributable | |
− | + | | http://www.microsoft.com/downloads/details.aspx?familyid=6A63AB9C-DF12-4D41-933C-BE590FEAA05A&displaylang=en. Genuine Windows Validation required. | |
− | + | | main/external/gdiplus | |
− | |||
− | |||
− | | http:// | ||
− | | main/ | ||
|- | |- | ||
| Runtime libraries 7.1 | | Runtime libraries 7.1 | ||
− | | msvcr71 | + | | msvcr71.dll for Mozilla libraries. Search for them on the web or on your PC. These files should be named as all lower case. Sometimes when downloaded they are upper case and this will cause 'file not found' errors towards the end of the build)) |
| main/external/msvcp71 | | main/external/msvcp71 | ||
|- | |- | ||
Line 107: | Line 78: | ||
| main/external/msvcp80 | | main/external/msvcp80 | ||
| | | | ||
+ | |- | ||
+ | | Runtime libraries 10.0 | ||
+ | | msvcp100.dll and msvcr100.dll for Java 7 support - see issue [https://issues.apache.org/ooo/show_bug.cgi?id=120979 120979]. | ||
+ | Get them from the Microsoft Visual C++ 2010 Redistributable Package (x86) from the Microsoft site - http://www.microsoft.com/en-us/download/search.aspx?q=Microsoft+Visual+C%2b%2b+2010+Redistributable | ||
+ | | main/external/msvcp100 | ||
+ | | | ||
+ | |- | ||
+ | | dbghelp.dll | ||
+ | | http://msdn.microsoft.com/en-us/library/windows/desktop/ms679309%28v=vs.85%29.aspx | ||
+ | |||
+ | The exact download URL may have changed. In that case you have to search Microsoft's website. | ||
+ | |||
+ | Search for it on your PC or on the web. E.g., it is part of the Windows Driver Kit. | ||
+ | | main/external/dbghelp | ||
+ | |- | ||
+ | | Windows Driver Kit Version 7.1.0 | ||
+ | | http://www.microsoft.com/downloads/details.aspx?id=11800 | ||
+ | |||
+ | To enable ATL and ActiveX in the build - it is optional | ||
+ | |||
+ | related configure options are: | ||
+ | --with-atl-include, --with-atl-lib-dir, --with-mfc-include-dir, --with-mfc-lib-dir | ||
+ | | | ||
|- | |- | ||
| Microsoft DirectX SDK | | Microsoft DirectX SDK | ||
| http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=6812 | | http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=6812 | ||
− | + | ||
+ | To enable DirectX in the build - it is optional | ||
+ | |||
+ | related configure option is: | ||
+ | --with-directx-home | ||
+ | | | ||
|- | |- | ||
| Nullsoft Scriptable Install System (NSIS) | | Nullsoft Scriptable Install System (NSIS) | ||
| http://nsis.sourceforge.net/ | | http://nsis.sourceforge.net/ | ||
− | If NSIS is available, a self contained Windows installer is created in addition to the MSI installer files | + | If NSIS is available, a self contained Windows installer is created in addition to the MSI installer files - it is optional |
− | + | | | |
− | |||
|} | |} | ||
Revision as of 09:43, 2 August 2013
Template:Documentation/Building Guide AOO TOC
Template:Documentation/HelpNeeded
Overview
For general information on how to build Apache OpenOffice from source code, see the platform independent page.
Template:Documentation/Windows For building Apache OpenOffice the Cygwin environment is required. Cygwin is a set of programs that run on Windows but emulate a complete Unix command line environment.
As compiler we use Microsoft's Visual C++, not the gcc from Cygwin. Therefore Visual Studio Express can be used for debugging.
To use this document you should be familiar with a bourne command line interpreter (sh or bash), but you need not be a UNIX shell wizard. Template:Documentation/Tip
Build requirements
Additionally to the general build requirements you need
What | Where to get | How to install | |
---|---|---|---|
Windows 7 (recommended), Windows Vista, Windows XP | |||
Cygwin | http://www.cygwin.com, 32bit, minimum version: 1.5.10, preferred: current version]
See below for setting up cygwin and the required packages. |
(default) | |
Microsoft Windows SDK for Windows 7 and .NET Framework 3.5 SP1 | http://www.microsoft.com/en-us/download/details.aspx?id=3138
It brings the Visual Studio 2008 C++ compiler with it. This is either a DVD image or a net installer. You can either mount the DVD with a suitable tool, burn it do a DVD or use tools like winrar or 7zip to extract files from the ISO file directly. You don't need to install samples or documentation (saves a lot of disk space). It will also install the .NET Framework 3.5 SDK. It might be best to install the Windows SDK into the default directory, and if not that into one without capital letters in the path. |
||
Microsoft Visual C++ 2008 SP1 Redistributable Package (x86) | vcredist_x86.exe, download found here
It is just packed as it is into the installation package. The exact download URL may have changed. In that case you have to search Microsoft's website. |
main/external/vcredist | |
Microsoft Visual C++ 2008 SP1 Redistributable Package (x64) | vcredist_x64.exe, download found here
It is just packed as it is into the installation package. The exact download URL may have changed. In that case you have to search Microsoft's website. |
main/external/vcredist | |
GDI+ Redistributable | http://www.microsoft.com/downloads/details.aspx?familyid=6A63AB9C-DF12-4D41-933C-BE590FEAA05A&displaylang=en. Genuine Windows Validation required. | main/external/gdiplus | |
Runtime libraries 7.1 | msvcr71.dll for Mozilla libraries. Search for them on the web or on your PC. These files should be named as all lower case. Sometimes when downloaded they are upper case and this will cause 'file not found' errors towards the end of the build)) | main/external/msvcp71 | |
Runtime libraries 8.0 | msvcp80.dll and msvcr80.dll for Mozilla libraries. Search for them on the web or on your PC. | main/external/msvcp80 | |
Runtime libraries 10.0 | msvcp100.dll and msvcr100.dll for Java 7 support - see issue 120979.
Get them from the Microsoft Visual C++ 2010 Redistributable Package (x86) from the Microsoft site - http://www.microsoft.com/en-us/download/search.aspx?q=Microsoft+Visual+C%2b%2b+2010+Redistributable |
main/external/msvcp100 | |
dbghelp.dll | http://msdn.microsoft.com/en-us/library/windows/desktop/ms679309%28v=vs.85%29.aspx
The exact download URL may have changed. In that case you have to search Microsoft's website. Search for it on your PC or on the web. E.g., it is part of the Windows Driver Kit. |
main/external/dbghelp | |
Windows Driver Kit Version 7.1.0 | http://www.microsoft.com/downloads/details.aspx?id=11800
To enable ATL and ActiveX in the build - it is optional related configure options are: --with-atl-include, --with-atl-lib-dir, --with-mfc-include-dir, --with-mfc-lib-dir |
||
Microsoft DirectX SDK | http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=6812
To enable DirectX in the build - it is optional related configure option is: --with-directx-home |
||
Nullsoft Scriptable Install System (NSIS) | http://nsis.sourceforge.net/
If NSIS is available, a self contained Windows installer is created in addition to the MSI installer files - it is optional |
Remarks
Setting up Cygwin
Go to http://www.cygwin.com/ and download and install the current version.
Make sure that the PATH variable in your cygwin shell does not contain any unquoted blanks and quotes, otherwise configure will not work |
Cygwin consists of some basic and a lot of optional packages. As building AOO needs some of these optional packages you have to select them in the installer. Here's a complete list of the required packages:
- Category Archive:
- unzip
- zip
- Category Devel :
- autoconf
- bison
- flex
- gcc-g++
- gperf
- make
- openssl-devel (only needed for perl modules for CWS tooling, see below)
- mercurial (or cvs for 2.x-3.0, or subversion for 3.1 codeline)
- readline
- subversion (if you want to use svn inside the cygwin shell to checkout and update your working copy of AOO)
- Category Libs
- openssl
- Category Net
- openssh
- Category Perl
- perl
- Category Shells
- mintty
- Category Utils
- patch
- gnupg
- Category Web
- wget
Configure switches (Windows specific)
Additionally to the general configure switches there are several that only have to be used on Windows or have Windows specific values.
Typical values for the compiler and SDK. If default installation paths are used these configure switches are not needed:
--with-cl-home="/cygdrive/c/Program Files/Microsoft Visual Studio 9.0/VC" \ --with-mspdb-path="/cygdrive/c/Program Files/Microsoft Visual Studio 9.0/Common7/IDE" \ --with-frame-home="/cygdrive/c/Program Files/Microsoft SDKs/Windows/v6.1" \ --with-psdk-home="/cygdrive/c/Program Files/Microsoft SDKs/Windows/v6.1" \ --with-midl-path="/cygdrive/c/Program Files/Microsoft SDKs/Windows/v6.1/Bin" \ --with-asm-home="/cygdrive/c/Program Files/Microsoft Visual Studio 9.0/VC/Bin" \ --with-csc-path="/cygdrive/c/WINDOWS/Microsoft.NET/Framework/v3.5"
For Java SDK and Ant:
--with-jdk-home="/cygdrive/c/Program Files (x86)/Java/jdk1.6.0_27" \ --with-ant-home="/cygdrive/c/ant"
For DirectX:
--with-directx-home="C:/Program Files (x86)/Microsoft DirectX SDK (June 2010)"
For the Visual Studio C++ 2008 Express
--disable-atl \ --disable-activex
To enable ATL and ActiveX when using Visual Studio C++ 2008 Express you need the Windows Driver SDK:
- download and install the Windows Driver SDK, it comes with the ATL header and libraries for free (as in free beer).
- run configure using the following configure switches assuming that Windows Driver SDK has been installed into C:\WinDDK\7600.16385.1:
- --with-atl-include-dir=/cygdrive/c/WinDDK/7600.16385.1/inc/atl71 \
- --with-atl-lib-dir=/cygdrive/c/WinDDK/7600.16385.1/lib/ATL/i386 \
- --with-mfc-include-dir=/cygdrive/c/WinDDK/7600.16385.1/inc/mfc42 \
- --with-mfc-lib-dir=/cygdrive/c/WinDDK/7600.16385.1/lib/Mfc/i386 \
And some more:
--enable-pch \ --enable-dbgutil