View source for Development/Porting Packages

= Porting / Creating packages =

If you're looking at creating your own package, or porting software, the first things to do are:

# Check if someone already ported the package (if it in the repository? Is there an issue for it?)
# Check if there already are Debian packaging scripts/files. Debian packages a LOT of software, so it's likely that the software is already in the Maemo repository, or someone at least has build scripts for it.
# (TODO)

= Porting existing Maemo Fremantle packages =

Maemo Fremantle ("Nokia Maemo for the N900") contains a lot of packages that are open source. Most of them should run with very few changes on Maemo Leste, the main changes you will need to make will be:

# Check if someone already ported the package (if it in the repository? Is there an issue for it?)
# Updating of the Debian packaging files/scripts.
# Porting to newer libraries if old libraries are used (OpenSSL 0.9.8 -> OpenSSL 1.1.x, Qt4 -> Qt5, etc)
# Fixing any compile errors/warnings due to more strict compile flags

Source of the packages can be found at one of these places:

* http://maemo.org/packages/
* https://garage.maemo.org/
* http://repository.maemo.org/extras/pool/fremantle/free/source/

= Example =

== Getting the source package ==
Let's say we'd like to port a package "msid". 

it's here: <pre>http://repository.maemo.org/extras/pool/fremantle/free/source/m/msid/</pre>

get the latest version:

<pre>
wget http://repository.maemo.org/extras/pool/fremantle/free/source/m/msid/msid_0.4.8-2.tar.gz
</pre>

<pre>
tar zxvf msid_0.4.8-2.tar.gz
cd msid-0.4.8
</pre>

== Creating new repo ==

init a git repo:

<pre>
git init
git add *
git commit -a -m "initial commit from fremantle sources"
</pre>

change content of `debian/compat` to `9`.

edit <pre>debian/changelog</pre>.

let's say the last release was:

<pre>
msid (0.4.8-2) unstable; urgency=low
</pre>

now the release should be:

<pre>
msid (0.4.8-2+leste1) unstable; urgency=low
</pre>

record your changes, add your name.

look if <pre>debian/control</pre> dependency versions should be changed.

== installing build dependencies==

<pre>
sudo apt build-dep .
</pre>

== building ==

<pre>
dpkg-buildpackage -b -uc
</pre>

add <pre>gbp.conf</pre> file in <pre>debian</pre> directory with the following content:

<pre>
[DEFAULT]
upstream-tag=%(version)s
</pre>

in <pre>debian/control</pre> file add (if not added)

<pre>
XSBC-Bugtracker: mailto:yourname@yourserver.am
</pre>

== icon ==
and the icon (this is not necessary if you port existing maemo5 package).

