6 jpackageリソースのオーバーライド
生成されたパッケージの拡張カスタマイズは、プロパティおよびスクリプトのバックグラウンド・イメージやテンプレート・ファイルなど、jpackage
で使用されているリソースをオーバーライドすることで可能になります。--resource-dir
オプションは、ツールへのオーバーライドを指定するために使用されます。
アプリケーションをパッケージ化するときにjpackage
が使用するデフォルト・リソースがニーズを満たさない場合は、ディレクトリを作成して、カスタマイズしたファイルを追加します。ファイルをオーバーライドする場合、カスタム・ファイルにはデフォルトに含まれるすべてのプロパティが含まれている必要があります。--resource-dir
オプションを使用して、ディレクトリのパスをjpackage
に渡します。このパスは、絶対パスまたは現在のディレクトリからの相対パスのいずれかで指定できます。
ノート:
アイコン、アプリケーション・バージョン、アプリケーションの説明、著作権などのリソースは、コマンドラインからオーバーライドできます。使用可能な場合は、コマンドライン・オプションの使用をお薦めします。次のトピックでは、オーバーライドできるリソース、およびデフォルトの内容を確認する方法を説明します。
トピック:
パッケージ化で使用されるリソース
パッケージ化ツールには、アプリケーションのパッケージの生成時に使用するデフォルトのテンプレートおよびその他のリソースが含まれます。
リソースはプラットフォームによって異なり、次の項で説明します。ほとんどの場合、コマンドライン・オプションでオーバーライドされるリソースは、リソース・ディレクトリのリソースより優先されます。コマンドラインでオーバーライドできないリソースをオーバーライドするには、カスタマイズしたファイルを、jpackage
に渡すリソース・ディレクトリに追加します。「リソースの表示」で説明されている--verbose
オプションを使用して、リソースごとにオーバーライド・ファイルの名前を検証します。
Linux (すべてのバージョン)
-
メインのランチャおよびその他のランチャのアイコン・ファイル
launcher.png
。各ランチャには個別のアイコンがあります。このファイル名は、アプリケーションの名前またはランチャの名前と一致している必要があります。ランチャにアイコン・ファイルが提供されていない場合は、デフォルトのアイコンが使用されます。 -
デスクトップ・ショートカット・ファイル(
launcher.desktop
)は、メイン・ランチャおよびその他のランチャを対象としています。ファイル名は、アプリケーションの名前またはランチャの名前と一致している必要があります。
Linux DEB
-
制御テンプレート、
control
。アプリケーションに関する情報を含むファイル。 -
インストール前スクリプト、
preinst
。アプリケーションがインストールされる前に実行されるスクリプト。 -
削除前スクリプト、
prerm
。アプリケーションがアンインストールされる前に実行されるスクリプト。 -
インストール後スクリプト、
postinst
。インストールの完了後に実行されるスクリプト。 -
削除後スクリプト、
postrm
。アプリケーションがアンインストールされた後に実行されるスクリプト。 -
著作権ファイル、
copyright
。著作権およびライセンス情報を含むファイル。
Linux RPM
-
パッケージ化の仕様、
package-name.spec
。アプリケーションをパッケージ化する手順。
macOS (すべてのフォーマット)
-
メインのランチャおよびその他のランチャのアイコン・ファイル
launcher.icns
。複数のファイルを指定できます。このファイル名は、アプリケーションの名前またはランチャの名前と一致している必要があります。ランチャにアイコン・ファイルが提供されていない場合は、デフォルトのアイコンが使用されます。 -
ランタイム・プロパティ・リスト、
Runtime-Info.plist
。 -
情報プロパティ・リスト、
Info.plist
。 -
デフォルトの権限ファイル
default.plist
。 -
Mac App Store
sandbox.plist
を介して配布されるアプリケーション・パッケージのデフォルトの権限ファイル。 -
イメージ後スクリプト、
application-name-post-image.sh
。アプリケーション・イメージが作成された後、DMGまたはPKGインストーラが構築される前に実行されるカスタム・スクリプト。デフォルト・スクリプトはありません。
macOS DMG
-
DMG設定スクリプト、
application-name-dmg-setup.scpt
。 -
アプリケーション・ライセンスのプロパティ・リスト、
application-name-license.plist
。 -
バックグラウンド・ファイル、
application-name-background.tiff
。 -
ドライブ・アイコン、
application-name-volume.icns
。
macOS PKG
-
インストール前スクリプト、
preinstall
。アプリケーションがインストールされる前に実行されるスクリプト。 -
インストール後スクリプト、
postinstall
。インストールの完了後に実行されるスクリプト。 -
明るいモードのバックグラウンド・イメージ、
application-name-background.png
。 -
暗いモードのバックグラウンド・イメージ、
application-name-background-darkAqua.png
。
Windows
-
イメージ後スクリプト、
application-name-post-image.wsf
。アプリケーション・イメージが作成された後、MSIインストーラが.msi
パッケージと.exe
パッケージの両方用に構築される前に実行されるカスタム・スクリプト。デフォルト・スクリプトはありません。 -
メインWiXソース・ファイル、
main.wxs
。 -
WiX変数のオーバーライドを含むWiXソース・ファイル、
overrides.wxi
。このファイルの値は、メインWiXファイルの値をオーバーライドします。 -
メインのランチャおよびその他のランチャのアイコン・ファイル、
launcher.ico
。複数のファイルを指定できます。このファイル名は、アプリケーションの名前またはランチャの名前と一致している必要があります。ランチャにアイコン・ファイルが提供されていない場合は、デフォルトのアイコンが使用されます。 -
ランチャ・プロパティ・ファイル、
launcher.properties
。