Inno Setup 日本語デベロッパーズガイド

基本的な項目について

Inno Setup でインストーラを作成する場合に、[Setup] セクションで設定する基本的な項目です。

項目名	記述する内容
AppName	インストールするアプリケーションの名前を指定します。ここで指定される名前が、ウィザードページのタイトルなどに表示されます。
AppVerName	アプリケーション名にバージョン番号を付加した文字列を指定します。「ようこそ」ウィザードページ内等で表示されます。
OutputBaseFilename	作成するインストーラのファイル名を指定します。ここで指定される文字列に「.exe」が付加された文字列がインストーラのファイル名になります。 ( 指定しない場合には、インストーラのファイル名は setup.exe になります。 )
OutputDir	インストーラが作成されるディレクトリを指定します。指定しない場合には、インストールスクリプトがあるディレクトリに「output」ディレクトリを作成して、そのディレクトリ内にインストーラが作成されます。
DefaultDirName	インストールディレクトリに設定する初期値を指定します。インストールディレクトリの指定については、インストールディレクトリ設定についてで説明します。

	AppName, AppVerName の主な反映箇所(フレッシュミーティングの場合)

ファイル情報設定について

インストールのファイル情報に表示する項目設定は以下になります。

項目名	記述内容
VersionInfoVersion	インストーラファイルのプロパティに表示される「ファイルバージョン」の値を指定します。バージョンは、４桁区切り(x.x.x.x) の形式になります。
VersionInfoDescription	インストーラファイルのプロパティに表示される「説明」の内容を指定します。
AppCopyright	インストーラファイルのプロパティに表示される「著作権」の内容を指定します。

	インストーラファイルのプロパティダイアログ：「全般」タブ

	インストーラファイルのプロパティダイアログ：「バージョン情報」タブ

インストールディレクトリ設定について

インストールディレクトリ設定については、以下の項目を設定します。

項目名	記述内容
DefaultDirName	インストールディレクトリに設定する初期値を指定します。
UsePreviousAppDir	前回インストールしている情報からインストールディレクトリ入力の初期値を設定するかを設定します。yes (初期値) にしている場合には、前回インストール情報から、インストールディレクトリの初期値を設定します。
AppendDefaultDirName	インストールディレクトリ指定時に、DefaultDirName に指定してある最終要素(最下層のディレクトリ)が自動で付加するかを指定します。初期値は yes になっています。

Inno Setup でのインストールディレクトリの設定初期値について
	Inno Setup では、インストールディレクトリの設定初期値は、インストール情報から取得する仕様になっています。通常、インストールディレクトリ設定初期値は以下のように決定されます。 1. インストール情報(レジストリに保存)があれば、その値を使用する 2. DefaultDirName に指定されている値を使用する Setup セクションで、Uninstallable に no を設定していない限り( 初期値はyes ) 、Inno Setup で作成されたインストーラは、インストールディレクトリを含めたインストール情報をレジストリに書き込みます。
インストールディレクトリ設定初期値を常に同じにするには
	UsePreviousAppDir の値を no にすることで、インストールディレクトリ設定初期値が常に DefaultDirName になります。
AppendDefaultDirName について
	AppendDefaultDirName　が yes (初期値) になっている場合には、以下のような動作になります。 DefaultDirName = {pf}\installdir に指定している場合 ( {pf} はプログラムファイルフォルダを指す定数です ) インストールディレクトリ設定ウィザードページ AppendDefaultDirName = yes で　「参照」を押して、ディレクトリを変更したとき AppendDefaultDirName = no で　「参照」を押して、ディレクトリを変更したとき AppendDefaultDirName = no の動作をするインストーラがほとんどかと思います。 Inno Setup の場合には、初期値が yes になっているため、AppendDefaultDirName = no の指定をする方がよいかと思います。

インストーラでの画像表示について

インストーラで表示するイメージについては、以下の設定で行います。

