Package Maker #4 （インストールの必須条件のチェック）

作者: 小見拓 — 最終変更 2012年01月08日 12時16分

この記事では「Package Maker」で作成されるインストーラーで行われるインストールの必須条件のチェック方法についての説明をします。 (Mac)

この記事では「Package Maker」で作成されるインストーラーで行われるインストールの必須条件のチェック方法についての説明をします。

インストール時に、インストールの必須条件が整っているかをチェックするためには、「InstallationCheck」「VolumeCheck」という名前のスクリプトを用意します。
このスクリプトが返す結果で、「Package Maker」で作成するインストーラーの挙動を変えられます。

# 例。スクリプトでの結果の返し方。
#!/bin/sh
exit 127

返すコード	チェックの結果	備考
0	成功	そのままインストールは継続される。
32	警告表示	「インストールできません」と警告を表示。インストール作業は継続する。
48～63	警告表示	上と同じく警告を表示するが、表示するメッセージを指定できる。
64	インストール中止	インストールを中止する。
112～127	インストール中止	上と同じくインストールを中止するが、表示するメッセージを指定できる。

返すコード	チェックの結果	備考
0	成功	そのままインストールは継続される。
32	失敗	インストールを失敗させる。
48～63	失敗	上と同じくインストールを失敗させるが、表示するメッセージを指定できる。

表示するメッセージは、Mac OSX独自の形式でローカライズされたメッセージファイルを使って、指定します。
インストーラーは、

メッセージを取得して表示します。

メッセージファイルのフォーマットは次の書式です。

メッセージ1のキー="表示するメッセージ1";
メッセージ2のキー="表示するメッセージ2";

特定ロケール用のメッセージファイルは、「ロケール名 + .lproj」という名前のディレクトリを用意し、そのディレクトリ内に配置します。

という名前のディレクトリに、そのロケール用のメッセージファイルを入れます。

メッセージファイルからメッセージを取得するキーは、 InstallationCheck、VolumeCheck、各スクリプトの返した結果から決定されます。
下に用意した表はその対応表です。

スクリプトの結果と、表示するメッセージのキーの対応表
スクリプト	48 ～ 63	112 ～ 127
InstallationCheck	（スクリプトで返した値 - 32）	（スクリプトで返した値 - 96）
VolumeCheck	（スクリプトで返した値 - 32）

例えば、VolumeCheckで「60」を返した場合は、

60 - 32

となり、メッセージファイルのキー「28」のメッセージを表示します。

下記に記述したファイルを用意し、「Package Maker」のResourcesタブで指定すると、
前記の表に従って(InstallationCheckで120の結果) インストールが中止され、
前述のとおり、キー「24」 (120-96=24で) のメッセージが表示されます。

InstallationCheck
Japanese.lproj/InstallationCheck.string

# InstallationCheck
#!/bin/sh
exit 120

# Japanese.lproj/InstallationCheck.string
24="インストールできません。";