Difference between revisions of "Documentation/Building Guide AOO/Step by step"

Revision as of 13:08, 5 October 2012

This page is intended as a collection of simple step-by-step recipes to build Apache OpenOffice from source code. A more thorough explanation of what the individual steps do and why they are necessary can be found in the building guide.

Ubuntu 12.04

• Setup VirtualBox with Ubuntu 12.04 64 bit on Windows7 64bit host. A native installation is of course fine, too.
• Let updater update ca. 380 packages. Restart.
• Get the source. You can start with the source release or by checking out from SVN:

gpg --verify aoo-3.4.1-incubating-src.tar.bz2.asc \
             aoo-3.4.1-incubating-src.tar.bz2

 cd /tmp
 tar -xjf ~/Downloads/aoo-3.4.1-incubating-src.tar.bz2
 cd aoo-3.4.1/main

 sudo mkdir /source
 sudo chown <your-user-name> /source
 cd /source

 sudo apt-get install subversion
 svn co https://svn.apache.org/repos/asf/incubator/ooo/trunk aoo-trunk
 cd aoo-trunk/main

• Install requirements (this will also install packages that are not listed):

 sudo apt-get install g++ gcc bison flex libarchive-zip-perl libcups2-dev \
      libpam0g-dev gperf libfreetype6-dev libxaw7-dev libfontconfig1-dev \
      libxrandr-dev patch libgconf2-dev libgnomevfs2-dev ant libgtk2.0-dev \
      junit junit4 libidl-dev liborbit2-dev openjdk-6-jdk libwww-perl \
      libxml-parser-perl autoconf libssl-dev

• Run autoconf to generate configure script:

 autoconf

• Configure (see the building guide section on configuration for further options):

 ./configure \
     --with-dmake-url=http://dmake.apache-extras.org.codespot.com/files/dmake-4.12.tar.bz2 \
     --with-epm-url=http://ftp.easysw.com/pub/epm/3.7/epm-3.7-source.tar.gz \
     --disable-odk \
     --disable-binfilter

• Finish configuration and download missing tarballs and extensions:

 ./bootstrap

• Include the configured environment:

 source LinuxX86-64Env.Set.sh

• Build:

 cd instsetoo_native/
 build --all

This may take a while to complete. Several hours are not uncommong. To speed things up you may want to run 'build' like this

 build --all -P<n> -- -P<n>

to start a parallel build. Replace <n> with the number of CPU cores.

