Free a lancé les jeux sur la FreeBox HD. Il y avait déjà des possibilités de jeux à travers les télésites, mais cette fois un environnement dédié à cette activité est disponible, avec les facilités que cela sous-entend.

Dans ce billet, je vais vous présenter mon parcours du combattant pour l’installation d’Elixir et d’EFL sous Ubuntu 9.04.

Le SDK : JavaScript, Elixir et EFL

Avant d’aller plus loin, il est important de bien comprendre l’environnement dans lequel on arrive.

Tout d’abord, le langage de développement retenu par Free est le JavaScript. Et comme le JavaScript est un langage interprété, il faut un interpréteur ! Et c’est SpiderMonkey qui s’y colle, l’interpréteur JavaScript de Firefox.

Le JavaScript seul ne peut pas faire grand chose, à l’instar de n’importe quel autre langage. Dans un navigateur il a habituellement accès au DOM, ce qui lui permet d’interagir avec le contenu des pages web.

Dans la FreeBox, le code JavaScript que vous pourrez écrire ne s’exécute pas dans un navigateur. Pour pouvoir interagir avec l’affichage et la télécommande, les EFL viennent à la rescousse.

EFL ? En plus long, les Enlightenment Foundation Libraries. Il s’agit d’un ensemble de bibliothèques conçues à l’origine pour le gestionnaire de fenêtres Enlightenment. Dans la FreeBox, exit Enlightement, ne restent que les EFL.

Ces bibliothèques ne connaissant pas nativement SpiderMonkey, et réciproquement, il fallait une couche supplémentaire pour les faire communiquer : Elixir.

Le schéma suivant résument l’ensemble :

De façon non exhaustive, les EFL comptent :

• eet : une bibliothèque qui permet, entre autres, la création et la gestion de fichiers ressource (avec les fichiers .edj),
• evas : un gestionnaire de canevas (un équivalent Cairo),
• edje : un gestionnaire d’interface (un équivalent Glade).

Comment développer des jeux pour la FreeBox ?

Tout ce qui a été présenté à la section précédente est déjà installé sur votre FreeBox HD si vous avez un Firmware 1.6.1 ou supérieur.

Le développement de jeux et d’applications nécessitant des outils différents de la plateforme cible, il vous faut maintenant un environnement de développement sur votre machine.

Je suis sous Ubuntu 9.04 64 bits (pas encore fait le saut pour la 9.10).

Il me faut donc installer :

• SpiderMonkey,
• EFL,
• Elixir,
• edje_viewer.

Et c’est là que ça commence à devenir marrant

Ma procédure d’installation diffère quelque peu de la procédure officielle.

Installation de tout le schmurtz

Pré-requis

Installer gperf, libnspr4-dev, automake, svn et wget :

sudo apt-get install gperf automake svn wget libnspr4-dev

Notes :

• Les utilitaires svn et wget sont uniquement utilisés pour récupérer les fichiers nécessaires à l’installation du SDK. Ils pourront être désinstallés après l’installation d’Elixir.
• Libnspr4-dev est nécessaire pour la compilation de SpiderMonkey.
• Automake permet le lancement des scripts autogen.sh, nécessaires dans le cas de sources récupérés par svn (suite au commentaire de Strofe).

Récupération des sources

Créez-vous un répertoire elixir dans lequel vous exécuterez tout ce qui suit.

Récupérez les sources avec les lignes de commande suivantes :

mkdir elixir
cd elixir
wget http://elixir.freebox.fr/elixir/elixir-0.1.24.tar.bz2
tar xjvf elixir-0.1.24.tar.bz2
wget http://ftp.mozilla.org/pub/mozilla.org/js/js-1.8.0-rc1.tar.gz
tar xzvf js-1.8.0-rc1.tar.gz
svn co http://svn.enlightenment.org/svn/e/trunk/eina eina-svn
svn co http://svn.enlightenment.org/svn/e/trunk/eet eet-svn
svn co http://svn.enlightenment.org/svn/e/trunk/evas evas-svn
svn co http://svn.enlightenment.org/svn/e/trunk/ecore ecore-svn
svn co http://svn.enlightenment.org/svn/e/trunk/efreet efreet-svn
svn co http://svn.enlightenment.org/svn/e/trunk/embryo embryo-svn
svn co http://svn.enlightenment.org/svn/e/trunk/edje edje-svn
svn co http://svn.enlightenment.org/svn/e/trunk/e_dbus e_dbus-svn
wget http://download.enlightenment.org/snapshots/2009-07-29/elementary-0.5.1.0.tar.bz2
tar xjvf elementary-0.5.1.0.tar.bz2
svn co http://svn.enlightenment.org/svn/e/trunk/edje_viewer/ edje_viewer
wget http://freebox-elixir.googlecode.com/svn/trunk/exemples/ecore_evas/Simple.js