項目名	記述内容
SetupIconFile	インストーラの表示アイコンを ico ファイルのファイルパスで指定する。
WizardImageFile	ウィザードページに表示される画像を bmpファイルパスで指定する。ここで使用する bmp ファイルの画像サイズは 164 x 314（ピクセル）にする。
WizardImageStretch	WizardImageFile で指定した画像ファイルをウィザードページの大きさに合わせて拡大表示するかを指定する。初期値は yes になっているが、164 x 314 のサイズで画像を設定しても少し拡大表示されてしまうようなので、明示的に no を指定した方がよいと思われる。
WizardImageBackColor	WizardImageStretch = no にしたとき、 WizardImageFile で指定した画像表示部分で画像部分ではない箇所の色を指定する。初期値は、$400000 で、RGB で色指定できる。また、いくつかの色については定義されている。詳しくは、ヘルプ：使い方－スクリプトのセクション－ [Setup] セクション－WizardImageBackColor を参照する。
WizardSmallImageFile	ウィザードページの右上部分にある画像を bmpファイルパスで指定する。使用する bmpファイルの画像サイズは、55 x 58（ピクセル）にする。

WizardImageFile、WizardSmallImageFile で指定する bmp画像のサンプルは、Wizard Images からダウンロードすることができます。(ページ右側にある download リンクをクリックします。)

SetupIconFile の反映箇所
	ファイルアイコンインストーラのプロパティダイアログでの表示
WizardImageFile の表示領域

WizardSmallImageFile の表示箇所

「プログラムの追加と削除」での表示設定について

アンインストール情報の表示（「プログラムの追加と削除」でのサポート情報の表示）は、以下項目で設定します。

「プログラムの追加と削除」ダイアログ

サポート情報の表示

項目名	記述内容
AppPublisher	1. に表示される。アプリケーション配布元の名前を設定する。
AppPublisherURL	1. のリンク先URL に設定される。アプリケーション配布元 Webサイトの URLを設定する。
AppVersion	2. に表示される。アプリケーションのバージョン番号を設定する。
AppContact	3. に表示される。連絡先を設定する。
AppSupportURL	4. に表示される。アプリケーションについてのサポートサイトの URLを設定する。
AppReadmeFile	5. に表示される。説明ファイルのファイルパスを設定する。設定してある場合には、ファイル起動のリンクが表示される。
AppUpdatesURL	6. に表示される。アプリケーションの更新を行うサイトの URLを設定する。
AppComments	7. に表示される。インストールするアプリケーションの説明を設定する。

イベント関数について

[Code] セクションでは、インストーラに独自の処理をさせるように記述します。
実行する処理の定義は、イベント毎に記述することになります。

詳しくは、ヘルプ：使い方－パスカル・スクリプト－イベント関数 を参照してください。

イベント(関数)名	イベント内容
InitializeSetup	セットアッププログラム実行前に呼び出されます。使用する変数の初期化などを行います。ダイアログの初期化については、InitializeWizard 関数で行います。
InitializeWizard	セットアッププログラム実行前に呼び出されます。この関数では、ダイアログに対する処理(作成など)を行います。
DeinitializeSetup	セットアッププログラムが終了する前に呼び出されます。
CurStepChanged	セットアッププログラムにある３つのステップが切り替わった時に呼び出されます。ステップは以下になります。・インストール処理が始まる直前・インストール処理が終わった直後・インストールが成功し、セットアッププログラムが終了する直前
NextButtonClick	各ダイアログで、「次へ」ボタンが押されたときに呼び出されます。
BackButtonClick	各ダイアログで、「前へ」ボタンが押されたときに呼び出されます。
CancelButtonClick	各ダイアログで、「キャンセル」/「閉じる」ボタンが押されたときに呼び出されます。
ShouldSkipPage	強制表示されるダイアログ以外のダイアログを表示する前に呼び出されます。True を返値に設定するとそのダイアログは表示されずに処理が進みます。強制表示されるダイアログは以下になります。・ようこそダイアログ・インストール準備中ダイアログ・インストール実行中ダイアログ
CurPageChanged	各ダイアログが表示されたときに呼び出されます。
CheckPassword	セットアッププログラムの実行にパスワードを設定する場合には、このイベント関数を記述します。
NeedRestart	インストールが正常に終了した後に、システムの再起動を行う場合には、このイベント関数を記述します。
UpdateReadyMemo	インストール情報を表示するダイアログ(インストールの準備ができました) を表示する直前に呼び出されます。インストール情報の内容を変更する場合に記述します。
RegisterPreviousData	セットアッププログラムで入力された情報をレジストリに書き込む場合に記述します。
CheckSerial	セットアッププログラムで、ユーザー情報を入力させるようにしていて、でシリアル番号も入力項目に含める場合に記述します。

