.NET Orcaの使用方法

すべてのプログラムよりOrcaを起動します。
「File」→「Open」より編集するmsiを選択します。

編集後は「File」→「Save」で保存し、Orcaを終了してください。
終了せずにインストールを行うと「インストールパッケージを開くことができませんでした。」とエラーメッセージが表示されます。


ダイアログのボタンを無効にするには?


「Control」テーブルより無効にしたいボタンを探し、Atributesフィールドを「1」にします。
有効にしたい場合はAtributesフィールドを「3」にします。



ダイアログに表示されているテキストを変更するには?


「Control」テーブルより変更したいテキストを探し、Textフィールドを変更します。



ダイアログの×ボタンでインストール中止メッセージを表示しないようにするには?


あるダイアログのキャンセルボタンを無効にしても、ダイアログの×ボタンをクリックすると「インストールを中止しますか?」とメッセージが表示されてしまいます。
×ボタンでメッセージを表示せずにダイアログを閉じるには
「ControlEvent」テーブルより
「Dialog_」フィールドが変更したいダイアログで「Control_」フィールドが「CanncelButton」のデータを探し、下記のように変更します。

Dialog_Control_EventArgumentConditionOrdering
変更したいダイアログCanncelButtonEndDialogReturn0

.NET インストーラでアンインストールに失敗した場合、再インストール出来るようにするには?

アンインストール時にカスタム動作を設定したセットアッププロジェクトでインストールを行いました。
が、アンインストール時のカスタム動作で失敗してしまい、アンインストールできません・・・。
アンインストール出来なければ、再インストールもできません。

こんなたときはレジストリを操作することで再インストールが可能になります。

「すべてのユーザ」でインストールした場合はHKEY_CLASSES_ROOT\Installer\Products以下のサブキー
「このユーザのみ」でインストールした場合はHKEY_CURRENT_USER\Software\Microsoft\Installer\Products以下のサブキーを一つ一つ確認しそのサブキー内のProductsNameキーを確認して、該当するものをサブキーごと削除します。


これで再インストールが可能になります。

.NET Image画像の上に配置したLabelの背景を透過させるには?

Image画像の上に配置したLabelのBackColorプロパティをTransparentに設定しても
そのままではLabelの背景は透過されません。
これはLabelの親コントロールがFormになるため、ラベルの背景色がFormの背景色になるためです。
Labelの背景色を透過するためには、Labelの親コントロールをImageコントロールに変更します。

LabelコントロールのBackColorプロパティをTransparentに設定し
FormのコンストラクタでLabelの親コントロールを変更します。
Public Sub New()
' この呼び出しは、Windows フォーム デザイナで必要です。
InitializeComponent()

' InitializeComponent() 呼び出しの後で初期化を追加します。
Me.Controls.RemoveByKey(Me.Label1e.Name)
Me.PictureBox1.Controls.Add(Me.Lable1)

End Sub

.NET msi編集ツールOrca

Windows インストーラ ツールの制限により、Windows インストーラ パッケージ (.msi) ファイルを直接編集する必要がある場合があります。Orca エディタでは、マージ モジュール (.msm) ファイル、内部整合性検証 (.cub) ファイル、およびパッチ作成ファイル (.pcp) の編集と作成を行うことができます。


Orca のインストールと実行



Orcaは単体では配布されていません。OrcaはPlatform SDKに含まれています。
まずWindows Installer SDK を次のページからダウンロードしてインストールします。
Windows SDK for Windows Server 2008 and .NET Framework 3.5


インストールしたフォルダにある Orca.msi を実行しインストールします。(デフォルトではC:\Program Files\Microsoft SDK\Bin\Orca.Msi)

すべてのプログラムより[Orca] をクリックし実行します。
[File] メニューの [Open] をクリックし、編集する .msi ファイルを指定します。

.NET セットアッププロジェクト カスタム動作

Installクラスを使用したdllファイルのカスタムアクションを定義します。

前々回自作のアセンブリのインストールで、[参照の追加]ダイアログに表示するには?
で作成したソリューションを流用します。

ソリューションにクラスライブラリ「Action1」を追加し、Installerクラスを継承したInstaller1クラスを作成します。


Installer1.vb
<System.ComponentModel.RunInstaller(True)> _
Public Class Installer1
Inherits System.Configuration.Install.Installer

 

