openPMA:HowToDevelop

From openPMA

[ 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...

1 Get environment
2 Some preparation
3 Install toolchain
4 Compile something
5 I want to add a new program
6 How to build an installable ipkg

[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.