InitializeUninstall	アンインストールプログラム実行前に呼び出されます。
DeinitializeUninstall	アンインストールプログラムの終了直前に呼び出されます。
CurUninstallStepChanged	アンインストールプログラムにある３つのステップが切り替わった時に呼び出されます。ステップは以下になります。・アンインストール処理が始まる直前・アンインストール処理が終わった直後・アンインストール成功し、アンインストールプログラムが終了する直前
UninstallNeedRestart	アンインストールが正常に終了した後に、システムの再起動を行う場合には、このイベント関数を記述します。

変数の記述について

変数の記述書式です。

変数の宣言

変数名 : 変数の型 ;
　　　

変数型について

パスカルスクリプトなので、パスカルの変数型が使用できます。

・主な変数型

String	文字列型です。
Integer	数値型です。
Boolean	真偽( True / False )型です。
TArrayOfString	文字列型の配列です。
TArrayOfInteger	数値型の配列です。

	グローバル変数関数外で変数の宣言をした場合には、グローバル変数として処理されます。 const で宣言した場合には、静的な変数になります。 const 　静的なグローバル変数宣言 var 　グローバル変数宣言 procedure FUNCA() 　　　：　　　： function FUNCB() 　　　：　　　：
	ローカル変数関数内でのみ有効な変数になります。関数名( procedure, function ) ～ begin の間に変数の宣言を行います。関数名(procedure / function )() var 　ローカル変数宣言 begin 　処理 end;

関数の記述について

スクリプトで関数を記述する場合、以下のように記述します。

	procedure 返値無しの関数を記述する場合には、procedure を記述します。 procedure( 引数 ) var 　ローカル変数宣言 begin 　処理 end; 例 ) // グローバル変数 var 　nIndex : integer;　 procedure Initialize () begin 　 nIndex := 1; end;
	function 返値を持つ関数を記述する場合には、function を記述します。返値については、「Result := 返値」の書式で記述します。 function( 引数 ):返値の変数型 var 　ローカル変数宣言 begin 　処理　 Result := 返値; end; 例 ) function Initialize ( strName :string ) begin 　strName := '初期値'; 　Result := strName; end;

引数の記述について

引数は、以下の書式で記述します。

関数名( 引数1 : 引数1の変数型 ; 引数2 : 引数2の変数型 ; ・・・ )

また、参照渡し等の記述を行うことができます。

引数を参照渡しする場合( 呼び出し側の変数の値も変わる )
　　var 引数 : 引数の型 ;

引数を静的に扱う場合( 変数の値は変わりません )
　　const 引数 : 引数の型 ;

関数の宣言の順番について

関数内で、別の関数を呼び出す場合、呼び出される関数は既に宣言されている必要があります(サポート関数は除く。)。よって、呼び出される関数の記述は、呼び出す関数の記述よりも前に行われている必要があります。

条件分岐の記述書式

スクリプトでの条件分岐の記述書式です。

	if 文 if ( 条件文 ) then begin 　処理 end else if ( 条件文 ) then begin 　処理 end else begin 　処理 end;
	case 文 case ( 変数名 ) of 　値1: 　　　処理　値2: 　　　処理　値3: 　　　処理　　 : 　 else 　　　処理 end; 値が文字列になる場合には、'' で括る

	条件判定について if 文やループ文での比較による条件判定は、以下のように行います。
		数値の比較 =, <, >, <> を使って条件判定を行います。例： nHoge が 5 の場合 if ( nHoge = 5 ) then begin 　：
		文字列の比較 CompareText, CompareStr を使って条件判定を行います。例： strHoge が、空文字でない場合 if ( CompareText( strHoge, '' ) <> 0 ) then begin 　： ※CompareStr を使った場合、大文字小文字を区別する動作になります。

繰り返し処理の記述書式

スクリプトでの繰り返し処理の記述書式です。

	for 文 for 変数 := 値1 to 値2 do begin 　　処理 end; 値1 が値2 になるまで処理が繰り返し行われます。処理が一度行われる毎に値1 が +1 されます。また、to を downto とすることで、値1 -1 の動きにすることができます。
	while 文 while ( 条件文 ) do then 　　処理 end; 条件文が真の間は、処理が繰り返し行われます。
	repeat 文 repeat 　　処理 until ( 条件文 ); 条件文が真になるまで、処理が繰り返し行われます。

繰り返し処理を途中で抜けるには、 break を使用します。

簡単なインストーラを作成する

Inno Setup を使って簡単なインストーラを作成します。

Inno Setup を起動します。
以下のダイアログが表示されますが、「Cancel」を押して閉じます。

