Soluzione della community

Modifica l’icona di un’app importata in ZimaOS: usa i metadati dell’app, non la dashboard

A user installed OpenCloud through the ZimaOS GUI but could not assign the correct icon. Zima support pointed them to the IceWhale App Store contribution/configuration format rather than a dashboard-level icon editor.

La risposta della community è breve, ma indica il giusto livello architetturale: l’icona di un’applicazione importata fa parte dei metadati dell’applicazione, non è semplicemente una preferenza estetica della dashboard.

Da dove provengono le icone delle app di ZimaOS

L’attuale documentazione di riferimento del protocollo dell’App Store indica che una sorgente di ZimaOS App Store include un file Compose con metadati x-casaos di primo livello, oltre a risorse dell’app come icon, miniature e schermate. Ciò significa che l’icona permanente dovrebbe essere definita nel pacchetto o nella configurazione che descrive l’app.

La precedente risposta ufficiale rimandava alla contribuzione a ZimaOS App Store, che ora indirizza i contributori verso la documentazione del protocollo v2 come fonte autorevole.

Perché la dashboard non è il posto migliore per modificarla

Una modifica effettuata solo nella dashboard potrebbe andare persa quando un’app importata viene ricreata, aggiornata o importata nuovamente. La guida sulla prima app Docker spiega la differenza tra l’applicazione Docker in esecuzione e i metadati di ZimaOS utilizzati per presentarla, mentre i requisiti di ZimaOS App Store forniscono il contesto attuale del catalogo delle applicazioni.

Per un’importazione personalizzata, aggiorna i metadati sorgente

Se gestisci il file Compose o il pacchetto dell’App Store, imposta nei metadati dell’app il percorso corretto alla risorsa dell’icona, quindi applica nuovamente o reimporta la configurazione utilizzando l’attuale procedura di ZimaOS. Non sovrascrivere file arbitrari all’interno di un container in esecuzione solo per cambiare l’icona nella dashboard.

Se gestisci diversi container personalizzati, Portainer su ZimaOS può aiutarti a controllare i servizi in esecuzione, ma Portainer non sostituisce i metadati dell’app di ZimaOS che determinano come viene visualizzata una scheda nell’interfaccia di Zima.

In sintesi

Per le applicazioni importate, considera l’icona come parte dei metadati del pacchetto. La soluzione più facile da mantenere consiste nel correggere gli attuali metadati o le risorse x-casaos dell’app e poi ridistribuirla o reimportarla, invece di cercare un comando della dashboard per cambiare l’icona di una singola scheda.