Create an application.fr_FR - gd-99/symbiogd GitHub Wiki

Pour créer une application pour Symbiose, vous devez seulement savoir coder en Javascript (et éventuellement maîtriser jQuery). Si ce n'est pas le cas, vous pouvez apprendre sur le Site du Zéro.

La bibliothèque de Symbiose

Pour vous aider a créer des applications pour Symbiose, une bibliothèque est disponible. Elle vous permettra de créer des fenêtres, menus, boutons... Cette bibliothèque repose sur jQuery, qui simplifie le développement en Javascript. Il est également possible d'utiliser X-Tags, une initiative de Mozilla pour créer simplement des éléments HTML personnalisés.

Chaque élément d'une application (fenêtres, boutons, menus, listes...) est appelé widget. Leur manipulation est simple grâce à jQuery et X-Tags.

Lancez-vous !

Commencez par créer un fichier Javascript dans votre dossier personnel à l'aide de l’éditeur de fichiers. Pour voir le résultat, il vous suffit de l'ouvrir via l'explorateur de fichiers.

Vous devrez [apprendre à utiliser les widgets](How to use widgets.fr_FR). Ensuite, vous pourrez manipuler les fenêtres et vous familiariser avec les widgets de Symbiose. Vous pouvez aussi jeter un coup d’œil au [reste de la bibliothèque](JS Library) servant à gérer les interactions avec le serveur, manipuler les fichiers et utilisateurs, etc...

Vous pouvez aussi explorer les [exemples simples d'applications basiques](Application examples.fr_FR).

Pour simplifier le développement de vos applications, vous pouvez utiliser X-Tags qui permet de séparer l'interface utilisateur (widgets) de la logique de l'application.

Pour une utilisation en ligne de commande référez-vous à la [page dédiée](Create a CLI application.fr_FR).

Une fois que vous avez compris le fonctionnement général, vous pouvez commencer votre application.

Créez votre application

Vous devez tout d'abord avoir accès à un webos Symbiose avec les droits d'administrateur (pour pouvoir tester votre programme), de préférence en local (pour pouvoir modifier votre application avec votre éditeur de texte préféré !).

Voici comment devra se découper votre application :

  • /usr/bin/myapp.js : ce fichier sera appelé lors du lancement de votre application.
  • /usr/lib/myapp/myapp.js : si votre application est relativement volumineuse, ce fichier contiendra la bibliothèque de votre application.
  • /usr/share/applications/myapp.xml : le [lanceur](Create a launcher) de votre application
  • /usr/share/css/myapp/main.css : si votre application a besoin d'une feuille de style pour mettre en forme son interface, il sera stocké ici.
  • /usr/share/icons/applications/48/myapp.png : l'icône de votre application, de taille 48 x 48 pixels. Vous pouvez aussi ajouter l'icône sous d'autres tailles dans le dossier approprié (ex: /usr/share/icons/applications/24/myapp.png pour une icône de 24 pixels, etc...).
  • /usr/share/images/myapp/ : dossier ou les images de votre applications seront stockées, s'il y en a.