Difference between revisions of "Documentation/Building Guide AOO/Building on Windows"

From Apache OpenOffice Wiki
Jump to: navigation, search
(Improved the requirements tables.)
(Added "Setting up Cygwin" section)
Line 36: Line 36:
 
| Cygwin
 
| Cygwin
 
| http://www.cygwin.com, minimum version: 1.5.10, preferred: current version]
 
| http://www.cygwin.com, minimum version: 1.5.10, preferred: current version]
 +
 +
See [[#Setting up Cywin|below]] for setting up cygwin and the required packages.
 
| (default)
 
| (default)
 
|-
 
|-
Line 99: Line 101:
 
It used to be that newer version of NSIS broke the build (see {{Bug|85657}}), but it seems that it now works for NSIS up to 2.3.7.
 
It used to be that newer version of NSIS broke the build (see {{Bug|85657}}), but it seems that it now works for NSIS up to 2.3.7.
 
|}
 
|}
 +
 +
=Remarks=
 +
 +
{{Template:Documentation/Note|OOo uses some Mozilla libraries. Building the corresponding sources is only possible with the VC2003 compiler so you have to use precompiled libraries that require the msvx71 libraries mentioned above. On Windows the Mozilla libraries are needed only for Mozilla address book support. Unfortunately a bug in the module dependencies makes it necessary that the Mozilla libaries are used anyway as otherwise building the module <tt>xmlsecurity</tt> fails (see below).}}
 +
 +
{{Template:Documentation/Note|The default cygwin version offered on http://www.cygwin.com/ now is 1.7.x. For current milestones it is recommended to use this version as it fixes the .dll remapping probelm (see below) and is required for builds on Windows 7. If you need to build old versions of the source code, check out http://www.cygwin.com/win-9x.html}}
 +
 +
= Setting up Cygwin =
 +
 +
Go to http://www.cygwin.com/ and download and install the current version.
 +
{{Template:Documentation/Caution|Make sure that you keep the filetype set to “Unix/binary”.}}
 +
{{Template:Documentation/Caution|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
 +
* Category Libs
 +
** openssl
 +
* Category Net
 +
** openssh
 +
* Category Perl
 +
** perl
 +
* Category Shells
 +
** mintty
 +
* Category Utils
 +
** patch
 +
** gnupg
 +
* Category Web
 +
** wget
 +
 +
{{Template:Documentation/Note|The installer will automatically check and download some more packages needed by thosed listed here. The whole process takes roughly 20 minutes.}}

Revision as of 08:59, 5 April 2012

Template:Documentation/Building Guide AOO TOC

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 XP, Windows Vista, Windows 7
Cygwin http://www.cygwin.com, minimum version: 1.5.10, preferred: current version]

See below for setting up cygwin and the required packages.

(default)
Visual C++ 2008 Express

(C/C++ compiler, debugger)

http://www.microsoft.com/express/download/. Free download, basic install, no optional parts required --with-cl-home=
Windows SDK for Windows Server 2008 http://www.microsoft.com/downloads/details.aspx?FamilyId=F26B1AA4-741A-433A-9BE5-FA919850BDBF&displaylang=en

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.

GDI+ Redistributable http://www.microsoft.com/downloads/details.aspx?familyid=6A63AB9C-DF12-4D41-933C-BE590FEAA05A&displaylang=en. Genuine Windows Validation required. main/external/gdiplus
dbghelp.dll http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=CD1FC4B2-0885-47F4-AF45-7FD5E14DB6C0

The exact download URL may have changed. In that case you have to search Microsoft's website.

main/external/dbghelp
Runtime libraries Microsoft_VC90_CRT_x86.msm and policy_9_0_Microsoft_VC90_CRT_x86.msm for non debug builds and Microsoft_VC90_DebugCRT_x86.msm and policy_9_0_Microsoft_VC90_DebugCRT_x86.msm for debug builds

You can find these files in your directory c:\Program Files\Common Files\Merge Modules or c:\Program Files (x86)\Common Files\Merge Modules . These merge modules are available in Visual Studio 2008 Express Edition and Professional Edition.

main/external/msm90

Requirements for optional features:

What Where to get How to install
Mozilla binary distribution http://tools.openoffice.org/moz_prebuild/OOo3.2 (WNTMSCIruntime.zip,WNTMSCIlib.zip,WNTMSCIinc.zip) Needed as prebuilts for module moz (SeaMonkey) as the current used SeaMonkey version 1.1.4 does not support a build with Visual Studio C++ 2008 compiler. main/moz/zipped
Runtime libraries 7.1 msvcr71.dll and msvcp71.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
Microsoft DirectX SDK http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=6812 --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 used to be that newer version of NSIS broke the build (see Issue 85657 ), but it seems that it now works for NSIS up to 2.3.7.

Remarks

Template:Documentation/Note

Template:Documentation/Note

Setting up Cygwin

Go to http://www.cygwin.com/ and download and install the current version.

Documentation caution.png Make sure that you keep the filetype set to “Unix/binary”.
Documentation caution.png 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
  • Category Libs
    • openssl
  • Category Net
    • openssh
  • Category Perl
    • perl
  • Category Shells
    • mintty
  • Category Utils
    • patch
    • gnupg
  • Category Web
    • wget

Template:Documentation/Note

Retrieved from "https://wiki.openoffice.org/w/index.php?title=Documentation/Building_Guide_AOO/Building_on_Windows&oldid=199953"
Personal tools