Difference between revisions of "Documentation/Building Guide/Getting the source"

From Apache OpenOffice Wiki
Jump to: navigation, search
m
(updated for Apache OpenOffice)
 
(34 intermediate revisions by 10 users not shown)
Line 1: Line 1:
 +
{{Documentation/Building Guide TOC
 +
|ShowNextPage=none
 +
|ShowPrevPage=none
 +
}}
 
{{DISPLAYTITLE:Getting the source}}
 
{{DISPLAYTITLE:Getting the source}}
[[Category:Development]][[Category:Build_System]][[Category:SVN]][[Category:SCM]]
 
__TOC__
 
  
 +
== Requirements ==
  
The source code can be fetched in several ways, as described below.
+
* '''Subversion''' version '''1.5.4 or later'''
 +
AOO's source code is managed in a [http://subversion.apache.org/ subversion] repository, so you need a svn client to checkout the sources. You can get subversion binaries from the [http://subversion.apache.org/packages.html subversion project]. Version 1.5.4 or later is required because of important fixes related to the merge-feature.
  
= Source Tarballs (for package maintainers) =
+
== Get the source via Subversion ==
  
The latest release version of the source code can be downloaded as tarballs from [http://download.openoffice.org/ Download], see '''Source''' on the right.
+
You need about 4.7 GB for a checkout from the svn repository. Building the source requires another 5GB.<br>
  
The source is pretty big and has therefore been split into several files.
+
* '''check out the latest source from svn'''
  
{| class="prettytable"
+
svn co https://svn.apache.org/repos/asf/openoffice/trunk aoo
|-
+
!Tarball
+
!Description
+
|-
+
|OOo_3.x.x_src_core.tar.bz2
+
|The necessary part for each build, the other tarballs depend on this one.
+
|-
+
|OOo_3.x.x_src_system.tar.bz2
+
|Libraries that usually exist on a standard Linux system<sup>[[#Foot1|1]]</sup>. For a Windows build this package is usually required.
+
|-
+
|OOo_3.x.x_src_binfilter.tar.bz2
+
|The filters for old binary StarOffice formats
+
|-
+
|OOo_3.x.x_src_l10n.tar.bz2
+
|Translations of the software for many languages
+
|-
+
|OOo_3.x.x_src_extensions.tar.bz2
+
|Extensions source package
+
|-
+
|OOo_3.x.x_src_testautomation.tar.bz2
+
|Automated test suite (optional)
+
|}
+
  
For a full build you need them all. For development, the '''core''' package is usually all you need.
+
The directory structure when you have checked out the sources from svn will look like:
  
Unpack the tarballs one at a time to a directory. They will create a new directory with the name of the milestone, such as '''OOO310_m11'''. This folder will from now on be the '''$SRC_ROOT''', so set this environment variable to this path on your machine.
+
aoo/
 +
aoo/main
 +
aoo/extras
 +
aoo/test/extras
 +
aoo/ext_libraries
 +
aoo/ext_sources
  
= SCM-Access (for developers) =
+
----
 
+
<references/>
Checking out the source code from the Subversion tree can be done in the following ways.
+
 
+
''' Checking out the trunk (main development branch) '''
+
 
+
svn checkout svn://svn.services.openoffice.org/ooo/trunk
+
 
+
The files will be placed in the current directory.
+
 
+
== More information on SCM ==
+
* [[Setting up Subversion Access]]
+
 
+
* [[OOo and Subversion|Using Subversion and the new CWS Tooling]]
+
 
+
* [[Mercurial Pilot]] (Mercurial will soon replace SVN)
+
 
+
* [[OOo and Mercurial]] (Mercurial will soon replace SVN)
+
 
+
= See also =
+
 
+
* [[Building]]
+
* [[Getting the source (older versions)]]
+
 
+
= Footnotes =
+
<span id="Foot1"><sup>1</sup> It's not absolutely necessary to build own versions for these modules on Linux. If you intend to build on Linux '''without''' the '''system''' tarball:
+
* You will need to tell ./configure explicitly to use the system libraries for the software that is otherwise contained in this tarball. Otherwise the build will fail.
+
* System software is in active development. If it has changed significantly (and Mozilla sometimes does), the build may fail or OpenOffice.org may not work correctly.
+
* unowinreg.dll - Do not be fooled by the .dll extension. Without it, the build will fail on Linux and it is not included in the core package. Don't worry about downloading this now because the build process will tell you where to get it and where to stick it to proceed.
+
</span>
+
 
{{PDL1}}
 
{{PDL1}}
 +
[[Category:SVN]]

Latest revision as of 13:22, 26 November 2012

[[{{{PrevPage}}}|< Previous Page

]]

[[{{{NextPage}}}|Next Page
>]]


Requirements

  • Subversion version 1.5.4 or later

AOO's source code is managed in a subversion repository, so you need a svn client to checkout the sources. You can get subversion binaries from the subversion project. Version 1.5.4 or later is required because of important fixes related to the merge-feature.

Get the source via Subversion

You need about 4.7 GB for a checkout from the svn repository. Building the source requires another 5GB.

  • check out the latest source from svn
svn co https://svn.apache.org/repos/asf/openoffice/trunk aoo

The directory structure when you have checked out the sources from svn will look like:

aoo/
aoo/main 
aoo/extras
aoo/test/extras
aoo/ext_libraries
aoo/ext_sources

Content on this page is licensed under the Public Documentation License (PDL).
Personal tools