Public Overrides Sub Install( _
ByVal stateSaver As System.Collections.IDictionary)
MyBase.Install(stateSaver)

 

Dim id As String = Me.Context.Parameters("id")
Dim pswd As String = Me.Context.Parameters("pswd")

 

System.Windows.Forms.MessageBox.Show("ID:" & id & "   PSWD:" & pswd)
End Sub

 

End Class


MSDNライブラリ RunInstallerAttribute クラス
MSDNライブラリ Installer クラス


セットアッププロジェクトを選択し、右クリックメニューより「表示」→「カスタム動作」をクリックします。
カスタム動作エディタが表示されます。


「インストール」を選択し、右クリックメニューより「カスタム動作の追加」をクリックします。
「プロジェクトから項目を選択」ダイアログが起動します。


「プロジェクトから項目を選択」ダイアログの検索対象コンボボックスを「アプリケーションフォルダ」に変更し
「出力の追加」ボタンをクリックします。
「プロジェクト出力グループの追加」ダイアログより「Action1のプライマリ出力」を追加します。


カスタム動作エディタの「インストール」ノードに「Action1のプライマリ出力」が追加されますので
「Action1のプライマリ出力」を右クリックし、プロパティウインドウを表示します。



CustomActionDataプロパティを「/id=[ID] /pswd=[PSWD]」と入力します。
[ID]と/の間に半角スペースがありますので注意してください。

Installerクラスを使ったカスタムアクションにデータを渡すときは、
CustomActionDataプロパティに「/パラメータ名=パラメータ値」という形式で指定します。
複数のデータを渡す場合は、スペース文字で区切ります。
また、Windows Installerのプロパティを使うときは、[]で囲みます。
Installerクラス内でデータを取得するには、InstallContext.Parametersプロパティを使います。

つまり
カスタム動作のCustomActionDataプロパティでは
前回セットアッププロジェクト ユーザーインターフェースで追加した
テキストボックス(A)ダイアログのEdit1Propertyプロパティの値とEdit2Properyプロパティの値を、id、pswdというパラメータ名でInstallerクラスに渡すよう設定します。
Installer1クラスでは、Me.Context.Parameters("id")でパラメータ名がidのパラメータ値を取得しています。




動作確認


セットアッププロジェクトをビルドし、インストールを実行します。
ID、パスワードに適当に値を入力します。


インストール終了後に、ID、パスワードが表示されればOKです。


捕捉


VSのセットアップの機能ではインストール終了後にカスタム動作が発生します。
たとえばID、パスワードを入力し「次へ」ボタンで条件分岐を行いたいなどの要件には対応できません。
ORCAなどを使って追加作業を行うか、VSセットアッププロジェクトではなく、WiXやInstalllShieldなどのインストーラ作成ツールを使用する必要があります。

.NET セットアッププロジェクト ユーザーインターフェース

セットアッププロジェクトでテキストボックス付きダイアログを表示できるようにします。

前回自作のアセンブリのインストールで、[参照の追加]ダイアログに表示するには?
で作成したセットアッププロジェクトを流用します。

セットアッププロジェクトを選択し、右クリックメニューより「表示」→「ユーザーインターフェイス」をクリックします。
ユーザーインターフェイスエディタが起動します。

この画面には[インストール]と、[管理インストール]という2つのノードがありますが
インストールは通常のインストール、管理インストールはセットアップに必要なファイルをファイル・サーバ上に転送しておき、そこからセットアップを可能にする機能です。

「インストール」の「開始」ノードを選択し、右クリックメニューの「ダイアログの追加」をクリックします。
「ダイアログの追加」ダイアログが起動しますので「テキストボックス(A)」を追加します。


追加できるダイアログの種類については下記を参照してください。
MSDNライブラリ Installation User Interface Dialog Boxes

「インストール」の「開始」ノードの最後に「テキストボックス(A)」が追加されます。


「テキストボックス(A)」をドラッグして「ようこそ」の次に移動します。


「テキストボックス(A)」は標準で4つのテキストボックスが表示されます。
今回は2つのテキストボックスを表示しようと思います。
「テキストボックス(A)」のプロパティウインドウより下記項目を設定します。
BannerTextプロパティ・・・「ライセンス登録」
BodyTextプロパティ・・・「IDおよびパスワードを入力してください。」
Edit1Labelプロパティ・・・「ID:」
Edit1Propertyプロパティ・・・「ID」
Edit2Labelプロパティ・・・「パスワード:」
Edit2Propertyプロパティ・・・「PSWD」
Edit3Visibleプロパティ・・・「False」
Edit4Visibleプロパティ・・・「False」


