コミュニティソリューション

ZimaOSでインポートしたアプリアイコンを変更する:ダッシュボードではなくアプリのメタデータを使用する

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.

コミュニティからの回答は短いものの、正しいアーキテクチャ層を指摘しています。インポートしたアプリケーションのアイコンは、単なるダッシュボードの外観設定ではなく、アプリケーションのメタデータの一部です。

ZimaOSアプリのアイコンはどこから取得されるのか

現在のApp Storeプロトコルのリファレンスによると、ZimaOS App Storeのソースには、最上位のx-casaosメタデータを含むComposeファイルと、icon、サムネイル、スクリーンショットなどのアプリアセットが含まれます。つまり、永続的に使用するアイコンは、アプリを定義するパッケージまたは設定内で指定する必要があります。

以前の公式回答ではZimaOS App Storeへのコントリビューションが案内されていましたが、現在は正確な情報源としてv2プロトコルのドキュメントを参照するようになっています。

ダッシュボードが編集に最適な場所ではない理由

ダッシュボードだけで行った編集は、インポートしたアプリの再作成、更新、再インポート時に失われる可能性があります。最初のDockerアプリでは、実行中のDockerアプリケーションと、その表示に使用されるZimaOSメタデータの違いを説明しています。また、ZimaOS App Storeの要件では、現在のアプリケーションカタログの概要を確認できます。

カスタムインポートの場合は、ソースメタデータを更新する

ComposeまたはApp Storeパッケージを管理している場合は、アプリのメタデータが正しいアイコンアセットを参照するように設定し、現在のZimaOSの手順で設定を再適用または再インポートしてください。ダッシュボードのアイコンを変更するためだけに、実行中のコンテナ内にある任意のファイルを上書きしないでください。

複数のカスタムコンテナを管理している場合は、ZimaOS上のPortainerを使って実行時のサービスを確認できます。ただし、Portainerは、Zimaインターフェース上でカードをどのように表示するかを制御するZimaOSアプリメタデータの代わりにはなりません。

結論

インポートしたアプリケーションでは、アイコンをパッケージメタデータとして扱ってください。保守しやすい解決策は、アプリの現在のx-casaosメタデータとアセットを修正してから再デプロイまたは再インポートすることであり、カードごとのダッシュボードアイコン切り替え設定を探すことではありません。