Revision as of 20:00, 31 July 2011

The MeeGo Open Build System (OBS) seems rather complicated, this page will attempt to make it nice and easy to get started. See also the Mer project's documentation on application building with OBS.

It's a work in progress, feel free to add and modify!

Pre-requisites

• You need a meego.com login to be able to access the OBS
• Install osc (for example, apt-get install osc may work out-of-the-box on recent versions of Ubuntu & Debian, other repositories are available on openSUSE tools)
• As an alternative to osc you may use the web interface to upload your files

Preparations

OBS is based around projects, packages and repositories. Packages have a set of files (source code, packaging meta-data, etc.) which are compiled by build servers against particular distributions. Each distribution results in your code being available in a repository.

Setting up your home project

Your home project is like a home directory in which you can create sub-projects, repositories, etc.

• Visit the OBS page (https://build.pub.meego.com)
• Log in and click on 'create home project' (down at the bottom of the page iirc)

Creating a project

A project is required before anything can be built.

• Go to the "Projects" tab for the project in which you wish to create it
• Select "Add a new package"
• Enter a UNIX-style (all lower case) "Name"
• Enter a title-case, with appropriate spacing, "Title"
• Enter a brief "Description"
• Click "Save Changes"

Setting up a sub-project (optional)

A sub-project allows you to group related activities together.

• In the "Overview" tab for your home project, select "Actions > Create subproject".

Adding repositories

• Go to the "Repositories" tab for the project in question
• Click "Add Repository"

As Harmattan OBS support is still in development, you can add it through the advanced interface.

Adding files to a package and building them

Needed files

MeeGo

For MeeGo you need a .spec file and a tarball containing your source code, etc.

Harmattan

For Harmattan you need a .dsc file, source tarball and .debian.tar.gz (this allows one to keep the debian directory out of the source). The source is extracted using dpkg-source -x ....dsc, so restrictions on file formats apply (e.g. mypkg_1.0.0.tar.gz, mypkg_1.0.0.dsc, mypkg_1.0.0.debian.tar.gz)

Alternatively, you may just use the .dsc together with a .tar.gz file containing both, the sources and the debian directory.

Start building

From the terminal

• Checkout (like SVN) your home project, which will contain all your sub-projects and packages

 osc -A https://api.pub.meego.com co home:[username]

• Add files to your local copy

 osc add [filename]

• Commit the files

 osc commit

At this point the OBS will try to build your project remotely. You can also build locally by doing osc build

If you add new packages later on or commit changes from another computer you can update your local copy by doing

osc update

Using the webinterface

• Add the correct files as listed above and they will be automatically built for you

Installing packages

Into your MeeGo system

• Once packages are built, You can include them in your MeeGo installation.
• The general method is:

  zypper ar -f http://repo.pub.meego.com/home:/username/repository/ title
  zypper in <package>

• • Where:
  • username is your user
  • repository is the repository branch name
  • title is the name zypper will use for the repository

Into Harmattan

1. Find the repository address:
   1. Go to the appropriate project's Overview page (e.g. your home project, or sub-project)
   2. Click on the MeeGo 1.2 Harmattan repository on the Build Status
   3. Copy the link for the Download Repository

• Create /etc/apt/sources.list.d/project.list (where project is a memorable name, e.g. your username for your home project), containing the download link, prefixed with deb and suffixed by ./. For example:

 deb http://repo.pub.meego.com/home:/jaffa/Harmattan/ ./

• Run:

 apt-get update
 apt-get install package

...where package is, of course, your package name.

Updates to the installed applications will appear at Settings > Applications > Manage Applications > Updates

Into Maemo 5

Enable Extras-devel.