Créer un script pour PlayOnLinux - Chapitre 7 : La puissance de PlayOnLinux version 3

Introduction

Depuis PlayOnLinux v3 (Arietis), vous avez la possibilité de faire des fenêtres comme celle-ci :

Ces fenêtres ont l'avantage d'être plus ergonomique pour l'utilisateur et le scripteur. Si vous voulez apprendre à faire ceci, lisez la suite !

POL_SetupWindow, késako ?

POL_SetupWindow est le nom de cette nouvelle interface. Ainsi, toutes les commandes contrôlant cette interface commencent par POL_SetupWindow

Voici une brêve liste des fonctions POL_SetupWindow :
POL_SetupWindow_Init
POL_SetupWindow_Close
POL_SetupWindow_textbox
POL_SetupWindow_message
POL_SetupWindow_download
POL_SetupWindow_menu
POL_SetupWindow_browse
POL_SetupWindow_prefixcreate
POL_SetupWindow_reboot
POL_SetupWindow_cdrom
POL_SetupWindow_check_cdrom
POL_SetupWindow_presentation
POL_SetupWindow_free_presentation
POL_SetupWindow_wait_next_signal
...

Préparer PlayOnLinux à utiliser POL_SetupWindow

Vous vous rappelez de ce code la :

if [ "$PLAYONLINUX" = "" ]
then
exit 0
fi

source "$PLAYONLINUX/lib/sources"

Nous allons y ajouter la ligne "POL_SetupWindow_Init" pour dire à PlayOnLinux : "Je veux que tu utilises l'interface de la version 3". Ce qui nous donne :

if [ "$PLAYONLINUX" = "" ]
then
exit 0
fi

source "$PLAYONLINUX/lib/sources"
POL_SetupWindow_Init

De même, il faut dire à PlayOnLinux "Je veux que tu arrête d'utiliser l'interface de la version 3" à la fin du script. Ce qui nous donnera :

# Code à la fin du script
POL_SetupWindow_Close
exit

Commander POL_SetupWindow

Vous pouvez ajouter diverses fonctions dans votre scripts. Je vais vous donner leur syntaxe

Cette commande permet de présenter votre application. Elle fonctionne de la même façon que la commande "presentation".

POL_SetupWindow_presentation "Nom du jeu" "Editeur du jeu" "Site du jeu" "Votre pseudo" "Préfixe du jeu (Voir le chapitre 5)"

Présentation plus libre :

POL_SetupWindow_free_presentation "Titre" "Message"

Message

POL_SetupWindow_message "message" "Titre"

Un menu (~ est le séparateur, vous pouvez le choisir)

POL_SetupWindow_menu "message" "Titre" "Carrote~Patate~Poireau" "~"

Télécharger un fichier

POL_SetupWindow_menu "message" "Titre" "URL"

Gestion du CDROM, le point de montage est stocké dans $CDROM

POL_SetupWindow_cdrom "Numéro du CD" POL_SetupWindow_check_cdrom chemin/vers/le/setup.exe

Une zone de texte

POL_SetupWindow_textbox "message" "Titre" "Valeur par défaut"

Une zone de texte avec le boutton parcourir

POL_SetupWindow_browse "message" "Titre" "Valeur par défaut"

Créer les lanceurs

POL_SetupWindow_make_shorcut # Prend les même paramètres que creer_lanceur

Poser une question :

POL_SetupWindow_question "question" "titre"

Attendre le temps d'un processus

C'est la nouveauté. Il existe un nouveau moyen de faire attendre PlayOnLinux le temps de l'exécution d'un processus.

Il s'agit de dire à PlayOnLinux : "Tant que je ne te fais pas signe, affiche une fenêtre 'attendre' avec une barre qui défile"

Voici la syntaxe :

POL_SetupWindow_wait_next_signal "message" "titre"
commande1...
commande2...
POL_SetupWindow_detect_exit
POL_SetupWindow_...

Un exemple :

POL_SetupWindow_wait_next_signal "Installation de Steam" "Steam"
wine "steam.exe"
POL_SetupWindow_detect_exit
POL_SetupWindow_message "Steam installé"

Récuperer les résultats des commandes

Il suffit juste de récuperer le contenu de la variable $APP_ANSWER après avoir executé la commande. Un petit exemple pour la route :-)

POL_SetupWindow_textbox "message" "Titre" "Valeur par défaut"
MESSAGE="$APP_ANSWER"
POL_SetupWindow_message "Vous avez entré $MESSAGE"

Pour POL_SetupWindow_question, $APP_ANSWER vaut TRUE ou FALSE en fonction de la réponse.