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

From Apache OpenOffice Wiki
Jump to: navigation, search
(Update links to newer versions of Microsoft's software.)
(Windows 7: Continue update the description)
Line 98: Line 98:
 
**After installation is finished click the Finish button to close the dialog.  
 
**After installation is finished click the Finish button to close the dialog.  
  
*Start bash in a terminal
+
*Start cygwin bash in a terminal
:One way to do this is:
+
::One way to do this is:
:*Press WindowsKey-R
+
::*Press WindowsKey-R
:*Enter c:\cygwin\Cygwin.bat
+
::*Enter c:\cygwin\Cygwin.bat
:*Hit Return.
+
::*Hit Return.
  
* Intall Java.
+
* Install Java.
:Choose between JDK 1.6 (JDK 1.7 does not work because of hsqldb, 2013-02) or OpenJDK.
+
::Choose between JDK 1.6 (JDK 1.7 does not work because of hsqldb, 2013-02) or OpenJDK.
:*If you chose JDK 1.6: Download the current JDK from www.oracle.com/technetwork/java/javase/downloads/index.html.
+
::*If you chose JDK 1.6: 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-6u35-windows-i586.exe).
+
::*Download and run the 32-bit Windows version (currently this is jdk-6u35-windows-i586.exe).
  
 
* Install Ant
 
* Install Ant
Line 116: Line 116:
 
    
 
    
 
* Prepare to install missing cygwin packages by installing apt-cyg from googlecode.com<pre>cd to /cygdrive/c/temp</pre>(or any other temporary directory of your choice)<pre>wget http://apt-cyg.googlecode.com/svn/trunk/apt-cyg&#10;chmod +x apt-cyg&#10;mv apt-cyg /usr/local/bin/</pre>
 
* Prepare to install missing cygwin packages by installing apt-cyg from googlecode.com<pre>cd to /cygdrive/c/temp</pre>(or any other temporary directory of your choice)<pre>wget http://apt-cyg.googlecode.com/svn/trunk/apt-cyg&#10;chmod +x apt-cyg&#10;mv apt-cyg /usr/local/bin/</pre>
* Use apt-cyg to install missing cygwin packages<pre>apt-cyg install perl zip unzip gperf autoconf rsync gcc4-g++ bison flex patch</pre>
+
* Use apt-cyg to install missing cygwin packages<pre>apt-cyg install perl zip unzip gperf autoconf rsync gcc4-g++ bison flex patch</pre><br />If you will use git, you need in addition the packages<pre>git git-svn</pre>
  
 
* Replace symlinked awk with copy of gawk.exe:<pre>rm /usr/bin/awk&#10;mv /usr/bin/gawk.exe /usr/bin/awk.exe</pre>Note that if the <code>rm</code> command fails then the <code>mv</code> is not necessary.
 
* Replace symlinked awk with copy of gawk.exe:<pre>rm /usr/bin/awk&#10;mv /usr/bin/gawk.exe /usr/bin/awk.exe</pre>Note that if the <code>rm</code> command fails then the <code>mv</code> is not necessary.
Line 125: Line 125:
 
**Alternatively download the iso image http://www.microsoft.com/en-us/download/details.aspx?id=20955.  Burn it to a dvd or unzip it.
 
**Alternatively download the iso image http://www.microsoft.com/en-us/download/details.aspx?id=20955.  Burn it to a dvd or unzip it.
  
* Install Windows SDK for Windows Server 2008
+
* Install <del>Windows SDK for Windows Server 2008</del> Microsoft Windows SDK for Windows 7 and .NET Framework 3.5. SP1 (recommend by Microsoft)
 
** <del>Browse to http://www.microsoft.com/en-us/download/details.aspx?id=11310.</del> Browse to http://www.microsoft.com/en-us/download/details.aspx?id=3138.
 
** <del>Browse to http://www.microsoft.com/en-us/download/details.aspx?id=11310.</del> Browse to http://www.microsoft.com/en-us/download/details.aspx?id=3138.
 
** Download Setup.exe and run the web installer (note that it will be saved as Setup(1).exe to disambiguate from the previously downloaded cygwin installer.)  You can use the default values in the installation dialog.
 
** Download Setup.exe and run the web installer (note that it will be saved as Setup(1).exe to disambiguate from the previously downloaded cygwin installer.)  You can use the default values in the installation dialog.
Line 131: Line 131:
  
 
* Download MS Visual C++ 2008 SP1 Redistributable Package (x86)
 
