Mer/Build/Application Building
(→To create a new package) |
(→Creating Package : WWW) |
||
| Line 74: | Line 74: | ||
* Click on "Home project" in the left navigation bar in the OBS website | * Click on "Home project" in the left navigation bar in the OBS website | ||
* Click on "Add Package" | * 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. | Fill in the values in the boxes and save changes. | ||
Revision as of 21:56, 30 June 2009
This page assumes you have 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.
Contents |
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 "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 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:lbt -e
The XML should look like this (make sure you use your own "name=" value) paying special attention to the <repository> tags:
<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>
Here is a full set of 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.
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:
<package name="merpad"> <title>Title of New Package</title> <description> LONG DESCRIPTION GOES HERE </description> <person role="maintainer" userid="lbt"/> <person role="bugowner" userid="lbt"/> <url>PUT_UPSTREAM_URL_HERE</url> </package>
and fill it in:
<package name="merpad"> <title>MerPad Example</title> <description> A Mer version of Maemopad. Built on OBS by David. </description> <person role="maintainer" userid="lbt"/> <person role="bugowner" userid="lbt"/> <url>PUT_UPSTREAM_URL_HERE</url> </package>
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 ~/maemo/Mer/obs)
Then run
osc co home:<username>/merpad
(If you were already in ~/maemo/Mer/obs then co merpad 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 Kernel panic - not syncing: Attempted to kill init! and some qemu: Unsupported syscall 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 /etc/apt/sources.list.d/MyOBS.list 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/maemopad
and run:
cd home:username/maemopad 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.
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
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 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