SHR Development
From Openmoko
Contents |
New way (using FSO Makefile)
There is a new (much simpler) way to build SHR that is under construction right now.
First build
- Download the FSO Makefile and common directory from Bearstech (see README for details).
- Apply this patch
$ make setup $ cd shr-unstable $ make image
Making changes
Go into the directory for the project you wish to change (e.g. openmoko-dialer3) and make your changes.
$ cd shr-unstable $ . setup-env (only once per session) $ bitbake -c clean openmoko-dialer3 $ bitbake -c compile openmoko-dialer3
If you are satisfied with your changes and want to create a new SHR image:
$ make image
Updating from other people's changes
- svn update in the SHR root directory
- make shr-image
Old way
Building openmoko-dialer3
Currently this is the only package of any size being developed for SHR, and it's the only one with any instructions. If you start another SHR project (please check with Bobby before starting one), put instructions for working on the project here!
Before beginning
You must build openembedded before you can build SHR packages. The easiest way is to go to http://wiki.openmoko.org/wiki/Mokomakefile and build using the instructions for FSO.
* Note: if building FSO fails using MokoMakefile (zhone! or no dbus show up on the top of the newly booted image), try using this method: http://wiki.openmoko.org/wiki/FSO
The rest of these instructions are written assuming that you used Mokomakefile and that the directory you downloaded the base Makefile into (using wget) is $MOKO.
You must also download the SHR code using subversion. See http://projects.openmoko.org/projects/shr. We will refer to the directory to which you downloaded the project as $SHRSVN. (This directory should contain $SHRSVN/packages/openmoko-dialer3.bb)
Set up your BBPATH
export BBPATH=.:$MOKO/openembedded/:$MOKO/bitbake/:$MOKO/:$SHRSVN/trunk/packages/
Set up the CACHE
export CACHE=tmp/cache
Set up your local.conf
Edit $MOKO/build/conf/local.conf and append the following lines:
BBFILES += "$SHRSVN/trunk/packages/*.bb $MOKO/openembedded/packages/*/*.bb" SELECTED_OPTIMIZATION = "-Os -g"
Note: Spaces are important in your bitbake conf files! You must have spaces before & after the = or +=
(Environment variables, $SHRSVN and $MOKO, can not be used inside local.conf, so absolute paths must be used instead)
Set up your openmoko.conf (if using 2007.2)
Edit $MOKO/openembedded/conf/distro/openmoko.conf
and make sure that these Gtk+ options are set:
# Select package versions we want to use. PREFERRED_PROVIDER_gtk+ = "gtk+-fastscaling" PREFERRED_VERSION_gtk+-fastscaling = "2.10.14"
Add your cross-compiler to your PATH
export PATH=$MOKO/build/tmp/cross/bin/:$MOKO/build/tmp/staging/x86_64-linux/usr/bin:$PATH
Run bitbake
(Don't forget to source the setup-env file in the shell before running bitbake)
bitbake openmoko-dialer3
After the first time you build successfully, you can build with
bitbake -b openmoko-dialog3_svn
which is much faster.
To recompile, and only recompile
bitbake -c compile -b $SHRSVN/trunk/packages/openmoko-dialer3.bb
Troubleshooting
General
One thing to try is to unset all environment variables not listed in this page. LIBPATH and INCLUDE can be particularly troublesome.