it is done [http://wiki.maemo.org/Maemo_packaging#Displaying_an_icon_in_the_Application_Manager_next_to_your_package this] way.

you need to have `sharutils` installed. (app-arch/sharutils in gentoo).

* prepare a `48x48` png file.

* optimize it: <pre>optipng -strip all</pre>

* base64 encode it

<pre>
uuencode -m maeFat.png maeFat.png > maeFat.png.base64
</pre>

* Add the field <pre>XB-Maemo-Icon-26</pre> to your <pre>debian/control</pre> (in Maemo 4 the size of the icons was 26×26 pixels, hence the name of the field, which has not changed in Maemo 5)

* Open the <pre>base64</pre> version of your image and copy from the line under <pre>begin-base64 644 <name of 48×48 image></pre> to the line above the <pre>===</pre>.

* Add this to the XB-Maemo-Icon-26 field

* Add a space in front of every line of the encoded icon. You can do that automatically using sed when you base64 encode the image:

<pre>
uuencode -m <name of 48×48 image> <name of 48×48 image> | sed -e s,^,\ ,  > <name of 48×48 image>.base64
</pre>

== cli apps ==
if the program that is being ported is a <code>cli</code> application, then <code>cli icon</code> can be used.

[http://lists.maemo.org/pipermail/maemo-community/2010-January/003870.html cli icon announcement]

[http://n900.tannerlab.com/tools/cli.icon.txt old unexistent in archive.org too, txt file]

[http://samoff.com/random/maemo/cli_icon/ icons as images]

this is how the icon looks in <code>ham</code>:

[[File:Maemo-cli_icon_appman_sample_v002.png]]

and this is the <code>48x48</code> size icon:

[[File:Maemo-term_icon_v002_a001_48p.png]]

its <code>base64</code> encoded and shifted for <code>maemo</code> <code>text file</code> is [http://norayr.am/tips/port_maemo_package_to_leste/maemo-term_icon_v002_a001_48p.png.base64 here]

or here:
<pre> begin-base64 644 maemo-term_icon_v002_a001_48p.png
 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
 5l7y6xMAAAAASUVORK5CYII=
 ====</pre>
Also add the field:

<pre>XSBC-Maemo-Display-Name: Photo light meter</pre>

== pushing to maemo-leste-extras ==
go to [https://github.com/maemo-leste-extras/ maemo-leste-extras] and [https://github.com/maemo-leste-extras/bugtracker/issues/new/choose open an issue] in the [https://github.com/maemo-leste-extras/bugtracker extras bugtracker] repo to request a repository.

ping <code>Wizzup</code> on <code>#maemo-leste@irc.libera.chat</code> to open you repo[s]. then try to be attentive to emails, because you may get github invite which you need to accept, otherwise it’ll time out(not sure when).

push your code to the newly opened repo in <code>maemo/beowulf</code> branch.

<code>beowulf</code> is the codename of the <code>devuan</code> release on which <code>maemo</code> is based.

<pre>$ git remote -v
origin  git@github.com:norayr/msid.git (fetch)
origin  git@github.com:norayr/msid.git (push)

$ git remote add maemo git@github.com:maemo-leste-extras/msid

$ git remote -v
maemo   git@github.com:maemo-leste-extras/msid (fetch)
maemo   git@github.com:maemo-leste-extras/msid (push)
origin  git@github.com:norayr/msid.git (fetch)
origin  git@github.com:norayr/msid.git (push)

$ git push maemo main
Enumerating objects: 176, done.
Counting objects: 100% (176/176), done.
Delta compression using up to 4 threads
Compressing objects: 100% (86/86), done.
Writing objects: 100% (176/176), 578.92 KiB | 4.71 MiB/s, done.
Total 176 (delta 105), reused 141 (delta 85)
remote: Resolving deltas: 100% (105/105), done.
To github.com:maemo-leste-extras/msid
 * [new branch]      main -&gt; main

$ git checkout -b maemo/beowulf
Switched to a new branch 'maemo/beowulf'

$ git push maemo maemo/beowulf
Total 0 (delta 0), reused 0 (delta 0)
remote:
remote: Create a pull request for 'maemo/beowulf' on GitHub by visiting:
remote:      https://github.com/maemo-leste-extras/msid/pull/new/maemo/beowulf
remote:
To github.com:maemo-leste-extras/msid
 * [new branch]      maemo/beowulf -&gt; maemo/beowulf
$
</pre>
the repo needs to be tagged.

<pre>git tag 0.0.1</pre>
and then the tag has to be pushed:

<pre>git push maemo 0.0.1</pre>
in case you did some changes but don’t want to bump a tag/changelog version, you need to delete the tag locally:

<pre>git tag -d 0.0.1
git push maemo :refs/tags/0.0.1</pre>
== phoenix ==
login https://phoenix.maemo.org/

the build sequence is:

* source
* binaries
* repos

find your project. let’s say https://phoenix.maemo.org/job/msid-source/

it has to have ‘build with parameters’ button on the left.

if everything is right it’ll trigger build of binaries https://phoenix.maemo.org/job/msid-binaries/

that link, for instance, will contain <code>arm64</code> build console output: https://phoenix.maemo.org/job/msid-binaries/architecture=arm64,label=arm64/1/console

== wiki ==
add a wiki page about the package [https://leste.maemo.org/Category:Extras here].

links:

https://leste.maemo.org/Development https://leste.maemo.org/Development/Porting_Packages https://leste.maemo.org/Development/Building_Packages https://leste.maemo.org/Development/Modified_Software



If you import a package, please try to preserve history if possible (converting from svn -> git is not too hard)

= Forking Debian/Devuan packages =

(TODO - Describe what branches need to be set up, Jenkins integration, etc)

= Preparing package for the repositories =

See https://leste.maemo.org/Development/Building_Packages