Building From Source 1.1

From LinuxMCE
Jump to: navigation, search

The information in this page is mainly superseeded by the build instructions for 810

Before You Begin

The build script is tested and designed to run on Ubuntu 6.10 x86 but it can be changed to work on various platforms or at least to give others a starting point on how to do it. It'll be harder to port it to non deb based distributions since the software depends on many debian specific stuff but this I hope to be change over time.

The Build Scripts

The build scripts are in sourceforge svn so to get them you will need subversion installed.

sudo apt-get install subversion
cd /root
svn co https://linuxmce.svn.sourceforge.net/svnroot/linuxmce/trunk/src/Ubuntu_Helpers

Before running the build script, i insist that you take a look over it so that you know what is doing and not run it blindly.

The main script that you need to run would be BuildUbuntu.sh. This script should checkout the svn for you, compile the source, build the packages, build an iso and everything else so you can end up with a usable linuxmce build. In this script you can find some functions that are called one by one to perform several operations, here's a short description:

  • Install_Build_Needed_Packages: This will install all the deb packages that you will need to build the sourcecode. Probably you will only need to run it once and comment it after the first run on BuildPackages.sh. This will take about 5 minutes.
  • Create Diskless Archive: Runs a debootstrap to create a base filesystem for Diskless Media Directors. It's needed later when it'll be packed in a deb packages. You also don't need to run this every time but is safer to leave it uncommented so that the diskless archive will have the latest ubuntu updates.
  • Import_Skins: Since linuxmce uses a lot of pngs for the all sort of skins, you won't find them in the svn. This function will download a tar.bz2 archive with all the skins and unpack it so that the package builder will now where to take it from.
  • Checkout_Svn: Will do a svn checkout on sourceforge to get all the needed sources
  • Build_Replacements: LinuxMCE needs some 3rd party packages that are not part of ubuntu distribution. This function will build / get them for you.
  • Build_MakeRelease_Binary: This function compiles the building tools that will do the compilation / package creation of all the other packages by using information stored in the pluto_main_build database.
  • Import_Build_Database: Imports a fresh copy of the pluto databases needed at build time.
  • Create_Fake_Windows_Binaries: Orbiter and other aplications don't only run on Linux. Usually the pluto guys compile their applications on windows and put the binaries on the linux build machine so that package creating application will know where to get them. Since we can't compile windows binaries on linux i made this function that creates some fake binary files with a touch so that the package builder won't fail to run.
  • Build_Pluto_Stuff: Uses MakeRelase to compile the sources and build packages out of them.
  • Create_Local_Repository: Optional you can create a local repository so that you can easily test your debs. By default, the local repository will be put in /var/www
  • Create_ISO: Is an optional step and creates an iso with all the needed packages for a linuxmce instalation. For this, get-packages.sh script is called. By defaul the iso will be located in /var/wwww

Source Code Location

Our source code is located on sourceforge and you can get it by svn from : https://linuxmce.svn.sourceforge.net/svnroot/linuxmce/

The png used for the skins are located here : http://www.linuxmce.com/linuxmce-skins-1.1.tar.bz2

The sql dumps of the databases needed for the build : http://www.linuxmce.com/linuxmce-databases-1.1.tar.bz2

The fake windows binaries needed for the build : http://www.linuxmce.com/linuxmce-fakewindowsbin-1.1.tar.bz2

The arch independent packages needed for the build : http://www.linuxmce.com/linuxmce-independent-pkgs-1.1.tar.bz2