Een eigen app van je recepten en die van de bibliotheek

Een App Builder-app kan naast de recepten van de bibliotheek ook de recepten van één project gebruiken. Deze handleiding maakt de app termtools op de pagina Apps, met cmatrix uit het project van Je eerste eigen recept en tmux en htop uit de bibliotheek, en activeert hem daarna op de NAS en exporteert hem.

1. Projecteigen recepten
2. Nieuwe appRecepten uit een project
3. Receptendie van het project en die van de bibliotheek
4. Bouwenéén taak
5. GebruikenActiveren, Exporteren

De afbeeldingen komen uit het paneel van Bucket & Code Server IDE, met elke stap uitgevoerd zoals deze handleiding beschrijft.

01Wat een app uit een project neemt

Naast de recepten van de bibliotheek kan een app de recepten van één project gebruiken. Elk project op de pagina Projecten komt in aanmerking zodra zijn map recipes/ een recept bevat, welke soort project het ook is. Een projectrecept met de naam van een bibliotheekrecept vervangt dat recept, maar alleen in de apps die dit project gebruiken.

02Nieuwe app met de recepten van een project

Op de pagina Apps vraagt Nieuwe app eerst naar de naam en de prefix, de omgeving, het doel, waar de programma's draaien en de linkwijze. Geef de app de naam termtools; de prefix wordt /usr/app/termtools. Kies de Ubuntu 24.04-builder als omgeving, laat deze NAS als doel staan en de linkwijze op dynamisch, en ga dan verder met Recepten kiezen.

Boven de recepten toont Recepten uit een project de projecten die recepten bevatten, en Geen: alleen de bibliotheek. Kies cmatrix. De lijst toont dan eerst de recepten van het project, onder de naam van het project en gemarkeerd met project, en die van de bibliotheek onder Receptenbibliotheek. Een projectrecept dat een bibliotheekrecept vervangt, toont vervangt versie … uit de bibliotheek met de versie van dat recept.

Vink cmatrix aan in de groep van het project, en tmux en htop in die van de bibliotheek; het zoekvak vindt ze. De Bouwvolgorde voegt de recepten toe die ze nodig hebben, en zet bij elk daarvan het recept dat het nodig heeft. Controle somt elke keuze op, waaronder Recepten uit een project, en Aanmaken en bouwen maakt de app aan en start zijn build.

03De build

De pagina van de app volgt de build recept voor recept. Onder de naam van de app staat Recepten uit het project cmatrix; voor een developer is dat een link naar het project. De buildtaak leest de recepten van het project één keer, bij de start, en het logboek vermeldt wat de taak las:

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

Een bestand van het project dat daarna wordt opgeslagen, wacht op de volgende build: Opnieuw bouwen op de pagina van de app.

04Activeer hem, gebruik hem elders

Activeren (voor een admin) maakt van /usr/app/termtools een koppeling naar de nieuwste geslaagde build, en de programma's draaien vanaf daar op de NAS:

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

Downloaden geeft de build als archief, om uit te pakken op dezelfde prefix op een NAS met dezelfde architectuur. Exporteren als QPKG (voor een admin, zodra QDK is geïnstalleerd: Toolchains, tabblad QNAP) verpakt hem als QTS-pakket zonder codehandtekening; een app die voor alleen deze NAS is gebouwd, wordt niet geëxporteerd. App Center uit je eigen repository toont hoe een pakket wordt ondertekend en aangeboden. Transmission vanaf nul volgt één programma van begin tot eind: van een NAS waarop nog niets is ingesteld tot een ondertekend QTS-pakket dat geïnstalleerd is en in de browser antwoordt.

05Een ander project, of geen

Met Wijzigen op de pagina van de app stel je Recepten uit een project opnieuw in: een ander project, of Geen: alleen de bibliotheek. Een gekozen recept dat in de nieuwe lijst ontbreekt, wordt onder het veld genoemd, zoals in Niet in deze lijst, weggelaten: cmatrix, en blijft buiten de app zolang die keuze geldt. De wijziging opslaan laat de bestanden van de app zoals ze zijn; de volgende build voert de wijziging door.

06Regels

• Een app vindt zijn project aan de hand van de naam van de map. Zodra de map hernoemd of verwijderd is, wordt een build van de app geweigerd met Er is geen project ‘cmatrix’., en dat geldt ook voor een wijziging die die naam behoudt: kies bij Wijzigen de nieuwe naam van de map of Geen: alleen de bibliotheek.
• Een projectrecept met een probleem wordt weggelaten, en het veld zegt waarom. Het recept met dezelfde naam uit de bibliotheek neemt zijn plaats niet in.
• Alleen een developer ziet de recepten van een project. Een viewer ziet de app en zijn builds; de pagina van de app meldt een viewer dat de bouwvolgorde niet wordt getoond.
• Een app maken vereist de rol developer. Activeren, Deactiveren en Exporteren als QPKG zijn voorbehouden aan een admin.