openPMA:HowToDevelop

From openPMA
Jump to: navigation, search

[ it is a first draft, it will be develop ASAP. Do not hesitate to ask on openPMA-dev mailing list for problem or details ]

ONLY works on Linux environment.

BE CAREFUL!!! For x86_64 users, some compilations errors seem to happen with our environment (link problem). If you have a solution, we are open...


Contents

[edit] Get environment

ATTENTION: If you want to build aimages you have to check out as user root for now

1. Create a /data/devel/openpma directory. At the moment, you need to respect this structure, otherwise it will not work...

2. Go in this directory and checkout trunk with: svn co http://svn.openpma.org/svn/openpma/trunk, it is the trunk of openPMA. Be careful it takes at least 1.6Go.
Be sure that you are checking out on a case sensitive file system.

NB - the full trunk checkout is only for those who'd like to build their own firmware images and experiment with it.

3. Create /data/devel/openpma/branches directory

{4. Go in this directory and checkout this branch with svn co http://svn.openpma.org/svn/openpma/branches/0.1 (145Mo)}

currently this step is not necessary

Ok, you have all our environment.

More information about svn on wikipedia : http://en.wikipedia.org/wiki/Subversion_(software)

[edit] Some preparation

1. Create a /data/devel/openpma/build directory. It is where we compile stuff.

[edit] Install toolchain

If you did a full trunk checkout, install RPM packages located in /data/devel/openpma/trunk/toolchains/RPMS except xgcc (used to compile gcc).

If you didn't do a full trunk checkout or don't have subversion, you can download and install the RPMS.

More information about Toolchain : http://en.wikipedia.org/wiki/Toolchain

[edit] Compile something

We compile everything in build directory. Trunk and branch must not be used to compile!

NB - If you haven't done a full trunk checkout you can download the openPMA sources

To compile wget-1.10.2 for example:

1. Copy /data/devel/openpma/trunk/src/wget-1.10.2 directory to /data/devel/openpma/build/wget-1.10.2

cp -a /data/devel/openpma/trunk/src/wget-1.10.2 /data/devel/openpma/build/wget-1.10.2

2. Go inside /data/devel/openpma/build/wget-1.10.2

3. There is a script called build_openpma.sh (normally, there is one for each package). Launch compilation with source build_openpma.sh. (Attention Debian/Ubuntu-Users: Make sure that /bin/sh points to "bash" not "dash", otherwise its not going to work)

[edit] I want to add a new program

First put your software in /data/devel/openpma/build/mysoft, then copy an build_openpma.sh script in the root of you program. Perhaps, you need to edit it. Then launch compilation.

After that, you can copy executable files directly on your PMA.

[edit] How to build an installable ipkg

A script for building ipkg files

How to convert the ipk packages for the Zaurus into ipk packages for the PMA

Build and handle your own ipkg packages

Building ipkgs

Creating an ipk package

Building a Binary Package

Howto create "ipk" packages for the Zaurus

Software development for a Sharp Zaurus SL-5500 Linux PDA - The same principles apply to PMA development although the fine details may differ.

IPKG Howto

Qtopia installation tips and tricks

[more to come ...]

Google ads
Personal tools