• Install:

 sudo dpkg -i unxlngx6.pro/OpenOffice/deb/install/en-US/DEBS/*.deb
 sudo dpkg -i unxlngx6.pro/OpenOffice/deb/install/en-US/DEBS/desktop-integration/openoffice.org3.4-debian-menus_3.4-9593_all.deb

• Start Apache OpenOffice:

 /opt/openoffice.org3/program/soffice

Windows 7

• Install cygwin
  • Browse to http://cygwin.com.
  • Click on the setup.exe link (most recent Cygwin DLL at the moment is 1.7.16-1) to download the installer and run it.
  • Click through the questions.
  • On the "Choose A Download Site" select a nearby download server.
  • Expect a "Setup Alert" dialog box on the first cygwin install on the computer.
  • Click OK to close it.
  • On the page that allows you to select additional packages just select wget (enter wget in the Search box and select the wget enty in the Web/Default section.
  • Click Next to finish package selection.
  • Click Next to resolve dependencies.
  • After installation is finished click the Finish button to close the dialog.

• Start bash in a terminal

One way to do this is:

• Press WindowsKey-R
• Enter c:\cygwin\Cygwin.bat
• Hit Return.

• Intall Java.

Choose between JDK 1.7 (but JDK 1.5 or JDK 1.6 would be also OK) or OpenJDK.

• (If you chose JDK 1.7) Download the current JDK from www.oracle.com/technetwork/java/javase/downloads/index.html.
• Download and run the 32-bit Windows version (currently this is jdk-7u7-windows-i586.exe).

• Install Ant
  • Browse to http://ant.apache.org/bindownload.cgi
  • Chose a mirror near you.
  • Download the zip archive (currently that is apache-ant-1.8.4-bin.zip).
  • Open downloaded archive in file explorer and unzip it to a location of your choice, eg c:\. Note that C:\Program Files (x86) will not work due to problems of quoting the spaces and parantheses.

• Prepare to install missing cygwin packages by installing apt-cyg from googlecode.com

 cd to /cygdrive/c/temp

(or any other temporary directory of your choice)

 wget http://apt-cyg.googlecode.com/svn/trunk/apt-cyg
 chmod +x apt-cyg
 mv apt-cyg /usr/local/bin/

• Use apt-cyg to install missing cygwin packages

 apt-cyg install perl zip unzip gperf autoconf rsync gcc4-g++ bison flex patch
   

• Install Visual C++ 2008 Express
  • Browse to http://www.microsoft.com/en-us/download/details.aspx?id=6506
  • Download the vcssetup.exe installer and run it to install Visual C++ Express. This will download another 400MB during installation.
  • Alternatively download the iso image. Burn it to a dvd or unzip it.

• Install Windows SDK for Windows Server 2008
  • Browse to http://www.microsoft.com/en-us/download/details.aspx?id=11310
  • Download Setup.exe and run the web installer (note that it will be saved as Setup(1).exe to dismabiguate from the previously downloaded cygwin installer.) You can use the default values in the installation dialog.
  • Alternatively download the iso image. Burn it to a dvd or unzip it.

• Download MS Visual C++ 2008 SP1 Redistributable Package (x86)
  • Browse to http://www.microsoft.com/en-us/download/details.aspx?id=5582
  • Download vcredist_x86.exe.

• Optional: Install DirectX SDK (for graphics hardware support in the slide show)
  • Browse to http://www.microsoft.com/en-us/download/details.aspx?displaylang=en&id=6812
  • Download and run DXSDK_Jun10.exe

• Optional: Install NSIS installer (for creating the EXE installer)
  • Browse to http://nsis.sourceforge.net
  • Download and run the installer.

• Replace symlinked awk with copy of gawk.exe:

 rm /usr/bin/awk
 mv /usr/bin/gawk.exe /usr/bin/awk.exe

Note that if the rm command fails then the mv is not necessary.

• Get AOO source code. You can use the source release or check out from SVN:

  cd /tmp
  tar -xjf <download-location>/aoo-3.4.1-incubating-src.tar.bz2
  cd aoo-3.4.1/main

 mkdir /cygdrive/c/source
 cd /cygdrive/c/source

 apt-cyg install subversion
 svn co https://svn.apache.org/repos/asf/incubator/ooo/trunk aoo-trunk
 cd aoo-trunk/main

• Remember the source path

 SourceMain=`pwd`
 

• Get dbghelp.dll
  • This dll is nowadays part of the Windows SDK
  • Browse to the "Download and Install Debugging Tools for Windows" page on msdn.microsoft.com (at the time of this writing at http://msdn.microsoft.com/en-us/windows/hardware/gg463009.aspx)
  • Click on the "Install Debugging Tools for Windows as a Standalone Component (from Windows SDK)", this will (as the other links do, too) direct you to the download page of the current Windows SDK.
  • Download the SDK and install at least the Debugging Tools for Windows.
  • Copy files

 cp /cygdrive/c/Program\ Files\ \(x86\)/Windows\ Kits/8.0/Debuggers/x86/dbghelp.dll $SourceMain/external/dbghelp

(You may have to install c:/Program Files (x86)/Windows Kits/8.0/Debuggers/Redist/X86 Debuggers And Tools-x86_en-us.msi first)

• Get MS Visual C++ 2008 SP1 Redistributable vcredist_x86.exe (both 32 and 64 bit)
  • Browse to http://www.microsoft.com/en-us/download/details.aspx?id=5582
  • Download vcredist_x86.exe
  • Browse to http://www.microsoft.com/en-us/download/details.aspx?id=2092
  • Download vcredist_x64.exe
  • Copy to main/external

  cp <download-location>/vcredist_x86.exe $SourceMain/external/vcredist
  cp <download-location>/vcredist_x64.exe $SourceMain/external/vcredist

• Get GDI+ redistributable.
  • Browse to http://www.microsoft.com/en-us/download/details.aspx?id=18909
  • Download WindowsXP-KB975337-x86-ENU.exe
  • Run WindowsXP-KB975337-x86-ENU.exe
  • Enter a temporary path (eg c:\temp\gdiplus) in the dialog and click OK to extract files
  • Copy gdiplus.dll to main/external

 cp /cygdrive/c/temp/gdiplus/asms/10/msft/windows/gdiplus/gdiplus.dll $SourceMain/external/gdiplus/

• Remove the temporary path

 cp -fr /cygdrive/c/temp/gdiplus

• Get msvcr100.dll

 cp /c/Windows/System32/msvcr100.dll $SourceMain/external/msvcp100

• Make sure that you are in the main source directory

 cd $SourceMain
 

• Run autoconf to create the configure script

 autoconf

• Call configure
  • Run configure (adapt paths as necessary)

 MSVC_HOME="/cygdrive/c/Program Files (x86)/Microsoft Visual Studio 9.0"
 SDK_PATH="/cygdrive/c/Program Files/Microsoft SDKs/Windows/v6.1"
 ./configure \
   --with-cl-home="$MSVC_HOME/VC" \
   --with-mspdb-path="$MSVC_HOME/Common7/IDE" \
   --with-asm-home="$MSVC_HOME/Bin" \
   --with-csc-path="$MSVC_HOME/SDK/v3.5" \
   --with-frame-home="$SDK_PATH" \
   --with-psdk-home="$SDK_PATH" \
   --with-midl-path="$SDK_PATH/bin" \
   --with-directx-home="C:/Program Files (x86)/Microsoft DirectX SDK (June 2010)" \
   --with-jdk-home="/cygdrive/c/Program Files (x86)/Java/jdk1.7.0_07" \
   --with-ant-home="/cygdrive/c/apache-ant-1.8.4" \
   --with-dmake-url="http://dmake.apache-extras.org.codespot.com/files/dmake-4.12.tar.bz2" \
   --with-epm-url=http://ftp.easysw.com/pub/epm/3.7/epm-3.7-source.tar.gz \
   --enable-pch \
   --disable-atl \
   --disable-activex \
   --disable-binfilter \
   --without-junit

If you have not installed the optional DirectX SDK then remove the --with-directx-home switch

• Finish configuration and download missing external source tarballs and extensions

 ./bootstrap

• Include the configured environment

 source winenv.set.sh

• Build

 cd instsetoo_native/
 build --all