Notes :

• Suite à la judicieuse remarque de Superna en commentaire, vous pouvez remplacer les “svn co” par des “svn export” pour gagner en espace disque et en vitesse de téléchargement.
• Au moment où j’écris ces lignes, il existe apparemment une version 0.1.25 d’Elixir mais ce n’est pas celle qui est indiquée sur le site http://elixir.freebox.fr/
• On compile SpiderMonkey plutôt que d’installer les paquetages libmozjs-dev et libmozjs0d disponibles sous Ubuntu 9.04 car ces derniers ne définissent pas la constante JSVERSION_1_8 nécessaire à Elixir (ils s’arrêtent à JSVERSION_1_7).
• Le fait de récupérer les sources des EFL par svn plutôt qu’en allant sur http://download.enlightenment.org/snapshots/LATEST/ comme recommandé sur http://elixir.freebox.fr/ permet d’avoir une version à jour de evas. En suivant la procédure officielle, j’obtenais les messages suivants lors de la compilation d’Elixir :
  

  evas-const-binding.c:113: erreur: ‘EVAS_HINT_EXPAND’ undeclared here (not in a function)
  evas-const-binding.c:114: erreur: ‘EVAS_HINT_FILL’ undeclared here (not in a function)

• Les deux dernières lignes permettent de télécharger elementary et edje_viewer afin de compiler ce dernier. Il n’est pas indispensable mais est bien pratique pour voir graphiquement ce que contient un fichier .edj.
• Simple.js est un script qui permettra de vérifier le bon déroulement de la compilation et de l’installation d’Elixir.
• À la fin de l’exécution de ces lignes, tous les fichiers nécessaires ont été récupérés et décompressés dans le répertoire elixir.

Compilation et installation des EFL

Pour compiler les EFL, c’est un peu rébarbatif, il faut aller dans chacun des répertoires suivants :

• eina-svn,
• eet-svn,
• evas-svn,
• ecore-svn,
• efreet-svn,
• embryo-svn,
• edje-svn,
• e_dbus-svn.

Dans chacun de ces répertoire, il faut répéter les commandes suivantes :

sh autogen.sh
make -j4
sudo make install

Notes :

• On utilise “sh autogen.sh” plutôt que “sh configure” car il s’agit de versions svn qui ont besoin de générer le fichier configure. Autogen.sh fait les deux : création et exécution du fichier configure.
• L’option -j4 permet d’utiliser quatre cœurs pour accélérer la compilation. Si vous avez un processeur dual core, utilisez -j2.

Une fois les EFL compilées et installées, exécutez la commande suivante :

sudo ldconfig

Compilation et installation de SpiderMonkey

De retour dans le répertoire elixir, placez-vous maintenant dans le répertoire js/src.

make JS_THREADSAFE=1 JS_DIST=/usr -f Makefile.ref
sudo su
mkdir /usr/include/smjs
cp *.h /usr/include/smjs
cp *.tbl /usr/include/smjs
cp Linux_All_DBG.OBJ/libjs.so /usr/lib/libsmjs.so
cp Linux_All_DBG.OBJ/jsautocfg.h /usr/include/smjs/jsautocfg.h
exit

Note :

• Il s’agit de la procédure d’installation de SpiderMonkey telle que présentée dans la procédure officielle.

Une fois SpiderMonkey compilé et installé, exécutez la commande suivante :

sudo ldconfig

Compilation et installation d’Elixir

C’est au tour d’Elixir !

Avant de lancer la compilation, il va falloir modifier une ligne dans les sources d’Elixir. La version des EFL doit être un brin trop récente pour la version 0.1.24 d’Elixir. Si vous ne faîtes pas la modification, vous aurez droit aux lignes suivantes :

ecore_module.c: In function ‘elixir_ecore_thread_run’:
ecore_module.c:908: erreur: too few arguments to function ‘ecore_thread_run’

Placez-vous dans le sous-répertoire elixir-0.1.24 du répertoire elixir.

