Abstract
Abstract Developer Center
docs.aasii.org

Build

From ADC

PrevUpNext

Contents

Prepare MozBuild for Abstract

If you have a mozilla source tree, you can skip the rest of this section. The tree should be clean, or the build system won't work.

   cd /path/to/mozilla

If you cannot or don't want to use the whole mozilla tree, mozbuild-1.9b2.tar.bz2 file in this project downloads on SourceForge contains all the files needed to build abstract.

   tar -xjf mozbuild-1.9b2.tar.bz2
   cd mozbuild

Get Sources

Abstract source code can be downloaded in one of the three ways: a tarball with a snapshot of the HEAD of abstract main git repo, a checkout from subversion mirror, an import of main git repo. All three ways are discussed below. Each results in sources being in the abstract subdirectory of the present directory.

Git Snapshot

Use this if you are not going to track abstract source code at the regular basis. This method allows to minimize bandwidth usage in case of a single download

Use wget to download the snapshot and save it to abstract.tgz. Notice '\' before ';' Or you can just point your browser to the link above

   wget -O abstract.tgz http://repo.or.cz/w/abstract.git?a=snapshot\;h=HEAD

Extract download tarball

   tar -xzf abstract.tgz

Rename extracted directory

   mv abstract.git abstract

Subversion Checkout

Use this way only if you cannot install git or hg. Subversion checkouts reduce bandwidth usage compared to snapshot downloading if you track abstract tree. But if you decide to create a patch, you will be limited to diff between BASE and your working tree. Even if don't want to patch abstract, git is times or even order of magnitude faster at checking out HEAD revision.

Checkout HEAD revision of Abstract Subversion mirror

   svn checkout https://abstract.svn.sf.net/svnroot/abstract

Mercurial Clone

Since March 2007, mozilla.org is keeping a Mercurial (hg) mirror of its trunk cvs branch. Mercurial is very close to git by performance and set of features. At the moment, Mercurial is perceived as better supporting w32 than git. However, hg branches are not even close as cheap and easy as git ones - official way is to clone repository to create a branch.

Clone Abstract mercurial mirror

   hg clone http://hg.aasii.org/abstract/

Git Clone

This is the recommeneded way to get abstract sources. After the first checkout, you receive complete project history. After that you don't need network connection to carry out most source code management tasks like branching, merging, examining history and so on. And when you connect for update, git calculates and transfers (close to) minimal set of objects, so that you again have complete project history.

Clone Abstract main git repository

   git-clone git://repo.or.cz/abstract.git

Run Build

By now you should have XULRunner ready. You can configure abstract to your taste, but if you don't have special preferences, just run supplied bootstrapping makefile:

   cd /path/to/abstract
   make -f check.mk

If everything goes smooth, congratulations. You have just built and tested abstract mainstream branch.

Solving build issues

Mozilla can be tricky to build. We are ready to help with it. If abstract build fails, check that you can actually Build Xulrunner. If the problem is with xulrunner, file a bug with product knowledge base and component mozilla. If it is purely abstract, use abstract/structure.

PrevNext
Retrieved from "http://docs.aasii.org/Build"