Difference between revisions of "Black&White Project/Kiwix for Sugar/Porting"

From Kiwix
Jump to navigation Jump to search
Line 65: Line 65:


Activity Icon must respond to very specific requirements:
Activity Icon must respond to very specific requirements:


* Icon should be made from a 75px square frame and fit properly
* Icon should be made from a 75px square frame and fit properly
Line 89: Line 88:


== Build .XO ==
== Build .XO ==
Building the .xo file is easy.
# prepare your folder so that it's named Kiwix.activity
# Inside this folder, place your ''application.ini'', ''chrome'', ''xulrunner'', etc.
# On that same folder, place the ''activity'' subfolder, ''setup.py'', ''lib/'' and ''bin/''
# <pre>cd Kiwix.activity
python ./setup.py dist_xo</pre>
That will create a Kiwix-x.xo in the ''dist/'' sub folder. '''x''' represents the build version.
This version number is specified in your ''activity/activity.info'' file. It is important as it's the only way to express versions in the Sugar world: the Journal and the Activities Manager.


== XR App Customization ==
== XR App Customization ==

Revision as of 18:01, 21 September 2011

This page relates the portage or Kiwix into the Sugar platform. It might be of interest to others willing to port Xulrunner apps to Sugar.

Static

Sugar Activities are mostly distributed using the Activities Wiki, as .xo bundle. A .xo bundle is an archive containing your app. There is no dependency definition so you need to bundle everything.

This is the reason why we compiled all our XPCOM components statically for th Sugar version.

Also, Sugar does ship XulRunner at the moment but its version changes frequently. To avoid XR version conflict or removal of XR (browser development seems to have swtich to the Surf activity based on webkit), you probably want to distribute your own version of XulRunner inside your .xo file.

Sugar Activity

A Sugar activity is a folder named Kiwix.activity which resides in one of the activities placeholder (/usr/share/activities/, ~/Activities, etc). It must contain the following:

  • activity/ folder
  • activity/activity.info description file
  • activity/activity.svg icon file

Those are the basic elements which are covered easily by sample activities.

What you need for a XR activity are:

  • lib/libsugarize.so a shared link library used to proxy X calls to Sugar.

Available at [1]

  • bin/SugarKiwix a bash script which will LD_PRELOAD the library and launch XR
#!/bin/sh
while [ -n "$2" ] ; do
     case "$1" in
         -b | --bundle-id)     export SUGAR_BUNDLE_ID="$2" ;;
         -a | --activity-id)   export SUGAR_ACTIVITY_ID="$2" ;;
         -o | --object-id)     export SUGAR_OBJECT_ID="$2" ;;
         -u | --uri)           export SUGAR_URI="$2" ;;
         *) echo unknown argument $1 $2 ;;
     esac
     shift;shift
done
export LD_PRELOAD="$SUGAR_BUNDLE_PATH/lib/libsugarize.so"
export NET_WM_NAME="Kiwix"
exec $SUGAR_BUNDLE_PATH/kiwix
  • setup.py not mandatory. A python script allowing easy packaging in .xo file.
#!/usr/bin/env python

from sugar.activity import bundlebuilder

bundlebuilder.start()
  • activity/activity.info
[Activity]
name = Kiwix
bundle_id = org.kiwix.Kiwix
exec = sugarKiwix
icon = activity-kiwix
activity_version = 1
show_launcher = yes

Activity Icon

Activity Icon must respond to very specific requirements:

  • Icon should be made from a 75px square frame and fit properly
  • Icon is composed of two elements: strokes and fills.
  • All strokes must be same color, all fills same color.
  • Stroke color and Fill color will be dynamically changed so don't choose something else than black/white.
  • Strokes must be 3.5px large.

When running under Sugar, background is transparent, all strokes gets one color and all fills another.

It is important that both stroke and fills exists as the colors reflect the user interacting with the activity.

Kiwix icon in the application ring

Activity-kiwix.svg

Kiwix Icon is composed of strokes and fills

  • one stroke to shape the bird
  • one stroke to shape the ball
  • one stoke to represent the eye.
  • one fill inside the bird
  • one fill inside the ball

Build .XO

Building the .xo file is easy.

  1. prepare your folder so that it's named Kiwix.activity
  2. Inside this folder, place your application.ini, chrome, xulrunner, etc.
  3. On that same folder, place the activity subfolder, setup.py, lib/ and bin/
  4. cd Kiwix.activity

python ./setup.py dist_xo

That will create a Kiwix-x.xo in the dist/ sub folder. x represents the build version. This version number is specified in your activity/activity.info file. It is important as it's the only way to express versions in the Sugar world: the Journal and the Activities Manager.

XR App Customization

Toolbars

  • Stock icons