Un’app personalizzata dalle tue ricette e da quelle della libreria
Un’app di App Builder può usare le ricette di un progetto oltre a quelle della libreria. Questa guida crea l’app termtools nella pagina App, con cmatrix dal progetto di La tua prima ricetta e tmux e htop dalla libreria, poi la attiva sul NAS e la esporta.
- Progettole tue ricette
- Nuova appRicette da un progetto
- Ricettedel progetto e della libreria
- Buildun solo job
- UsoAttiva, Esporta
Le immagini provengono dal pannello di Bucket & Code Server IDE, con ogni passaggio eseguito come descritto in questa guida.
01Cosa prende un’app da un progetto
Oltre alle ricette della libreria, un’app può usare quelle di un solo progetto. Va bene qualsiasi progetto della pagina Progetti, di qualunque tipo, appena la sua cartella recipes/ contiene una ricetta. Una ricetta del progetto con lo stesso nome di una ricetta della libreria la sostituisce, ma solo nelle app che usano questo progetto.
02Nuova app con le ricette di un progetto
Nella pagina App, Nuova app chiede prima nome e prefisso, ambiente, destinazione, dove girano i programmi e modalità di collegamento. Chiama l’app termtools; il suo prefisso diventa /usr/app/termtools. Scegli il builder Ubuntu 24.04 come ambiente, lascia questo NAS come destinazione e la modalità di collegamento su dinamica, poi prosegui con Scegli le ricette.
Sopra le ricette, Ricette da un progetto elenca i progetti che contengono ricette e Nessuno: solo la libreria. Scegli cmatrix. L’elenco mostra allora prima le ricette del progetto, sotto il nome del progetto e segnate progetto, e quelle della libreria sotto Libreria di ricette. Una ricetta del progetto che sostituisce una ricetta della libreria riporta sostituisce la versione … della libreria con la versione di quella ricetta.
Spunta cmatrix nel gruppo del progetto, e tmux e htop in quello della libreria; la casella di ricerca li trova. L’Ordine di build aggiunge le ricette di cui hanno bisogno e segna ognuna con la ricetta che la richiede. Revisione elenca ogni scelta, tra cui Ricette da un progetto, e Crea e compila crea l’app e ne avvia la build.
03La build
La pagina dell’app segue la build ricetta per ricetta. Sotto il nome dell’app riporta Ricette dal progetto cmatrix, che un developer vede come link al progetto. Il job di build legge le ricette del progetto una volta sola, quando parte, e il suo log dice cosa ha letto:
recipes of the project cmatrix, read at the job's start: 1 (cmatrix)
Un file del progetto salvato dopo quel momento vale solo dalla build successiva (Ricompila nella pagina dell’app).
04Attivala, portala altrove
Attiva (riservato agli admin) trasforma /usr/app/termtools in un collegamento alla build riuscita più recente, e i programmi si avviano sul NAS da lì:
/usr/app/termtools/bin/cmatrix /usr/app/termtools/bin/tmux -V
Scarica fornisce la build come archivio, da decomprimere nello stesso prefisso su un NAS della stessa architettura. Esporta come QPKG, riservato agli admin una volta installato QDK (Toolchain, scheda QNAP), la impacchetta come pacchetto QTS senza firma del codice; un’app compilata solo per questo NAS non viene esportata. App Center dal tuo repository mostra come un pacchetto viene firmato e proposto. Transmission da zero segue un programma fino in fondo, da un NAS senza nulla di configurato a un pacchetto QTS firmato installato e raggiungibile dal browser.
05Un altro progetto, o nessuno
Cambia nella pagina dell’app reimposta Ricette da un progetto: un altro progetto, oppure Nessuno: solo la libreria. Una ricetta scelta che manca nel nuovo elenco viene indicata sotto il campo, come in Non in questo elenco, escluse: cmatrix, e resta fuori dall’app finché vale quella scelta. Salva la modifica lascia i file dell’app come sono; la modifica ha effetto con la build successiva.
06Regole
- Un’app trova il suo progetto in base al nome della cartella. Una volta rinominata o rimossa la cartella, una build dell’app viene rifiutata con Non esiste un progetto “cmatrix”., e lo stesso vale per una modifica che mantiene quel nome: Cambia accetta il nuovo nome della cartella oppure Nessuno: solo la libreria.
- Una ricetta del progetto con un problema viene esclusa, e il campo ne indica il motivo. La ricetta della libreria con lo stesso nome non prende il suo posto.
- Solo un developer vede le ricette di un progetto. Un viewer vede l’app e le sue build; la pagina dell’app dice a un viewer che l’ordine di build non è mostrato.
- Per creare un’app serve il ruolo developer. Attiva, Disattiva ed Esporta come QPKG sono riservati agli admin.