Language

The Free and Open Productivity Suite
Released: Apache OpenOffice 4.1.15

Implementation of Porting

Porting Efforts in the OpenOffice.org wiki.

The first task you must complete is to create the bootstrapping process, so that the build tools to build the office suite are available.

Building dmake

For a full description of building dmake on different platforms read the makefile in the $SRC_ROOT/dmake directory. The following is an example of how to build dmake on Linux. Use this example as a guide when attempting to build dmake on another operating system.

  1. Change to the $SRC_ROOT/dmake directory, and run the and make commands, as follows:
    
    % cd $SRC_ROOT/dmake
    % configure
    % make
    

    If the compile is successful, the system creates the $SRC_ROOT/dmake/dmake file.

    If the configure is not successful you may have to relate your platform to a specific setup, take a look at the configure.in, modify and run autoreconf.

  2. Install dmake into the build environment by executing the following commands:
    
    % cp $SRC_ROOT/dmake/dmake $SRC_ROOT/solenv/unxlngi3/bin/dmake
    % chmod -Rf a+rx $SRC_ROOT/solenv/unxlngi3/bin
    

    For information on the derivation of the directory name unxlngi3, see the information on OUTPATH in the Build Environment document. This name is equivalent to the value of the $OUTPATH variable.

  3. Create the specific compiler flags and options in the file, for example, see unxlngi3.mk in the directory $SRC_ROOT/solenv/inc.
  4. Modify unx.mk to switch to this file depending on the values, for example:
    
    .IF
    "$(COM)$(OS)$(CPU)$(GLIBC)" == "GCCLINUXI2REDHAT60"
    .INCLUDE : unxlngi3.mk
    .ENDIF
    

Creating the Rest of the Build Tools

To create the remaining build tools, you need to build the following modules:

To build these modules, follow these steps:

  1. First you need to create a minimum build environment. The various makefiles require csh to run properly, so if you are not running the csh shell, change to it by executing the following command:
    				
    % csh
    
  2. The makefiles need several environment variables to be set to work properly. The configure process creates a file of the environment variables that need to be set. For example, for Linux on Intel, the configure process creates a LinuxIntelEnv.Set file, as follows:
    			
    setenv SRC_ROOT OpenOffice-top-level-directory-tree
    setenv DMAKEROOT $SRC_ROOT/solenv/inc/startup
    setenv PATH $SRC_ROOT/solenv/$OUTPATH/bin:$SRC_ROOT/solenv/bin:"$PATH"
    setenv OS LINUX
    setenv SOLARENV $SRC_ROOT/solenv
    setenv SOLARVER $SRC_ROOT/solver
    setenv UPD build-number
    setenv INPATH unxlngi3.pro
    setenv OUTPATH unxlngi3
    setenv PRODUCT full
    setenv GUI UNX
    setenv GUIBASE unx
    setenv COM GCC
    setenv CPU I
    setenv CPUNAME INTEL
    setenv GVER VCL
    setenv CVER C295
    setenv USE_NAMESPACE TRUE
    setenv UPDATER YES
    setenv SOL_TMP $HOME
    setenv SOLARINC "-I. -I$SRC_ROOT/sal/inc -I$SRC_ROOT/vos/inc
     -I$SRC_ROOT/std2 -I$SRC_ROOT/std2/stl" 
    setenv SOLARLIB "-L$SRC_ROOT/sal/unxlngi3.pro/lib
     -L$SRC_ROOT/vos/unxlngi3.pro/lib"
    

    There is a stub version of the _mkout and makedepn tools to build the core tools located in the $SRC_ROOT/solenv/bin directory. For information on the environment variables in this file, see the Build Environment document.

  3. Build the sal project. Change to the sal directory, then create a directory for the operating system that you are porting to. If you are porting to a POSIX functions-compliant operating system, you can create this directory under the unx directory.

    Compile the code by executing the following commands:

    
    % cd $SRC_ROOT/sal
    % mkdir platform-name
    % dmake
    
  4. Manually install the files that the next project needs by executing the following commands:
    
    % mkdir -p $SRC_ROOT/solver/$UPD/$OUTPATH.pro/inc/sal
    % cp $SRC_ROOT/sal/version.mk $SRC_ROOT/$OUTPATH.pro/inc/sal
    
  5. Build the vos project by performing the following steps. Compile the code by executing the following commands.
    				
    % cd $SRC_ROOT/vos
    % dmake
    
  6. Manually install the files that the next project needs by executing the following commands:
    	
    
    % mkdir -p $SRC_ROOT/solver/$UPD/unxmacxp.pro/inc/vos
    % cp $SRC_ROOT/vos/version.mk $SRC_ROOT/solver/$UPD/$OUTPATH.pro/inc/vos
    
  7. Build the tools project. Run the following commands to compile the code:
    
    % cd $SRC_ROOT/tools
    % dmake
    
  8. Install the build tools that were compiled in the previous steps by executing the following commands:
    
    % cp $SRC_ROOT/tools/$OUTPATH.pro/bin/* $SRC_ROOT/solenv/$OUTPATH/bin
    % cp $SRC_ROOT/rscpp/$OUTPATH.pro/bin/* $HOME/dev/solenv/$OUTPATH/bin
    % chmod -Rf a+rx $SRC_ROOT/solenv/$OUTPATH/bin
    % rehash
    

You can now build the office suite.

Apache Software Foundation

Copyright & License | Privacy | Contact Us | Donate | Thanks

Apache, OpenOffice, OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. The Apache feather logo is a trademark of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.