Get Source Code
The Cairngorm framework is one of several open-source projects in a Subversion repository hosted by Adobe. Subversion is an open-source revision control system used for many open-source projects. If you haven't used it before, please see the official documentation.
There are two ways to access the repository. You can use any web browser to see the structure of the project and view the latest version of each file. However, you must use a Subversion client to perform more complex operations such as reviewing the commit log, looking at older revisions or diffs, or checking out your own working copy to build and test.
Web browsing
To browse the Cairngorm project, go to http://opensource.adobe.com/svn/opensource/cairngorm.
Within the project are directories named trunk, branches, and tags, as is standard for Subversion projects.
The trunk is work-in-progress on the version under current development. The trunk should build and pass any basic tests in place but may be unstable and unsuitable for use.
Branches are created when projects need to stabilize code for a release.
Tags record the code that shipped as a specific release, or other milestones in a project. The code which was used to build the 2.2.1 release of the Cairngorm has been tagged as tags/2.2.1. Builds prior to 2.2.1 are not tagged in SubVersion as this is point at which Cairngorm was added to Adobe Open Source.
This site often uses the word “branch” as shorthand for “trunk, branch, or tag”.
To understand what's where inside each branch, see Cairngorm Organization.
You can access directories and files inside the project by appending them onto the project's URL. For example, to browse the frameworks directory in the trunk of the Cairngorm, you can go directly to http://opensource.adobe.com/svn/opensource/cairngorm/trunk/frameworks.
Installing a Subversion client
To get your own working copy of the source code, you'll need a Subversion client. A client will also let you see the repository structure, look at the revision history of any file or directory, diff two versions of a file, etc.
The Adobe team has had good experience with TortoiseSVN on Windows and SmartSVN on Macintosh, both of which are GUI clients. (This is not an official endorsement of these products by Adobe.) Of course, you can use whatever client you prefer, including Subversion's official command-line tool svn. We'll assume you're using svn in our instructions.
You can get the Subversion installer, which includes svn, here:
After installing svn using the Windows installer, you should be able to execute svn from any directory because it will be found on your PATH.
On Macintosh, test the installation by opening Terminal and executing:
If you get svn: command not found, then you'll need to add the /usr/local/bin directory onto your PATH, since this is where svn lives. Assuming you're using the default bash shell in Terminal, you can do this by putting the following lines into a ~/.bash_profile file:
Otherwise, you'll have to invoke svn as /usr/local/bin/svn.
Checking out code
When you access the repository with a Subversion client, the Cairngorm project is at the URL http://opensource.adobe.com/svn/opensource/cairngorm.
To get the entire source code for the project, do a "checkout" from this URL into a local directory on your machine. Using the command-line client, you would execute
If you only want the trunk, or a particular branch or tag, adjust the URL appropriately.
Building and testing
See the ReleaseNotes.txt within the Downloads for instructions on how to build Cairngorm and Cairngorm Enterprise.
Contributing to Cairngorm
If you want to contribute to the project, see Cairngorm Project Roles and Submitting a Patch.
Change notifications
If you'd like to keep up-to-date on changes to the Cairngorm project, you may subscribe to the Commits forum. Every time anyone commits a change to Cairngorm, a description of that change is posted to this forum. You can request to receive an email for each commit, or to receive a digest on a regular basis.
| You must be logged in to comment. |
|
