NeoOffice Build Instructions

From NeoWiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 19:17, 28 February 2010 (edit)
Sardisson (Talk | contribs)
(update some other outdated info, but maybe the time for this page has passed?)
← Previous diff
Revision as of 00:50, 13 September 2010 (edit) (undo)
Sardisson (Talk | contribs)
(update this page; move 2.x stuff to legacy section)
Next diff →
Line 9: Line 9:
http://www.neooffice.org/neojava/build.php<!-- (instructions for 2.0 Alpha PowerPC [http://www.neooffice.org/neojava/earlyaccessbuild.php here])-->. http://www.neooffice.org/neojava/build.php<!-- (instructions for 2.0 Alpha PowerPC [http://www.neooffice.org/neojava/earlyaccessbuild.php here])-->.
-The latest NeoOffice 3.0.x build configuration information can be found by selecting the "download" link for the most current revision of <tt>[http://anoncvs.neooffice.org/cgi-bin/cvsweb/neojava/README.txt neojava/README.txt]</tt> in cvsweb. <!--'''N.B.''' As of 2008-09-21, NeoOffice 3.0 Early Access will not yet build successfully.-->+The latest NeoOffice 3.x build configuration information can be found by selecting the "download" link for the most current revision of <tt>[http://anoncvs.neooffice.org/cgi-bin/cvsweb/neojava/README.txt neojava/README.txt]</tt> in cvsweb. <!--'''N.B.''' As of 2008-09-21, NeoOffice 3.0 Early Access will not yet build successfully.-->
- +
-Because building NeoOffice 2.2.x requires building [[OpenOffice.org_Mac_OS_X_%28X11%29|OpenOffice.org/X11]], you might find the [http://porting.openoffice.org/mac/build_680_X11.html OpenOffice.org 2.0.x for Mac OS X build instructions] helpful. The latest NeoOffice 2.x build configuration information can be found by selecting the "download" link for the most current revision of <tt>[http://anoncvs.neooffice.org/cgi-bin/cvsweb/neojava/README.txt?only_with_tag=NeoOffice-2_2_6_branch neojava/README.txt]</tt> on the <tt>NeoOffice_2_2_6_branch</tt> in cvsweb.+
====Prerequisites==== ====Prerequisites====
Line 40: Line 38:
<u>Current</u> <u>Current</u>
-'''Release''' (''NeoOffice 3.0.2''): <tt>NeoOffice-3_0_2 NeoOffice</tt>+'''Release''' (''NeoOffice 3.1.2''): <tt>NeoOffice-3_1_2 NeoOffice</tt>
-'''Stable Branch''' (''3.0.2 <!--Early Access--> Branch''<!--''none currently''-->): <tt>NeoOffice-3_0_2_branch NeoOffice</tt>+'''Stable Branch''' ( <!--''3.1.2 Early Access Branch''-->''none currently''<!---->): <!--<tt>NeoOffice-3_0_2_branch NeoOffice</tt>-->
-'''Development''' (''upgrade to OpenOffice.org 3.1.x codebase''): <tt>HEAD NeoOffice</tt>+'''Development''' (<!--''upgrade to OpenOffice.org 3.1.x codebase''-->''none currently''): <!--<tt>HEAD NeoOffice</tt>-->
<u>Legacy</u> <u>Legacy</u>
Line 58: Line 56:
====Build Matrix==== ====Build Matrix====
-{| width="75%" cellspacing="2" style="text-align: right;"+{| width="95%" cellspacing="2" style="text-align: right;"
|- style="border-bottom: 2px solid black;" |- style="border-bottom: 2px solid black;"
-! Build Host<br>Neo Version !! 10.3.9 !! 10.4.x PPC !! 10.4.x Intel !! 10.5.x PPC !! 10.5 Intel+! Build Host<br>Neo Version !! 10.3.9 !! 10.4.x PPC !! 10.4.x Intel !! 10.5.x PPC !! 10.5 Intel !! 10.6 Intel
|- |-
-! NeoOffice 2.2.x<!--<br>Early Access-->+! width=12% | NeoOffice 2.2.x<!--<br>Early Access-->
-| style="background-color: red" | '''Will not build''' || style="background-color: #0C3;" | gcc 3.3<br>''Xcode 2.4.1''<br>'''official builds''' || style="background-color: #0C3;" | gcc 4.0.1<br>''Xcode 2.4.1''<br>'''official builds''' || style="background-color: red;" | '''Will not build''' || style="background-color: red;" | '''Will not build'''+| style="background-color: red;" width=15% | '''Will not build''' || style="background-color: #0C3;" width=15% | gcc 3.3<br>''Xcode 2.4.1''<br>'''official builds''' || style="background-color: #0C3;" width=15% | gcc 4.0.1<br>''Xcode 2.4.1''<br>'''official builds''' || style="background-color: red;" | '''Will not build''' || style="background-color: red;" | '''Will not build''' || style="background-color: red;" | '''Will not build'''
|- |-
! NeoOffice 3.0.x ! NeoOffice 3.0.x
-| style="background-color: red" | '''Will not build<br>Will not run''' || style="background-color: #0C3;" | gcc 4.0.1<br>''Xcode 2.5'' <br>'''official builds''' || style="background-color: #0C3;" | gcc 4.0.1<br>''Xcode 2.5'' <br>'''official builds''' || style="background-color: orange" | '''Not supported''' || style="background-color: orange" | '''Not supported'''+| style="background-color: red" | '''Will not build<br>Will not run''' || style="background-color: #0C3;" | gcc 4.0.1<br>''Xcode 2.5'' <br>'''official builds''' || style="background-color: #0C3;" | gcc 4.0.1<br>''Xcode 2.5'' <br>'''official builds''' || style="background-color: orange" | '''Unlikely to build<br>(building not supported)''' || style="background-color: orange" | '''Unlikely to build<br>(building not supported)''' || style="background-color: orange" | '''Unlikely to build<br>(building not supported)'''
|} |}
Line 112: Line 110:
===Legacy Builds=== ===Legacy Builds===
 +
 +If you want to build NeoOffice 2.x, the following information may be helpful:
 +
 +* [http://porting.openoffice.org/mac/build_680_X11.html OpenOffice.org 2.0.x for Mac OS X build instructions]
 +* The latest NeoOffice 2.x build configuration information can be found by selecting the "download" link for the most current revision of <tt>[http://anoncvs.neooffice.org/cgi-bin/cvsweb/neojava/README.txt?only_with_tag=NeoOffice-2_2_6_branch neojava/README.txt]</tt> on the <tt>NeoOffice_2_2_6_branch</tt> in cvsweb.
If you want to build NeoOffice 1.2.x, the following information may be helpful: If you want to build NeoOffice 1.2.x, the following information may be helpful:

Revision as of 00:50, 13 September 2010

N.B. If you redistribute your personal builds, you must remove all instances of the NeoOffice trademark (including those present within graphics) in order to be in compliance with the NeoOffice Distribution & Trademark Usage Policy. Distribution of non-official builds using the NeoOffice trademark is prohibited.

Contents

Building and Developing NeoOffice

Supplemental information about building NeoOffice and the NeoOffice development process

Build Instructions

Patrick Luby maintains the NeoOffice build instructions at http://www.neooffice.org/neojava/build.php.

The latest NeoOffice 3.x build configuration information can be found by selecting the "download" link for the most current revision of neojava/README.txt in cvsweb.

Prerequisites

See the official build instructions and, for NeoOffice 3.x or 2.x builds, the latest neojava/README.txt file in cvsweb as described above.

Getting Help

Archives of the mac@porting.openoffice.org mailing list are useful; you can search them for errors you encounter.

You can also post questions in the NeoOffice Development forum on trinity (and search it for errors), but be aware that the NeoOffice developers consider the process of compiling OpenOffice.org (even as a subset of NeoOffice) as a "trial by fire" and little hand-holding is available.

Experience has shown that those who are unable to work through the OpenOffice.org build will be unable to do the debugging and other work necessary when fixing an existing bug in OpenOffice.org or NeoOffice or adding new code/features. (Such "hand-holding" also cuts into the limited time the volunteer developers have to fix actual bugs and improve Mac OS X integration.)

Building OpenOffice.org on the Mac (and by extension NeoOffice) is often difficult because there is always some change to the code for Linux or Windows that makes OOo no longer buildable on Mac OS X. While Sun's engineers do now build on Mac OS X, they do not build for PPC, so changes for Windows or Linux can still easily break the build on Mac OS X and go undetected.

Source Code

The very latest NeoOffice source code is always available in cvs (anoncvs syncs with the secure master repository every three hours beginning at 12:00 AM Pacific [PST/PDT] time).

You can also browse the NeoOffice source online.

CVS tags

for use in the cvs checkout commands in the NeoOffice Build Instructions; in the format tag modulename

A "release" tag checks out the code of a full release or milestone version (e.g., NeoOffice 1.2 Alpha) as available on NeoOffice.org but does not include any subsequent patches or bugfixes. A "stable branch" tag will check out the latest code for an active branch, including any code delivered in any released patches and any code recently committed to fix bugs (a "stable branch" that is current may have future milestones or releases based on it, e.g. the 1.2 Branch will be the basis of NeoOffice 1.2 Beta and NeoOffice 1.2 "final", and perhaps even a "point" release like NeoOffice 1.2.1, at some point). A "development" tag is the site of ongoing future development and may not even build yet. You can find additional "legacy" tags by browsing cvsweb.

Current

Release (NeoOffice 3.1.2): NeoOffice-3_1_2 NeoOffice

Stable Branch ( none currently):

Development (none currently):

Legacy

Release (NeoOffice 2.2.6): NeoOffice-2_2_6 NeoOffice

Stable Branch (2.2.6 Branch): NeoOffice-2_2_6_branch NeoOffice


Warning! (click icon for its license info) Please note the installer packages for NeoOffice/J 1.1, all older versions of NeoOffice/J, and NeoOffice 1.2.1 and below are subject to a rare but serious bug in the Mac OS X Installer on certain versions of Mac OS X. It is recommened that you do not use (or attempt to install) these versions of NeoOffice or NeoOffice/J, and they should not be distributed. See this page for more information.

Build Matrix

Build Host
Neo Version
10.3.9 10.4.x PPC 10.4.x Intel 10.5.x PPC 10.5 Intel 10.6 Intel
NeoOffice 2.2.x Will not build gcc 3.3
Xcode 2.4.1
official builds
gcc 4.0.1
Xcode 2.4.1
official builds
Will not build Will not build Will not build
NeoOffice 3.0.x Will not build
Will not run
gcc 4.0.1
Xcode 2.5
official builds
gcc 4.0.1
Xcode 2.5
official builds
Unlikely to build
(building not supported)
Unlikely to build
(building not supported)
Unlikely to build
(building not supported)

Forum Threads

The following threads or posts from trinity may contain useful tips for beginners wishing to build NeoOffice:

Along those lines, the NeoOffice developers also build the OpenOffice.org dependencies themselves rather than relying on Fink or DarwinPorts.
N.B. the above threads apply to the NeoOffice/J 1.1 release; the build requirements have changed slightly beginning with NeoOffice 1.2 Alpha.
These changes have all been committed to HEAD and the NeoOffice 1.2 Alpha codebase, but there are some helpful tips about the NeoOffice build system and cvs in the later pages of the thread.

Development Plans

NeoOffice development plans are usually outlined in the NeoOffice Development forum on trinity.

You can also check the bugs marked New/Deferred in Bugzilla to see specific items the developers plan on implementing as time and resources permit.

Ed Peterlin also maintains a set of specifications for adding Mac-specific features (or, things he'd like to add, if he ever gets time after adding Aqua widgets!).

Other Tasks

Help is always welcome in debugging and fixing existing bugs; check the Unconfirmed and Reopened bugs (the Assigned ones are generally being worked upon by the developer in question). For more information about working in the NeoOffice Bugzilla, see the Life-cycle of a Bug section of the Bugzilla Guide.

Legacy Builds

If you want to build NeoOffice 2.x, the following information may be helpful:

If you want to build NeoOffice 1.2.x, the following information may be helpful:

N.B. Distribution of non-current versions NeoOffice is prohibited by the NeoOffice CD Distribution & Trademark Usage Policy if the software is branded as “NeoOffice”.


This article in other languages: Français Nederlands
Personal tools