Éditez la ligne 908 du fichier src/modules/bindings/ecore/ecore_module.c. Elle ressembler à ceci :

result = ecore_thread_run(_elixir_func_heavy, _elixir_func_end, new);

Il faut la transformer en ceci :

result = ecore_thread_run(_elixir_func_heavy, _elixir_func_end, new,NULL);

Une fois la modification faite, compilez comme suit :

sh configure
make -j4
sudo make install

Une fois Elixir compilé  et installé, exécutez la commande suivante :

sudo ldconfig

Premier test

De retour dans le répertoire elixir, tapez la ligne suivante :

elixir Simple.js

Si tout s’est bien passé, vous devriez voir un rectangle se balader dans une fenêtre.

À partir de là, vous disposez d’un environnement complet pour créer vos jeux pour la FreeBox.

Compilation et installation de edje_viewer

On va tout d’abord installer la bibliothèque elementary. Placez-vous dans le sous-répertoire elementary-0.5.1.0 et lancez la compilation :

sh autogen.sh
make -j4
sudo make install

De retour dans le répertoire elixir, placez-vous dans le sous-répertoire edje_viewer et lancez la compilation :

sh autogen.sh
make -j4
sudo make install

Une fois elementary et edje_viewer compilés  et installés, exécutez la commande suivante :

sudo ldconfig

Et après tout ça ?

Récupérez les exemples, tutoriels et jeux

Pour vous faire la main, vous pouvez rapatrier les exemples, les tutoriels ainsi que les jeux livrés en standard. Pour cela, replacez-vous dans le répertoire elixir et tapez la ligne :

svn checkout http://freebox-elixir.googlecode.com/svn/trunk/ freebox-elixir

Résumé des commandes

Pour résumer, vous disposez désormais des commandes suivantes :

• elixir : permet d’exécuter votre code JavaScript (ex. : elixir Simple.js),
• edje_cc : pour compiler des fichiers .edc en fichiers .edj (edje_decc fait le contraire),
• eet : pour ajouter, supprimer des ressources des fichiers .edj (en partenariat avec elixir-compile),
• edje_viewer : pour voir graphiquement les ressources des fichiers .edj.

Tester ses programmes sur la FreeBox

Pour tester vos réalisations directement sur la FreeBox, il suffit de les placer dans le répertoire “Jeux” sur le disque dur de la FreeBox (par ftp sur hd1.freebox.fr, utilisateur freebox).

Si vous copiez Simple.js de cette façon, vous pourrez l’exécuter directement.

Pour les jeux livrés en standard, c’est plus sioux. Tous les fichiers ne sont pas nécessaires puisque le fichier .edj en intègre déjà une bonne partie.

Par exemple, pour le démineur, copiez les fichiers suivants dans un sous-répertoire demineur du répertoire Jeux sur le disque dur de la FreeBox :

• demineur_bomb.wav,
• Demineur.edj,
• Demineur.ogg,
• edje-helper.edj,
• freebox-mouse.png,
• high_score.wav,
• Scores.db.

Références

http://wiki.enlightenment.org/index.php/E17_User_Guide/Installing_from_Source_Repository

Installation d’Enlightenment 17 à partir des sources svn.

http://elixir.freebox.fr/?section=documentation

Procédure officielle d’installation d’Elixir

https://developer.mozilla.org/en/Building_only_SpiderMonkey

Procédure d’installation officielle de SpiderMonkey

http://code.google.com/p/freebox-elixir/wiki/InstallerElixir

Discussion à propos de l’installation d’Elixir sur Google Code

http://svn.enlightenment.org/svn/e/trunk/

Versions svn des bibliothèques nécessaires à la compilation d’Enlightenment

http://download.enlightenment.org/snapshots/LATEST/

Les dernières versions officielles des EFL.

Appena installata la om2008.9 ci sono degli sgradevoli stivali a segnalare l’avvio del server grafico. Cioe’, magari ad alcuni piacciono, ma al di la della facile ironia da nerd (boot = avvio) io ho deciso di togliere quell’immagine perche’ e’ veramente fastidiosa.

Per modificarla e’ facile, forse un po’ macchinoso ma e’ comunque facile.

Si basa su dei file .edj che sono a base dei temi di enlightenment, altro non e’ che un unico file compilato dove dentro ci sono le varie immagini e i file di testo per definire il tema. Avere un’unico file facilita l’installazione senza dover spargere file in giro per il file system.