以下のスクリプトを、貼り付けて、ビルドを実行します。

[Setup]

// アプリ名
AppName=MyApp
// アプリ名＋バージョン
AppVerName=MyApp 1.0
// アーカイブ名
OutputBaseFilename=MyApp
// 初期インストールディレクトリ
DefaultDirName=c:\installtest

[Languages]
Name: japanese; MessagesFile: compiler:Languages\Japanese.isl

ビルドが正常に終了すると、Inno Setup のインストールディレクトリ下に、
Output という名前のディレクトリが作成され、そのディレクトリ内に
MyApp.exe というインストールアーカイブが作成されています。

Inno Setup 5(インストールディレクトリ)
Examples
Languages
Output	← 新しく作成される。　　ディレクトリ内に、インストールアーカイブファイルが作成される。
Inno Setup のプログラムファイル等：

作成された MyApp.exe を実行します。

インストールが終了すると、インストールディレクトリが作成されます。

インストール情報が、レジストリに書き込まれ
「アプリケーションの追加と削除」の一覧に表示されます。

アンインストールを実行すると、インストールディレクトリ「c:\installtest」が削除されます。

インストール情報のレジストリ書き込みについて

Inno Setup では、インストール情報を以下のキーでレジストリに書き込みます。

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\[AppName]_is1]

[AppName] は、[Setup] セクションで AppName に指定した値になります。
このキーに書き込まれた値を元に、「プログラムの追加と削除」でのインストール情報表示や、アンインストールプログラムの実行を行います。

以上が、インストーラ作成の基本的な流れとなります。
今回は、インストールスクリプトに [Setup] と [Languages] セクションのみ記述しましたが
Inno Setup には、インストールするファイルを指定するセクションなどもあります。
次に、各セクションについて説明します。

>>Inno Setup での各セクションについて

セクションについて

Inno Setup で記述するセクションには以下があります。

セクション名	記述する内容
[Setup]	インストーラ全体に対する設定を定義する。
[Types]	インストール方法(簡単/カスタムなど)を定義する。
[Components]	インストール方法を設定するときに、それぞれの方法でインストールされるファイル群( コンポーネント ) について定義する。
[Tasks]	インストール処理を、ユーザー側で細かく設定する場合に、それぞれの処理( タスク ) について定義する。
[Dirs]	インストール時にインストールディレクトリ下に作成するディレクトリについて定義する。 [Files] セクションで、ディレクトリも指定できるため、空のディレクトリを作成するために記述される。
[Files]	インストールするファイルを定義する。
[Icons]	インストール時に作成するプログラム等へのショートカットファイルについて定義する。
[INI]	.INI ファイルを使用する場合に、インストール時に .INI ファイルに対して書き込む内容を定義する。
[InstallDelete]	インストール時に、削除するファイルがあれば定義する。
[Languages]	インストーラが使用する言語を定義する。
[Messages]	インストーラで表示する文字列を定義する。通常は、[Languages]で定義した .isl ファイルで全て指定してあるため定義する必要はない。
[CustomMessages]	インストーラでカスタムメッセージを表示する場合には、その内容を定義する。
[LangOptions]	インストーラで表示する文字について、フォント、文字サイズなどを定義する。通常は、[Languages]で定義した .isl ファイルで全て指定してあるため定義する必要はない。
[Registry]	インストーラでレジストリキーを編集する場合、その内容を定義する。
[Run]	インストーラの実行終了後に起動するプログラムがあれば定義する。
[UninstallDelete]	アンインストール時に、インストール時に作成したファイル、ディレクトリ以外を削除する場合に、その内容を定義する。インストールしたプログラムが作った INI ファイルの削除などを記述する。
[UninstallRun]	アンインストールを実行するときに起動するプログラムがあれば定義する。
[Code]	インストーラに独自処理をさせる場合に、その内容をパスカルスクリプトで定義する。

各セクションの詳しい用途、記述内容については、
ヘルプ：「使い方」－「スクリプトのセクション」を参照してください。

■参考： MASATOの開発日記－Inno Setupの使用例

ウィザードページ(ダイアログ)について

セットアッププログラムで表示されるウィザードページには、デフォルトで表示されるものと
設定を記述することで表示/非表示を切り替えられるものがあります。

カスタムダイアログを作成している場合には、[Code] セクションのイベント関数に記述して表示/非表示を管理します。

