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

From Apache OpenOffice Wiki
Jump to: navigation, search
(Added "build requirements" section.)
 
(Improved the requirements tables.)
Line 26: Line 26:
 
{| class="prettytable" border="1" width="100%"
 
{| class="prettytable" border="1" width="100%"
 
|-
 
|-
| What
+
!style="width: 20%"|What
 
! Where to get
 
! Where to get
! How to install
+
!style="width: 20%"|How to install
 
|-
 
|-
 
| Windows XP, Windows Vista, Windows 7
 
| Windows XP, Windows Vista, Windows 7
Line 35: Line 35:
 
|-
 
|-
 
| Cygwin
 
| Cygwin
| [http://www.cygwin.com Cygwin Toolkit], minimum version: 1.5.10, preferred: current version]
+
| http://www.cygwin.com, minimum version: 1.5.10, preferred: current version]
 
| (default)
 
| (default)
 
|-
 
|-
| Visual C++ 2008 Express \\ (C/C++ compiler, debugger)
+
| Visual C++ 2008 Express  
| [http://www.microsoft.com/express/download/].  Free download, basic install, no optional parts required
+
 
 +
(C/C++ compiler, debugger)
 +
| http://www.microsoft.com/express/download/.  Free download, basic install, no optional parts required
 
| --with-cl-home=
 
| --with-cl-home=
 
|-
 
|-
 
| Windows SDK for Windows Server 2008
 
| Windows SDK for Windows Server 2008
| [http://www.microsoft.com/downloads/details.aspx?FamilyId=F26B1AA4-741A-433A-9BE5-FA919850BDBF&displaylang=en]<ref name="Foot1">{{Template:Documentation/Note|This also supported on Vista. 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 that can extract files from ISO files 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.
+
| http://www.microsoft.com/downloads/details.aspx?FamilyId=F26B1AA4-741A-433A-9BE5-FA919850BDBF&displaylang=en
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. I used D:\Dev\Win_SDK\ and received some linking errors in the Python module (see {{Bug|88568}}).}}</ref>
+
 
 +
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
 
| GDI+ Redistributable
| [http://www.microsoft.com/downloads/details.aspx?familyid=6A63AB9C-DF12-4D41-933C-BE590FEAA05A&displaylang=en].  Genuine Windows Validation required.
+
| http://www.microsoft.com/downloads/details.aspx?familyid=6A63AB9C-DF12-4D41-933C-BE590FEAA05A&displaylang=en.  Genuine Windows Validation required.
 
| main/external/gdiplus
 
| main/external/gdiplus
 
|-
 
|-
 
| dbghelp.dll
 
| dbghelp.dll
| [http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=CD1FC4B2-0885-47F4-AF45-7FD5E14DB6C0]<ref name="Foot3">{{Template:Documentation/Note|dbghelp.dll is available from the Microsoft site and needs to be saved to main/external/dbghelp.  The exact download URL may have changed. You may have to search Microsoft's website.}}</ref>
+
| 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
 
| main/external/dbghelp
 
|-
 
|-
 
| Runtime libraries
 
| Runtime libraries
| for 2008 compiler starting with DEV300m23: 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<ref name="Foot4"> {{Template:Documentation/Note|You can find these files in your directory c:\program files\common files\merge modules}}</ref>
+
| 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
. These merge modules are available in VS08 Express Edition and VS08 Professional Edtion. All *.msm files are located at c:\Program Files\Common Files\Merge Module.  
+
 
 +
You can find these files in your directory <code>c:\Program Files\Common Files\Merge Modules</code> or <code>c:\Program Files (x86)\Common Files\Merge Modules</code> . These merge modules are available in Visual Studio 2008 Express Edition and Professional Edition.
 
| main/external/msm90
 
| main/external/msm90
 +
|}
 +
 +
Requirements for optional features:
 +
 +
{| class="prettytable" border="1" width="100%"
 
|-
 
|-
| optional:
+
!style="width: 20%"|What
 +
! Where to get
 +
!style="width: 20%"|How to install
 
|-
 
|-
 
| Mozilla binary distribution
 
| 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.
+
| 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
 
| main/moz/zipped
 
|-
 
|-
 
| Runtime libraries 7.1
 
| Runtime libraries 7.1
| msvcr71.dll and msvcp71.dll for Mozilla libraries (Search for them in 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))
+
| 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  
 
| main/external/msvcp71  
 
|-
 
|-
 
| Runtime libraries 8.0
 
| Runtime libraries 8.0
| msvcp80.dll and msvcr80.dll for Mozilla libraries (found in c:\WINDOWS/WinSxS/x86_Microsoft.VC80.CRT_1fc8b3b9a1e18e3b_8.0.50727.42_x-ww_0de06acd/msvc)
+
| msvcp80.dll and msvcr80.dll for Mozilla libraries. Search for them on the web or on your PC.
 
| main/external/msvcp80
 
| main/external/msvcp80
 
|
 
|
 
|-
 
|-
 
| Microsoft DirectX SDK
 
| Microsoft DirectX SDK
| [http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=6812]<ref name="Foot6"> {{Template:Documentation/Note|If you don't want to download it you can disable DirectX support in the configuration step (<code>--disable-directx</code>).
+
| http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=6812
{{Template:Documentation/Caution|Current (as of 2008/01) versions of the DirectX9 SDK and Windows Platform SDK do not fit to each other. To be able to build with DirextX enabled, you need to patch one file in the Platform SDK. See http://forums.microsoft.com/MSDN/ShowPost.aspx?PostID2743771 for details.}}</ref>
+
 
| --with-directx-home=
 
| --with-directx-home=
 
|-
 
|-
 
| Nullsoft Scriptable Install System (NSIS)
 
| Nullsoft Scriptable Install System (NSIS)
| [http://nsis.sourceforge.net/ ]<ref name="Foot5">{{Template:Documentation/Note|If NSIS is available, a self contained Windows installer is created in addition to the MSI installer files.}}
+
| http://nsis.sourceforge.net/  
{{Template:Documentation/Caution|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.}}</ref>
+
 
 +
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 {{Bug|85657}}), but it seems that it now works for NSIS up to 2.3.7.
 
|}
 
|}

Revision as of 08:45, 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] (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.

Personal tools