Aller au contenu

LaunchMeUp Editor

L’éditeur est un outil puissant qui permet la conception d’un thème. Son utilisation requière de bien connaitre les composants utilisables dans une application LaunchMeUp (voir le « manuel de référence » dans ce wiki).

Comment lancer LaunchMeUp Editor

Une fois LaunchMeUp installé sur votre ordinateur, un raccourci est disponible sur le bureau ainsi que dans le menu démarrer de Windows. Il est aussi possible de lancer l’éditeur depuis la page d’accueil de LaunchMeUp.

Connexion

Le premier écran de l’éditeur est celui permettant la connexion. Un compte valide créé sur magiczee.com est donc nécessaire (voir la section « membership » du site). La création de ce compte est gratuite.

Il est aussi possible de changer la langue d’affichage grâce à une liste déroulante présente en haut à droite de l’éditeur.

Ce que permet LaunchMeUp Editor

LaunchMeUp Editor va vous permettre de modifier l’agencement des pages et composants d’un thème ou d’une application, ou de créer un nouveau thème / une nouvelle application « from scratch ».

Vous pourrez avec l’éditeur créer des pages dans lesquelles vous placerez judicieusement des composants à paramétrer grâce à une liste de propriétés.

La liste de composants disponibles est décrite dans le manuel de référence. Chaque composant peut être animé (animations d’apparition et de disparition) pour provoquer des transitions entre l’affichage des différentes pages.

Structure des fichiers d'une application

Un thème ou une application possède deux fichiers indispensables.

  • Le point d’entrée : il s’agit d’une page .lmu contenant un composant racine appelé « Launcher ». Elle sera la page principale de votre thème.

  • Le fichier ThemeInfos : c’est un fichier .lmu contenant les métadonnées du thème (titre, auteur, …)

Le reste de l’arborescence des fichiers du thème est libre, mais il est conseillé de suivre le schéma suivant :

  • Un sous répertoire « images\ » contenant les images

  • Un sous répertoire « video\ » contenant les vidéos

  • Un sous répertoire « musics\ » contenant les musiques

  • Un sous répertoire « sounds\ » contenant les sons

Ecran d'accueil de l’éditeur

Une fois connecté, l’éditeur vous donne accès à un écran d’accueil affichant les derniers thèmes modifiés pour permettre leur réouverture en un seul clic.

Il est aussi possible d’ouvrir une autre application, d’en créer une nouvelle ou de remixer un thème récupéré sur magiczee.com.

Créer une nouvelle application

Si vous choisissez de créer une nouvelle application, l’éditeur vous demandera dans quel répertoire vous souhaitez la stocker, puis copiera dans ce répertoire le modèle de nouvelle application avant de l’ouvrir.

Ce modèle comporte uniquement une page « point d’entrée » (+ ThemeInfos) et les sous répertoires cités plus haut.

Ouvrir une application existante

Le système vous demande le chemin de stockage de l'application à ouvrir et scan les fichiers et sous-répertoires présents à cet endroit pour vous les proposer en édition.

Récupérer un thème sur magiczee.com

Comming soon

Les différentes sections de l'éditeur

Une fois votre application ouverte (création ou modification), l’éditeur affiche 3 sections distinctes :

  • A gauche, un panel rétractable avec l’explorateur de projet, les propriétés des composants, les variables et les outils

  • En haut, une barre d'outils

  • Au milieu, la zone d’édition qui affiche la page courante et permet la sélection des composants

Le survol de la souris sur les différents éléments présents dans l’éditeur affiche une aide décrivant la fonctionnalité en question.

Explorateur de projet

Il présente l’arborescence de fichiers du répertoire de votre application. Un clic droit sur un élément de cette arborescence donne accès à un menu contenant les options suivantes :

  • Ouvrir : ouvre l’élément dans l’éditeur (pages, …)

  • Ouvrir avec le système : ouvre l’élément avec le programme par défaut défini pour l’extension du fichier.

  • Ouvrir le dossier : ouvre le dossier dans l’explorateur de fichiers de Windows

  • Ajouter :

Un fichier existant : permet l’ajout d’un fichier (média, …) et sa copie dans le répertoire du projet

Une nouvelle page : ajoute une nouvelle page xml au projet

Un nouveau dossier : ajoute un répertoire à l’arborescence du projet

  • Renommer : renomme l’élément sélectionné dans l’explorateur

  • Couper / copier / coller : opérations d’édition classiques

  • Supprimer : supprime l’élément sélectionné dans l’explorateur (y compris sur le disque). Il est aussi possible d’utiliser la touche « Suppr ».

Le double clic sur un élément de l’explorateur a aussi pour effet de l’ouvrir, soit dans l’éditeur pour les pages, soit avec Windows pour les autres fichiers.