詳しくは、ヘルプ：「他の情報」－「ウィザードページ」 を参照してください
( ヘルプ内に表示されている順にウィザードページは表示されます。 )

デフォルトで表示されるウィザードページ
ようこそ	必ず表示される。
インストール先フォルダの選択	[Setup] セクションで DisableDirPage=no に設定すると表示されない。
インストールの準備をしています	必ず表示される。
インストールの準備ができました	[Setup] セクションで DisableReadyPage=no に設定すると表示されない。
インストールしています	インストール実行中に必ず表示される。
セットアップが終了しました	[Setup] セクションで DisableFinishedPage=no に設定すると表示されない。 [Run] セクションで起動するプログラムについて記述されている場合は、実行を確認するチェックボックスが表示される。
設定で表示するウィザードページ
使用許諾	[Setup] セクションで LicenseFile= を設定すると表示される。
パスワード	[Setup] セクションで Password= を設定すると表示される。
情報／README	[Setup] セクションで InfoBeforeFile= を設定すると設定したファイルの内容で表示される。
ユーザー情報	[Setup] セクションで UserInfoPage=yes を設定すると表示される。 [Code] セクションでイベント関数 CheckSerial を記述している場合には、シリアル番号入力欄が表示される。
コンポーネントの選択	[Components] セクションで１つ以上エントリが記述されている場合には表示される。
スタートメニューフォルダの選択	[Icon] セクションで１つ以上エントリが記述されている場合には、表示されるが、 [Setup] セクションで DisableProgramGroupPage=No を指定した場合には、表示されない。
タスクの選択	[Tasks] セクションで１つ以上エントリが記述されている場合には、表示される。
情報／README	[Setup] セクションで InfoAfterFile= を設定すると設定したファイルの内容で表示される。

基本的な記述について

[Files] セクションでは、インストールするファイルについての記述を行います。

	書式 Source: [ファイル] ; DistDir: [インストール先] ; [オプション]
	Source で記述する内容についてインストーラをビルドするときに、ソースとなるファイルのパスを指定します。特定ディレクトリ以下のファイルを全て含めたい場合は、ワイルドカード() を使います。例) Source: "c:\files\" また、[Setup] セクションで、ソースディレクトリを指定することもできます。以下の記述がある場合には、Source: で指定するファイルは、絶対パス指定を行わない限り、SourceDir で指定したディレクトリ以下と見なされます。 [Setup] SourceDir=c:\files
	DistDir で記述する内容についてインストール時に、ファイルをコピーする先のディレクトリを指定します。「インストール先の指定」ウィザードページを使用している場合には、定数 {app} で、インストールディレクトリを記述することができます。例) Source: file.txt ; DistDir: {app} 上記の例の場合には、「インストール先の指定」ウィザードページで指定されたディレクトリ下に、file.txt がインストールされます。 Inno Setup で使用できる定数については、ヘルプ：「使い方」－「定数」を参照してください。

インストール時にパーミッションを変更する

Permissions オプションを使用することで
インストール時にパーミッションを変更することができます。

ディレクトリに対してパーミッションを変更したい場合には、
[Dirs] セクションに記述します。

パーミッション設定は、「対象ユーザー/グループ」－「操作」の形で
指定します。

「対象グループ/ユーザー」に記述できるのは以下になります。

Inno Setup での記述	Windowsでのグループ
admins	Administrators ( 管理者グループ )
authusers	Authenticated Users
everyone	Everyone ( 全員 )
powerusers	Power Users
system	SYSTEM
users	Users ( 一般ユーザー )

「操作」に記述できるのは以下になります。

Inno Setup での記述	操作できる内容
full	modify でできることに加えて、パーミッションの変更を行うことができる。
modify	読み込み / 変更 / 実行 / 削除を行うことができる。
readexec	読み込み / 実行を行うことができる。

記述例

・管理者グループのみ全ての操作を行うことができるようにする
　 Source:file.txt; DistDir:{app};permissions:admins-full

・全員がパーミッション変更以外の操作を行うことができるようにする
　 Source:file.txt; DistDir:{app};permissions:everyone-modify

・一般ユーザーが、読み込み/実行のみ行えるようにする
　 Source:file.txt; DistDir:{app};permissions:users-readexec

・全員が全ての操作を行えるディレクトリ名「db」を作成する
　[Dirs]
　 Name: {app}\db;Permissions: everyone-full　

Inno Setup 日本語 デベロッパーズガイド