* Download MS Visual C++ 2008 SP1 Redistributable Package (x86)
**<del>Browse to http://www.microsoft.com/en-us/download/details.aspx?id=5582</del> Download the most actual version of Apache OpenOffice and unpack it. Find the files vcredist_x86.exe and vcredist_x64.exe in folder redist. There have been security updates, which are not included in older versions.
+
**<del>Browse to http://www.microsoft.com/en-us/download/details.aspx?id=5582</del> http://www.microsoft.com/en-us/download/details.aspx?id=26368 ( There have been security updates, which are not included in older versions.)<br />  If you download the most actual version of Apache OpenOffice and unpack it, you will find the files vcredist_x86.exe and vcredist_x64.exe in folder redist. You can use them too.
**<del>Download vcredist_x86.exe</del>.
+
**Download files vcredist_x86.exe and vcrestist_x64.exe
  
 
* Optional: Install DirectX SDK (for graphics hardware support in the slide show)
 
* Optional: Install DirectX SDK (for graphics hardware support in the slide show)

Revision as of 15:58, 19 February 2013


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:
Source release SVN
Build from source release if you want to build OpenOffice once but don't want to do any development. Build from SVN if you want to development work with OpenOffice.
  • Download AOO 3.4.1 source tarball from

http://people.apache.org/~jsc/developer-snapshots/r1372282/src/aoo-3.4.1-incubating-src.tar.bz2

  • Optional: Download signature from

http://people.apache.org/~jsc/developer-snapshots/r1372282/src/aoo-3.4.1-incubating-src.tar.bz2.asc

and verify the source tarball with

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

Note that you have to have the keys already imported to your key chain. The keys can be found on the download page:

http://www.apache.org/dist/incubator/ooo/KEYS

  • Unpack source:
 cd /tmp
 tar -xjf ~/Downloads/aoo-3.4.1-incubating-src.tar.bz2
 cd aoo-3.4.1/main
  • Start with creating a parent directory for the source code. Don't use /tmp because that is deleted on every boot:
 sudo mkdir /source
 sudo chown <your-user-name> /source
 cd /source
  • Install subversion and checkout the 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 cygwin bash in a terminal
One way to do this is:
  • Press WindowsKey-R
  • Enter c:\cygwin\Cygwin.bat
  • Hit Return.
  • Install Java.
Choose between JDK 1.6 (JDK 1.7 does not work because of hsqldb, 2013-02) or OpenJDK.
  • If you chose JDK 1.6: 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-6u35-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 parentheses.
  • 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

    If you will use git, you need in addition the packages
    git git-svn
  • 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.
  • Optional: Install NSIS installer (for creating the EXE installer)


  • Get AOO source code. You can use the source release or check out from SVN:
Source release SVN
Build from source release if you want to build OpenOffice once but don't want to do any development. Build from SVN if you want to development work with OpenOffice.
  • Start with creating a parent directory for the source code:
    mkdir /cygdrive/c/source
    cd /cygdrive/c/source
  • Check out source from Apache SVN repository
    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`
  • Optional: Get dbghelp.dll (for using the --enable-dbgutil configure option)
    • This dll is part of MS Visual Studio.
    • Copy file to main/external/dbghelp
      cp /cygdrive/c/Program\ Files\ \(x86\)/Microsoft\ Visual\ Studio\ 9.0/Common7/IDE/dbghelp.dll $SourceMain/external/dbghelp
  • Get MS Visual C++ 2008 SP1 Redistributable vcredist_x86.exe (both 32 and 64 bit)
  • 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.6.0_35" \
          --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
    Depending on your computer this will take one or more hours to finish.
  • Install
    There are three options:
    1. Regular install with integration into Windows.
      This allows only one instance of AOO to be installed.
      • Start setup.exe and click through dialog:
        $SourceMain/instsetoo_native/wntmsci12.pro/OpenOffice/msi/install/en-US/setup.exe
      • Apache OpenOffice can be started via the Windows start menu.
    2. Install without integration into Windows.
      This allows several instance of AOO, based on the same version, to be installed side by side.
      It still requires Administrator permissions.
      • Start setup.exe with option -a:
        $SourceMain/instsetoo_native/wntmsci12.pro/OpenOffice/msi/install/en-US/setup.exe -a
      • Enter an installation path into the dialog and click through the dialog to finish installation.
      • Start AOO by running
        <installation-path>/program/soffice.exe
    3. Unpack archive without installation.
      This does not require Administrator permissions
      • Go to installation directory:
        cd <installation-target>
      • Unzip archive:
        unzip $SourceMain/instsetoo_native/wntmsci12.pro/OpenOffice/archive/install/en-US/Apache_OpenOffice_incubating_3.5.0_Win_x86_install-arc_en-US.zip
      • Start AOO by running:
        ./Apache_OpenOffice_incubating_3.5.0_Win_x86_install-arc_en-US/program/soffice.exe
Personal tools