この状態でセットアッププロジェクトをビルドし、インストールを実行すると「ようこそ」画面の次に
以下のような画面が表示されます。


次回のセットアッププロジェクト カスタム動作で「ID」「パスワード」の入力値を取得する方法を説明します。

.NET 自作のアセンブリのインストールで、[参照の追加]ダイアログに表示するには?

自作アセンブリのインストーラで、GAC登録を行い、レジストリを追加することで、ツールボックスの「アイテムの選択」ダイアログや「参照の追加」ダイアログに自作アセンブリを表示することができます。

自作アセンブリに厳密名をつける


例えばMyControlsクラスライブラリにMyTextBox、MyComboBoxを作成したとします。
このMyControlsクラスライブラリに厳密名をつけます。

※厳密名をつけることで以下のようなメリットがあります。
メリット1:参照DLLが改竄されていないことを証明する
メリット2:GACに登録することができるようになる
メリット3:コードアクセスセキュリティで厳密名による設定が可能になる
詳しくはアセンブリ署名とコードアクセスセキュリティを参照してください。

VS2005で厳密名をつける手順は簡単です。
MyControlsクラスライブラリのプロパティページの署名タブを開きます。
アセンブリの署名チェックボックスをチェックONにし、コンボボックスより新規作成を選択します。


厳密な名前のキー作成ダイアログが表示されますので、キーファイル名とパスワードを入力します。


ソリューションエクスプローラに、厳密な名前のキー作成ダイアログで指定したキーファイル名.pfxファイルが追加されます。


セットアッププロジェクトを作成します。


ソリューションにセットアッププロジェクトを追加します。
セットアッププロジェクトのプロパティを必要に応じて変更してください。


続いて「アプリケーションフォルダ」を右クリックし「追加」→「プロジェクト出力」を選択ます。


表示された「プロジェクト出力グループの追加」ダイアログより「プライマリ出力」を選択します。




GAC登録


「対象コンピュータ上のファイルシステム」を右クリックし「特別なフォルダの追加」より「グローバルアセンブリキャッシュフォルダ」を選択します。
依存関係のあるdllをGACに登録する場合、グローバルアセンブリキャッシュに依存関係のあるdllを含め、アプリケーションフォルダにはプライマリ出力だけになるようにします。
手順はグローバルアセンブリキャッシュにプライマリ出力を行った後、アプリケーションフォルダにプロジェクト出力を行います。



「グローバルアセンブリキャッシュフォルダ」を右クリックし「追加」→「プロジェクト出力」を選択ます。


表示された「プロジェクト出力グループの追加」ダイアログより「プライマリ出力」を選択します。


レジストリの追加


まず自PCのレジストリを確認します。
「スタート」→「ファイル名を指定して実行」をクリックし、「regedit」と打ち込んで「OK」をクリックしレジストリエディタを起動してください。
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\AssemblyFoldersを確認してください。
ここに自作コントロールライブラリMyControlsを作成することにより、GACに登録されていれば、ツールボックスのアイテムの選択ダイアログに表示されるようになります。

確認できたらVSの作業に戻ります。
ツールメニューの「表示」→「エディタ」→「レジストリエディタ」をクリックしレジストリエディタを起動します。


HKEY_LOCAL_MACHINEを右クリックし「新しいキー」で下記構成になるようにキーを作成します。
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\AssemblyFolders\[ProductName]


[ProductName]を右クリックし「新規作成」→「文字列の値」を選択します。
Nameプロパティは空値、Valueプロパティは[TARGETDIR]とします。


以上でインストーラの作成は終了です。


動作確認


MyControlsのインストールを行います。

C:\WINDOWS\assemblyフォルダ内にMyControlsがあるかどうか確認します。


レジストリエディタを起動し、HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\AssemblyFoldersにMyControlsが作成され、インストールパスが正しいか確認します。


VSを起動しWindowsアプリケーションを作成します。
ツールボックスを右クリックし「アイテムの選択」をクリックします。
「ツールボックス アイテムの選択」ダイアログにMyTextBoxとMyComboBoxが表示されている事を確認します。