New Build Documentation

From Adobe Open Source Wiki
Revision as of 17:11, 9 January 2007 by FosterBrereton (Talk | contribs)

Jump to: navigation, search

This documentation is written with the ASL 1.0.23 distribution in mind.

Contents

Building ASL : Requirements

In order to build ASL, the requirements are as follows:

  1. A working IDE installation of:
    1. GCC 3.4.4 or better (cygwin)
    2. GCC 4.0.1 or better (MacOS X)
    3. MSVC 8.0 or better (Win32)
    4. MSVC 8 Express (additional instructions needed to get MSVC 8 Express ready to build ASL; Please see below.)
  2. A patched copy of Boost 1.33.1 distribution
  3. A copy of the latest ASL distribution
  4. A dose of patience

The Easy Way

If you are Inside Adobe

Within Adobe the Software Technology Lab maintains Perforce servers for distributions of both Boost and the Adobe Source Libraries. This is the preferred method of downloading ASL within Adobe, as the Boost sources are already patched and placed correctly. Please see the STLab website for more information on getting ASL this way.

The rest of this document is not for you.

Building the Libraries Automatically

Two automated net install scripts have been written to ease in the downloading and building of the Adobe Source Libraries. Given a development environment, these scripts will do all the downloading, patching and building necessary to get a working build of ASL and Adobe Begin on your computer.

The Windows version can be downloaded from http://easynews.dl.sourceforge.net/sourceforge/adobe-source/asl_1.0.23_net_setup.bat

The *NIX (including Mac OS X) version can be downloaded from http://easynews.dl.sourceforge.net/sourceforge/adobe-source/asl_1.0.23_net_setup.sh

You may only run these scripts from a directory having no spaces or unusual characters in the path. This is due to a bjam restriction that will cause some of the tests to fail during the build process.

Please also be aware that the script requires use of FTP and HTTP. If you are behind a firewall or cannot otherwise use FTP, the scripts will not work.

The rest of this document is not for you.

The Other Way

Obtaining and Patching Boost

The Boost 1.33.1 distribution can be downloaded from http://sourceforge.net/project/showfiles.php?group_id=7586

Patching Boost

Decompress the Boost distribution and move the resulting directory to:

   ~/adobe-source/third_party/boost_tp/

The folder should be named boost resulting in the structure:

   ~/adobe-source/third_party/boost_tp/boost/

Boost must be patched with a small number of minor changes. A patchfile with those changes can be found at:

   ~/adobe-source/third_party/boost_tp/adobe/boost_1_33_1_patch_01.txt

Patching under *nix

You can use the Unix patch command to make the necessary changes, but first make sure all the line endings in the affected files are Unix line endings. To use the supplied patch under Unix issue the following command:

   ~/adobe-source/third_party/boost_tp/adobe/patch_boost.sh

Patching under Win32

Win32 users can use the patchfile provided, but there are some caveats. First, the patchfile is distributed with Unix line endings, which must first be converted to DOS line endings. If you do not have a program to accomplish this, there is a small command line tool called leconv that will do this for you. It is in:

   ~/adobe-source/adobe/tools/

The GNUWin32 project has made a version of patch for Win32. It can be obtained at http://sourceforge.net/projects/gnuwin32

If you already use boost build, please make sure that the adobe version of bjam will be the one found in your path, since ASL relies on patched support files found relative to the bjam executable.