Solução da comunidade

Alterar o ícone de uma aplicação importada no ZimaOS: usar os metadados da aplicação, não o painel de controlo

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.

A resposta da comunidade é curta, mas aponta para a camada arquitetural certa: o ícone de uma aplicação importada faz parte dos metadados da aplicação, não é apenas uma preferência estética do painel.

De onde vêm os ícones das aplicações do ZimaOS

A atual referência do protocolo da App Store indica que uma fonte da ZimaOS App Store inclui um ficheiro Compose com metadados x-casaos de nível superior, além de recursos da aplicação, como icon, miniaturas e capturas de ecrã. Isto significa que o ícone persistente deve ser definido no pacote/configuração que descreve a aplicação.

A resposta oficial mais antiga remetia para a contribuição para a ZimaOS App Store, que agora encaminha os contribuidores para a documentação do protocolo v2 como fonte de referência.

Porque não é melhor editá-lo no painel

Uma alteração feita apenas no painel pode perder-se quando uma aplicação importada é recriada, atualizada ou importada novamente. A primeira aplicação Docker explica a diferença entre a aplicação Docker em execução e os metadados do ZimaOS utilizados para a apresentar, enquanto os requisitos da ZimaOS App Store fornecem o contexto atual do catálogo de aplicações.

Numa importação personalizada, atualize os metadados de origem

Se controlar o pacote Compose ou da App Store, indique nos metadados da aplicação o recurso de ícone correto e, em seguida, reaplique ou importe novamente a configuração utilizando o fluxo de trabalho atual do ZimaOS. Não substitua ficheiros arbitrários dentro de um contentor em execução apenas para alterar o ícone no painel.

Se gerir vários contentores personalizados, o Portainer no ZimaOS pode ajudar a inspecionar os serviços em execução, mas o Portainer não substitui os metadados da aplicação do ZimaOS que controlam a forma como um cartão é apresentado na interface Zima.

Em suma

Para aplicações importadas, trate o ícone como metadados do pacote. A solução sustentável é corrigir os metadados/recursos x-casaos atuais da aplicação e, em seguida, implementá-la ou importá-la novamente, em vez de procurar um interruptor de ícone por cartão no painel.