Une app personnalisée à partir de vos recettes et de celles de la bibliothèque

Une application App Builder peut utiliser les recettes d’un projet en plus de celles de la bibliothèque. Ce guide crée l’application termtools sur la page Apps, avec cmatrix, issu du projet du guide Votre première recette, ainsi que tmux et htop, issus de la bibliothèque, puis l’active sur le NAS et l’exporte.

1. Projetvos propres recettes
2. Nouvelle appRecettes d’un projet
3. Recettescelles du projet et de la bibliothèque
4. Compilationune seule tâche
5. UtilisationActiver, Exporter

Les images viennent du panneau de Bucket & Code Server IDE, chaque étape étant faite comme ce guide la décrit.

01Ce qu’une application prend d’un projet

Une application prend les recettes d’un seul projet au plus, en plus de celles de la bibliothèque. Tout projet de la page Projets convient dès que son dossier recipes/ contient une recette, quel que soit son type. Une recette de projet qui porte le nom d’une recette de la bibliothèque la remplace dans les applications qui prennent ce projet, et nulle part ailleurs.

02Une nouvelle application avec les recettes d’un projet

Sur la page Apps, Nouvelle app demande d’abord le nom et le préfixe, l’environnement, la cible, l’endroit où les programmes s’exécutent et le mode de liaison. Nommez l’application termtools ; son préfixe devient /usr/app/termtools. Choisissez le builder Ubuntu 24.04 comme environnement, gardez ce NAS comme cible et le mode de liaison sur dynamique, puis continuez avec Choisir des recettes.

Au-dessus des recettes, Recettes d’un projet liste les projets qui contiennent des recettes, ainsi que Aucun : la bibliothèque seule. Choisissez cmatrix. La liste montre alors d’abord les recettes du projet, sous le nom du projet et marquées projet, puis celles de la bibliothèque sous Bibliothèque de recettes. Une recette de projet qui remplace une recette de la bibliothèque indique remplace la version … de la bibliothèque, avec la version de la recette remplacée.

Cochez cmatrix dans le groupe du projet, et tmux et htop dans celui de la bibliothèque ; le champ de recherche les trouve. L’Ordre de build ajoute les recettes dont elles ont besoin et marque chacune avec la recette qui en a besoin. Vérification liste chaque choix, dont Recettes d’un projet, et Créer et compiler crée l’application et lance sa compilation.

03La compilation

La page de l’application suit la compilation recette par recette. Sous le nom de l’application, elle indique Recettes du projet cmatrix, qu’un développeur voit comme un lien vers le projet. La tâche de compilation lit les recettes du projet une seule fois, à son démarrage, et son journal indique ce qu’elle a lu :

recipes of the project cmatrix, read at the job's start: 1 (cmatrix)

Un fichier du projet enregistré après ce moment ne compte qu’à la compilation suivante : Recompiler sur la page de l’application.

04L’activer, l’emporter ailleurs

Activer (réservé aux admins) fait de /usr/app/termtools un lien vers la dernière compilation réussie, et les programmes s’exécutent sur le NAS depuis cet emplacement :

/usr/app/termtools/bin/cmatrix
/usr/app/termtools/bin/tmux -V

Télécharger fournit la compilation sous forme d’archive, à décompresser au même préfixe sur un NAS de même architecture. Exporter en QPKG, réservé aux admins et disponible une fois QDK installé (Toolchains, onglet QNAP), en fait un paquet QTS sans signature de code ; une application compilée pour ce NAS seulement n’est pas exportée. Votre propre App Center montre comment un paquet est signé et proposé. Transmission de A à Z suit un programme du début à la fin : d’un NAS où rien n’est configuré jusqu’à un paquet QTS signé et installé, qui répond dans le navigateur.

05Un autre projet, ou aucun

Modifier, sur la page de l’application, règle de nouveau Recettes d’un projet : un autre projet, ou Aucun : la bibliothèque seule. Une recette choisie qui manque dans la nouvelle liste est nommée sous le champ, comme dans Absentes de cette liste, laissées de côté : cmatrix, et reste hors de l’application tant que ce choix reste en place. Enregistrer la modification laisse les fichiers de l’application tels quels ; la compilation suivante applique la modification.

06Règles

• Une application retrouve son projet grâce au nom du dossier. Une fois le dossier renommé ou supprimé, une compilation de l’application est refusée avec Il n’y a pas de projet « cmatrix »., de même qu’une modification qui garde ce nom : Modifier accepte le nouveau nom du dossier ou Aucun : la bibliothèque seule.
• Une recette de projet qui a un problème est laissée de côté, et le champ indique pourquoi. La recette de la bibliothèque du même nom ne la remplace pas.
• Seul un développeur voit les recettes d’un projet. Un viewer voit l’application et ses compilations ; la page de l’application indique à un viewer que l’ordre de build n’est pas affiché.
• Créer une application exige le rôle developer. Activer, Désactiver et Exporter en QPKG sont réservés aux admins.