Editing Mer/Build/Application Building

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Learn more about Contributing to the wiki.

This page assumes you have [[../Install OBS|installed OBS]] and setup an account.

The objective is to walk through creating a package on OBS that you can download to your Mer device using the package manager.

We will use MerPad as an example

You can follow either the CLI or www commands; if you mix them up you need to ensure you execute the commands in the right place.

== To create a new package ==

These osc commands are done in your own area - use your username after "home:" or make sure you are at your [https://build.opensuse.org/project/list_my "Home Project"] on OBS.

Before you can create projects in your home project, you have to create it.

We will use
* a name of "merpad" (lowercase); this is the ''package'' name
* a title of "MerPad Example"; this is the human readable title
* a description of: "A Mer version of Maemopad. Built on OBS by <yourname>"; this is seen upon installation

If you use the CLI interface you can also enter a url.

Obviously, if you have your own source and dsc then amend the details accordingly.

==Configure your Home Project to Build against Mer==
When you upload some source the build-dependencies need to be resolved.  OBS does this by looking at a build target repository; if the dependency isn't there and that repository has its own build target repository then it looks there... and so on.

So Maemo:Mer:Stable has a build target of Ubuntu_9.04.

However, if you built against :Stable then you'd miss any community libraries in :Extras. So we will setup your home to build against :Extras:Stable

This means that build dependencies will be looked for in:
# Maemo:Mer:Extras:Stable
# Maemo:Mer:Stable
# Ubuntu_9.04

Once this is done, any packages uploaded to this project will build.

===Setting up Build Repositories : WWW===
* Click on "Home project" in the left navigation bar in the OBS website
* On the right click on "Add Repository"
* At the bottom, click on "Advanced"
* Use the name "MerExtrasStable_MerStable_Ubuntu_9.04" (this is important)
* In the (huge!) "Build Target Selection" scrollbox, select "Maemo:Mer:Extras:Stable/MerStable_Ubuntu_9.04"
* In the tickboxes, pick "i586" and "armv5el"
* Click "Save Changes"

If you want to build against Mer:Testing and Mer:Devel aswell then use the XML interface to ensure you get it right.

===Setting up Build Repositories : CLI===
To change the build target repositories (part of the project metadata):
  osc meta prj home:yourname -e

The XML should look like this (make sure you use your own "name=" value) paying special attention to the <code><repository></code> tags:
<pre>
<project name="home:yourname">
  <title>yourname's Home Project</title>
  <description>Mer is cool</description>
  <person userid="yourname" role="maintainer"/>
  <person userid="yourname" role="bugowner"/>
  <repository name="MerExtrasStable_MerStable_Ubuntu_9.04">
    <path project="Maemo:Mer:Extras:Stable" repository="MerStable_Ubuntu_9.04"/>
    <arch>armv5el</arch>
    <arch>i586</arch>
  </repository>
</project>
</pre>

Here is a full set of [[/XML_Build_Targets|XML Build targets]] for Ubuntu; they aren't needed unless you're doing something clever.

==Creating Package==
Each package has its own directory in the project and, by default, is built against any build targets for the project.

===Creating Package : WWW===
* Click on "Home project" in the left navigation bar in the OBS website
* Click on "Add Package"

Note that the 'name' is like a filename (openoffice) whereas 'title' is written out. (Open Office)

(In the XML the name is also fully qualified with a project and :s )

Fill in the values in the boxes and save changes; we'll use:
  Name: merpad
  Title : merpad
  Description : A test build of Merpad

===Creating Package : CLI===
Run
 osc meta pkg -e home:<username> <package>
This will tell the OBS server about the package. It pops up an editor where you can edit the name/description in XML format and then save. The XML appears like this:
<pre>
<package name="merpad">
  <title>Title of New Package</title>
  <description>
LONG DESCRIPTION 
GOES 
HERE
  </description>
  <person role="maintainer" userid="username"/>
  <person role="bugowner" userid="username"/>
  <url>PUT_UPSTREAM_URL_HERE</url>
</package>
</pre>
and fill it in:
<pre>
<package name="merpad">

<title>MerPad Example</title>

<description>
A Mer version of Maemopad.
Built on OBS by David.
  </description>

<person role="maintainer" userid="username"/>
  <person role="bugowner" userid="username"/>
  <url>PUT_UPSTREAM_URL_HERE</url>
</package>
</pre>

==Uploading Source==
===Uploading Source : WWW===
From your Home Project, you should see a "merpad" entry under Packages.
Select merpad to go to the Package page (you may already be there if you just created it).

Now click [Add File] and upload the tar.gz and then do it again for the dsc files.

Use these files:
  http://www.dgreaves.com/pub/merpad_1.0-1.dsc
  http://www.dgreaves.com/pub/merpad_1.0-1.tar.gz

===Uploading Source : CLI===

To get a local (empty) copy make sure you're at your obs root (eg <code>~/maemo/Mer/obs</code>)

Then run
 osc co home:<username>/merpad

(If you were already in <code>~/maemo/Mer/obs</code> then <code>co merpad</code> would work.. beware, nothing stops you checking out a project inside a project!)

This makes a package directory so now you can:
 cd home:<username>/<package>

Once there you can copy in the tarball and dsc file from your application... or in this tutorial we'll get them from the web.
 wget   http://www.dgreaves.com/pub/merpad_1.0-1.dsc
 wget   http://www.dgreaves.com/pub/merpad_1.0-1.tar.gz

Then add them to version control
 osc addremove

The addremove command is a shortcut... it removes any files from OBS that are no longer in the directory and then adds any that are there. Typically you just delete old tarballs and dsc files and run osc addremove. If you prefer osc has an explicit add command.

Now they are ready to be uploaded or comitted:
 osc commit

This will send the source and dsc to the builder and trigger a build.

==Monitoring the Build==

The OBS builder will now schedule and build the application.

Please note that for security reasons the builder is running inside an emulator which is 'killed' when it is finished; so there are alarming messages like <code>Kernel panic - not syncing: Attempted to kill init!</code> and some <code>qemu: Unsupported syscall</code> messages. These can safely be ignored and will be cleaned up one day.

===Following the build log : WWW ===
In the package page under the build target is a [Build Log] entry.
This takes you to a page showing the build log. There are tickboxes to refresh automatically and to autoscroll.

===Following the build log : CLI ===
To watch what is going on on the cli:
 osc buildlog MerExtrasStable_MerStable_Ubuntu_9.04 armv5el

This does something like a "tail -f" of the builder.

Tip: If you can't recall what the names of the targets are then:
  osc repos
will tell you.

==Downloading the Binaries==
Once OBS has run you can download the binaries and install them by hand.

===Getting the binaries : WWW===

In the build status is a link to the .deb file. Notice this is an https link and you need to be logged-in.

===Getting the binaries : CLI===

Simply run:
  osc getbinaries MerExtrasStable_MerStable_Ubuntu_9.04 armv5el
in the package directory.

==Using your repository==

OBS takes a while (up to several hours if busy) to publish and update repositories; however once it is done the final (optional) step is to add an entry to your tablet to use the OBS repository for your project.

Create a file called <code>/etc/apt/sources.list.d/MyOBS.list</code> and add the following line (using your name):
  deb http://download.opensuse.org/repositories/home:/yourname/MerExtrasStable_MerStable_Ubuntu_9.04/ /

Then running the application manager should show your MerPad.

=Local Builds=
OBS lets you run a local build on your desktop.

Simply checkout a package:
  osc co home:username/merpad

and run:
  cd home:username/merpad
  osc build MerExtrasStable_MerStable_Ubuntu_9.04 armv5el merpad_1.0-1.dsc

Then wait...

This goes to the server to determine where to get the build-depends (remember the build-target stack) and then downloads them to a local cache. Eventually it installs a bootstrap set to a directory and then does a qemu chroot into it and builds the package.

Note that the following 2 python modules may be required
 apt-get install python-m2crypto
 apt-get install python-urlgrabber

Once it is done you should get a line telling you where the deb is:
  /scratch3/maemo/Mer/obs/build-MerExtrasStable_MerStable_Ubuntu_9.04-armv5el-merpad/usr/src/packages/DEBS/merpad_1.0-1_armel.deb

It will ask for a password at one stage.  You can use your local root password for this.   If you get an error complaining about a lack of /usr/lib/common_functions, then create a folder in your home folder, cd into it, and then follow the instructions [http://gitorious.org/mer/build HERE] .  they should ask you to run the command

git clone git://gitorious.org/mer/build.git

in that folder.  This will use git to download a newer 'build' tool for you.  See the pageafter it has finished, run ''make install'' to install the tool, and then go back and run the osc build step again.  It should continue from the password prompt step successfully this time.

You can also do:
  sudo chroot /scratch3/maemo/Mer/obs/build-MerExtrasStable_MerStable_Ubuntu_9.04-armv5el-merpad/ su abuild
and once there, run arm commands inside the chroot.

== Co-existing with Scratchbox ==

If you use the OBS local build facility and the scratchbox-1 local builder then you need to know how to teach the two emulators how to co-exist.

Both OBS and Scratchbox use [http://git.kernel.org/gitweb.cgi?p=linux/kernel/git/torvalds/linux-2.6.git;a=blob;f=Documentation/binfmt_misc.txt;hb=HEAD binfmt_misc] to cause the kernel to invoke (in our case) qemu when it comes across an armel binary.

To disable qemu and enable sbox
  echo 0 > /proc/sys/fs/binfmt_misc/arm
  echo 0 > /proc/sys/fs/binfmt_misc/armeb
  echo 1 > /proc/sys/fs/binfmt_misc/sbox-arm
  echo 1 > /proc/sys/fs/binfmt_misc/sbox-armeb

To disable sbox and enable arm
  echo 1 > /proc/sys/fs/binfmt_misc/arm
  echo 1 > /proc/sys/fs/binfmt_misc/armeb
  echo 0 > /proc/sys/fs/binfmt_misc/sbox-arm
  echo 0 > /proc/sys/fs/binfmt_misc/sbox-armeb

Don't do this whilst a build is in progress!

Note that you may need to run :
  qemu-binfmt-conf.sh
to register qemu to handle arm binaries

A typical error signifying you have this issue is
  Exec format error
which means the kernel doesn't understand the binary format of the executable.

Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!

Summary:

Cancel | Editing help (opens in new window)

Templates used on this page:

Template:Ambox (view source) (semi-protected)
Template:Mer (view source) (semi-protected)

Retrieved from "http://wiki.maemo.org/Mer/Build/Application_Building"

Personal tools

Navigation

Views

Editing Mer/Build/Application Building

@@ Line 25: / Line 25: @@
 ==Configure your Home Project to Build against Mer==
 When you upload some source the build-dependencies need to be resolved.  OBS does this by looking at a build target repository; if the dependency isn't there and that repository has its own build target repository then it looks there... and so on.
@@ Line 40: / Line 39: @@
 ===Setting up Build Repositories : WWW===
 * Click on "Home project" in the left navigation bar in the OBS website
 * On the right click on "Add Repository"
@@ Line 52: / Line 50: @@
 ===Setting up Build Repositories : CLI===
 To change the build target repositories (part of the project metadata):
    osc meta prj home:yourname -e
 The XML should look like this (make sure you use your own "name=" value) paying special attention to the <code><repository></code> tags:
-<source lang="xml">
+<pre>
 <project name="home:yourname">
    <title>yourname's Home Project</title>
@@ Line 69: / Line 66: @@
    </repository>
 </project>
-</source>
+</pre>
 Here is a full set of [[/XML_Build_Targets|XML Build targets]] for Ubuntu; they aren't needed unless you're doing something clever.
 ==Creating Package==
 Each package has its own directory in the project and, by default, is built against any build targets for the project.
 ===Creating Package : WWW===
 * Click on "Home project" in the left navigation bar in the OBS website
 * Click on "Add Package"
@@ Line 92: / Line 87: @@
 ===Creating Package : CLI===
 Run
   osc meta pkg -e home:<username> <package>
 This will tell the OBS server about the package. It pops up an editor where you can edit the name/description in XML format and then save. The XML appears like this:
-<source lang="xml">
+<pre>
 <package name="merpad">
    <title>Title of New Package</title>
@@ Line 124: / Line 118: @@
    <url>PUT_UPSTREAM_URL_HERE</url>
 </package>
-</source>
+</pre>
 ==Uploading Source==
 ===Uploading Source : WWW===
 From your Home Project, you should see a "merpad" entry under Packages.
 Select merpad to go to the Package page (you may already be there if you just created it).
@@ Line 172: / Line 164: @@
 ===Following the build log : WWW ===
 In the package page under the build target is a [Build Log] entry.
 This takes you to a page showing the build log. There are tickboxes to refresh automatically and to autoscroll.
@@ Line 187: / Line 178: @@
 ==Downloading the Binaries==
 Once OBS has run you can download the binaries and install them by hand.
@@ Line 209: / Line 199: @@
 Then running the application manager should show your MerPad.
-==Local Builds==
+=Local Builds=
 OBS lets you run a local build on your desktop.
@@ Line 241: / Line 231: @@
 and once there, run arm commands inside the chroot.
-=== Co-existing with Scratchbox ===
+== Co-existing with Scratchbox ==
 If you use the OBS local build facility and the scratchbox-1 local builder then you need to know how to teach the two emulators how to co-exist.