Les propriétés

Le panel des propriétés est divisé en 2 parties :

L’arborescence des composants de la page actuellement ouverte.

Cette arborescence est hiérarchique, ce qui signifie qu’un composant peut contenir d’autres composants.

Le clic droit sur un élément de la liste donne accès à un menu contenant les options suivantes :

  • Définir l’id de fenêtre : les pages launchmeup sont multifenêtres. Ainsi, vous pouvez définir pour chaque composant d’une page la fenêtre dans laquelle il va s’afficher. Cela se fait en spécifiant l’id de fenêtre du composant. Les fenêtres de l’application sont définies au niveau du Launcher.

  • Rentrer à l’intérieur : permet de rentrer à l’intérieur d’un composant en en faisant la racine affichée dans la zone d’édition. Peut aussi être obtenu par double click.

  • Définir la couleur de fond / de premier plan

  • Définir la grille : uniquement pour les composants Layout et descendants du Layout (Launcher, …), permet de définir la grille dans laquelle vont se placer les composants enfants

  • Définir les variables : pour définir une liste de couples clé / valeur propre au composant. Les variables sont utilisables (via leur clé, qui est remplacée par leur valeur) dans certaines propriétés et sont héritées par les composants enfants.

  • Définir les styles : les styles permettent de donner une apparence commune à un type de composant pour toute l’application.

  • Définir les items : uniquement pour les ItemsPanel, donne accès à un écran de définition des items de l’ItemsPanel.

  • Définir la cible : la cible est ce qui sera exécuté / affiché lorsque l’utilisateur clique sur un composant. Par exemple une autre page, une commande shell, …

  • Mettre au premier plan : avance le composant vers l’avant-plan afin d’améliorer sa visibilité.

  • Mettre au second plan : recule le composant vers l’arrière-plan

  • Ajouter un nouvel élément : uniquement pour les composants contenant des enfants comme le Layout ou le Launcher : ajoute un composant enfant au composant sélectionné.

  • Ajouter un nouvel item : uniquement pour les ItemsPanels : ajoute un item à la collection de l’ItemsPanel (icone, …)

  • Supprimer : supprime le composant sélectionné, il est aussi possible d’utiliser la touche « Suppr ».

  • Couper / copier / coller : opérations classiques d’édition

Les propriétés du composant sélectionné dans la zone d’édition.

Cette liste permet la modification des propriétés du composant sélectionné.

Elle comporte en haut une zone de filtrer avec les options suivantes :

  • Grouper : pour regrouper (ou non) les propriétés par thématique

  • Toutes / essentielles / modifiées : affiche toutes les propriétés, celles jugées essentiels selon le type de composant sélectionné, ou bien uniquement les propriétés qui ont été modifiées par l’utilisateur.

  • Zone de recherche : zone textuelle pour filtrer les propriétés par nom

Variables

Ce panel contient un rappel des variables définies dans les différents composants de la page. Les variables sont très utiles pour rendre l'applications "paramétrable", et aussi dans la définition de patterns d'items devant se répéter comme les icônes.

Outils

Ce panel contient le widget de connexion et celui de la langue d’affichage de l’éditeur.

La barre d'outils

La barre d’outil reprend les options de menu présentes dans le panel d’édition, avec en plus :

  • Précédent / suivant : pour naviguer dans l’historique des éléments ouverts dans la zone d'édition.

  • Enregistrer l’application : enregistre toutes les modifications.

  • Lecture automatique des média : active / désactive la lecture automatique des médias qui sont affichés dans l’éditeur.                          

  • Lancer : pour lancer l’application avec le Player et la tester.

  • Sélection de la fenêtre à afficher : n’affiche que les composants correspondants à un id de fenêtre donné.

  • Définir les informations du thème : pour saisie les informations du fichier « ThemeInfos.xml ».

  • Définir les fenêtres du thème : donne accès à un écran permettant de spécifier les fenêtres qu’affichera l’application une fois lancée.

A droite de la barre d’outils est affiché un rappel de la page et le composant actuellement sélectionné.

La fenêtre d'édition

Le panel central contient le rendu de la page actuellement éditée, et permet la sélection des composants par clic de souris.

La touche « Echap » permet de remonter au parent du composant sélectionné.

Un menu est disponible par clic droit et donne accès aux mêmes options que la barre d’outils.

Les grilles définies dans les composants Layout apparaissent sous la forme de trais jaunes. Il est possible de déplacer le composant sélectionné dans sa grille parente en faisant glisser à la souris le petit carré (déplacement) ou le petit triangle jaune (dimensionnement) situés en haut à gauche et en bas à droite du rectangle de sélection.