The Meego Online Build System (OBS) seems rather complicated, this page will attempt to make it nice and easy to get started.

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

Contents 1 Pre-requisites 2 Setting up your home project 3 Overview 3.1 Setting up a sub-project 3.2 Creating a project 3.3 Adding repositories 3.4 Adding files to a package and building them 3.4.1 From the terminal 3.4.2 Using the webinterface

Pre-requisites

• You need a meego.com login to be able to access the OBS
• You need to be running one of the supported OSes
• 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)

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)

Overview

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 a sub-project

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

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

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"

Adding repositories

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

Adding files to a package and building them

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
  • For MeeGo this will be a .spec file and a tarball containing your source code, etc.
  • For Harmattan this will be a .dsc file, source tarball and debian.tar.gz (this allows one to keep the debian directory out of the source)

 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

Using the webinterface

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