Checkout the Code
Table of contents
Subversion Instructions
First you have to assemble all the files in their proper places before you can build Songbird.
Setting up the build system requires downloading two separate packages: the client and the proper dependencies for your particular platform. For simplicity's sake, we'll assume you're always building trunk (the latest revision)
Get Subversion
First, you'll need to get subversion for your platform:
- Windows:
- Subversion is included with MozillaBuild 1.4, a Win32 build prerequisite. (More documentation)
- IF YOUR CHECKOUT HANGS, see the Troubleshooting section at the end of this document
- For those who prefer a GUI, try TortoiseSVN for Windows
- MacOSX:
- Use the Mac-ports client (formerly Darwin-ports) to get the subversion commandline client.
sudo port install subversion
- Use the Mac-ports client (formerly Darwin-ports) to get the subversion commandline client.
- Linux:
- Use
apt-get install subversionoryum install subversionor whatever.
- Use
Get the Client Trunk
After you've got subversion, you'll need to checkout the trunk into the folder you wish to work from. For people using MSVC, you mustn't allow there to be a space in the path to the code (sorry, people who use "My Projects").
While it's downloading, take a nap.
- Commandline:
%~: mkdir sbird %~: cd sbird %~/sbird: svn co http://publicsvn.songbirdnest.com/client/trunk
- Tortoise:
- Create and open the folder into which you want to download the trunk
- Right-click in the folder and choose SVN Checkout... to bring up the checkout dialog
- Put
http://publicsvn.songbirdnest.com/client/trunkinto the repository field and hit OK.
Get the Dependencies
Then, checkout the the dependency vendor-binaries for your OS into a subfolder of the dependencies folder labelled with the platform and architecture you intend to compile against.
- Win32: dependencies\windows-i686-msvc8
- MacOSX Intel: dependencies/macosx-i686
- Linux 32bit: dependencies/linux-i686
Go get lunch or something while this runs. It will take some time.
- Windows Tortoise:
- Using Tortoise under Win32, you use the "Repo-browser" menu item when right-clicking the
dependenciesfolder. Find thevendor-binaries/trunk/windows-i686-msvc8entry in the browser and do a checkout toc:\projects\songbird\dependencies\windows-i686-msvc8(or wherever you checked out the trunk).
- Using Tortoise under Win32, you use the "Repo-browser" menu item when right-clicking the
- Windows Command Line:
%/c/projects/songbird: cd dependencies %/c/projects/songbird/dependencies: svn co http://publicsvn.songbirdnest.com/vendor-binaries/trunk/windows-i686-msvc8
- Intel MacOSX:
%~/sbird/: cd trunk/dependencies %~/sbird/trunk/dependencies: svn co http://publicsvn.songbirdnest.com/vendor-binaries/trunk/macosx-i686
- Linux 32bit:
%~/sbird/: cd trunk/dependencies %~/sbird/trunk/dependencies: svn co http://publicsvn.songbirdnest.com/vendor-binaries/trunk/linux-i686
Update the Tree
Once you've got all the files, you can use subversion to keep you up to date with our latest changes. You'll need to update both the trunk and dependencies separately, from within each folder.
You don't need to download the tree via subversion to be able to update it. Our source tarballs contain the subversion files directly in them so you can just update once you unpack them.
%~/sbird: svn up %~/sbird: cd dependencies/macosx-i686 %~/sbird/dependencies/macosx-i686: svn up
Repository URLs
- Trunk: http://publicsvn.songbirdnest.com/client/trunk/
- Vendor Binaries by Platform:
- Tags for previous Release Builds:
- 1.2
- 1.1
- 1.0
- 0.7
- 0.6
- 0.5
-
0.4
-
0.3
-
0.2.5
-
0.2.1
-
0.2
Once you've downloaded and setup your files, you're ready to build the app.
Troubleshooting
- If your Subversion client hangs on checkout, there are a couple of workarounds. We've observed this behavior both with the version of Subversion 1.4.3 on OpenSolaris x86 and looks to be due to fetching of svn:externals, which we now use to grab the relevant vendor-portion of our tree (now, its own repository).
- Workaround: Use the --ingore-externals flag to checkout/update/status commands and manager the vendor portion yourself; you can do this by going into the trunk/dependencies directory of your tree and manually checking out http://publicsvn.songbirdnest.com/vendor/dependencies/vendor/mozilla This is to be avoided if possible, since it's brittle and may break if we change the externals definition; however, if you're in a hurry and just want to get Songbird building, it's a quick-and-dirty way to get started.
svn co http://publicsvn.songbirdnest.com/client/trunk/
svn: XML data was not well-formed
My svn client works well on other repositories (Google code, for instance)
svn, version 1.6.5 (r38866)
compiled Oct 4 2009, 22:22:42
mac OS X
Any idea? edited 02:59, 18 Apr 2010
I have downloaded the songbird and dependencies trees and ran svn up for both of them.
then I downloaded the Mozilla build environment and ran:
export DEPENDS=/<local path>/songbird/trunk/dependencies/windows-i686-msvc8
export PATH=$DEPENDS/runtime/release:$PATH
export PATH=$DEPENDS/gstreamer/release/bin:$PATH
export PATH=$DEPENDS/glib/release/bin:$PATH
export PATH=$DEPENDS/mozilla/release/bin:$PATH
$DEPENDS/gstreamer/release/bin/gst-inspect.exe
I get a windows error message saying:
Runtime Error!
Program: <path to gst-inspect>
R6034
An application has made an attempt to load the C runtime library incorrectly.
My environment:
I have installed the MS SDK, the Mozilla build Environment and VS2005Express, VS2008 and VS2010RC1. I used the Mozilla build environment (for both VS2005 and VS2008) to run the instructions above with identical results.
Am I missing something or are the depenndencies broken? edited 04:47, 4 Jun 2010