Inanzitutto abbiamo bisogno dell’utility edje_decc presente nel pacchetto edje-utils, quindi basta un opkg install edje-utils e avremo le nostre utility pronte. Inoltre, visto che non e’ tra le dipendenze, abbiamo bisogno di installare il pacchetto libevas-saver-png altrimenti non riusciamo a decomprimere le immagini che stanno dentro il tema.

A questo punto dobbiamo trovare il file col tema giusto, visto che ce ne sono diversi. Io l’ho trovato con un po’ d’intuito e il comando find / -name *.edj

Ho trovato in particolare il file dal nome piu’ che intuitivo che e’ /usr/share/enlightenment/data/init/illume_init.edj

L’ho copiato in un’altra directory e ho lanciato il comando edje_decc illume_init.edj

questo crea una directory chiamata col nome del tema, in questo caso illume_init, con dentro tutti i file e, guarda caso, ce n’e’ uno che si chiama proprio boots.png

A questo punto bisogna creare un’immagine come ci pare ma che sia 480×640 pixel a 256 colori, ovvero 8 bit. La si salva in png e si puo’ sovrascriverla a quella originale. Cosi’ ci togliamo di mezzo una volta per tutte quegli stivali.

A questo punto noterete che all’interno della directory e’ presente un file eseguibile chiamato build.sh, basta lanciare quello e, magicamente, creera’ il file illume_init.edj che va coopiato in /usr/share/enlightenment/data/init/ (magari fatevi la copia di quello originale)

A questo punto tutto e’ pronto e basta rilanciare x con /etc/init.d/xserver-nodm restart, oppure riavviate del tutto il telefono, e avrete la vostra immagine che sostituisce i vecchi stivali.

Ecco, a chi lo chiedeva, l’immagine che utilizzo ora… e’ un attimo autoreferenziale

Milagon offers high quality ergonomic seating for the commercial and industrial workspace. The focus of Milagon is the growing need in the industrial workplace to improve worker health, comfort, and productivity through ergonomics. By integrating high-tech ergonomics, quality materials, and craftsmanship, Milagon produces the highest quality ergonomic seating available for the commercial and industrial workplace.

 Chairs from Milagon feature Workseat® Technology, the ergonomic combination of form and function that fuses unmatched comfort, rugged durability, and aesthetics into the seating systems they produce.

We at PAC are pleased to carry six of Milagon’s chair lines:

          Aklaim:

The Aklaim offers wellness for your back at your workplace. All over perforated seats and backrests ensure continuous air circulation and optimal seating climate. When work hygiene is of concern, the detachable and individually exchangeable PU upholstery allows for new options, especially at multi-shift workplaces.

Healthy, dynamic sitting is supported by amply dimensioned seats with variable inclination angles as well as high backrests with individually adjustable contact pressure.

          Brio:

Milagon’s Brio Series chair is the “workhorse” of the industrial seating line. Brio brings innovation and performance together with one purpose in mind: Optimal seating in the workspace.

Soft, comfortable polyurethane foam seat pan and backrest are featured for maximum wear and durability. These are mounted to a cast aluminum mechanisim providing a -4 to +10 degree tilt of the seat and a 10 degree + or – angle of the backrest with spring tensioned, clutch mechanism. This self-skinning polyurethane is an ideal material for those multi shift environments where hygiene is a concern.

          Edj:

Special areas need special materials.

Edj stainless steel workseats are designed for “wash” down environments. All metal parts are made of stainless steel.

Height adjustment of the seat pan is accomplished with a concentric taper of the solid stainless steel rod.

         Neutra:

fabric or vinyl conductive seating mounted on five star cast aluminum base equipped with conductive glides or conductive self-braking casters that provide maximum dissipation of electro-static discharges.

As with all Milagon seating systems, the Neutra series chair conforms to the ergonomic safety requirements prescribed by ANSI/BIFMA.

          Stera:

The Milagon designed, Class 10 Approved, cleanroom chair is your solution to cleanroom/ESD requirements. In addition to ergonomics and safety requirements, Stera workseats respond to stringent specifications placed on cleanroom furniture, as required in the electronic or medical fields, without sacrificing comfort.

Conductivity is within the specified range of 105 Ohm.

          Tasq:

The Tasq Standing Support is designed to provide ergonomic physical relief to the body posture of any employee whose duties require standing performance, thereby avoiding many common industrial repetitive motion injuries.