How To: ウェブページへの ショートカットを 作成する

WiX は、インストール プロセスの一部として インターネット サイトへのショートカット作成の サポートを提供しています。この how to は、必須のユーティリティー ライブラリーを参照する事と インストーラーにインターネット ショートカットを追加する事を デモンストレーションしています。 あなたが既に How To: スタートメニューに ショートカットを 作成する でのステップに 従ったものと仮定しています。

Step 1: プロジェクトに WiX Utility extensions ライブラリーを 追加する

WiX のインターネット ショートカットについてのサポートは、WiX extension ライブラリーで インクルードされていて、プロジェクトで 使う前に追加されていなければなりません。もし WiX を コマンドラインで使っているなら、candle と light のコマンドラインに 以下を追加する必要があります： 

-ext WiXUtilExtension

もし WiX を Visual Studio で使っているなら、Add Reference dialog を使って extensions を追加する 事ができます：

  1. Visual Studio で WiX プロジェクトを開く
  2. ソリューション エクスプローラーでプロジェクトを右クリックして、Add Reference... を選ぶ
  3. リストから WixUtilExtension.dll アセンブリを選んで、追加をクリックする
  4. Add Reference dialog を閉じる

Step 2: プロジェクトに WiX Utility extensions 名前空間を 追加する

いったん ライブラリーがプロジェクトに追加されたら、目当ての WiX エレメントにアクセスできるように プロジェクトに Utility extensions 名前空間を 追加する必要があります。これをするには、 プロジェクトで トップレベルの <Wix> エレメントに 以下のアトリビュートを追加する 修正をします： 

xmlns:util="http://schemas.microsoft.com/wix/UtilExtension"

スタンダードな名前空間と 追加された Utility extensions 名前空間を持つ 完全な WiX エレメントは このようになります： 


<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi"
     xmlns:util="http://schemas.microsoft.com/wix/UtilExtension">

Step 3: インストーラー パッケージに インターネット ショートカットを 追加する

インターネット ショートカットは、 <Util:InternetShortcut> エレメントを使って 作成されています。 以下の例は、いま在る How To: スタートメニューに ショートカットを作成する からの ショートカット作成例に InternetShortcut エレメントを追加します。

<DirectoryRef Id="ApplicationProgramsFolder">
    <Component Id="ApplicationShortcut" Guid="PUT-GUID-HERE">
        <Shortcut Id="ApplicationStartMenuShortcut" 
                  Name="My Application Name"
                  Description="My Application Description"
                  Target="[APPLICATIONROOTDIRECTORY]MyApplication.exe"
                  WorkingDirectory="APPLICATIONROOTDIRECTORY"/>
	<util:InternetShortcut Id="OnlineDocumentationShortcut"
			       Name="My Online Documentation"
			       Target="http://www.wixwiki.com/"/>
        <RemoveFolder Id="ApplicationProgramsFolder" On="uninstall"/>
        <RegistryValue Root="HKCU" Key="Software\Microsoft\MyApplicationName" Name="Installed" Type="integer" Value="1" KeyPath="yes"/>
    </Component>
</DirectoryRef>

InternetShortcut は、id アトリビュートと共に ユニーク id が 与えられています。このケースでは、アプリケーションの スタート メニュー フォルダーです。Name アトリビュートは、スタート メニューでのショートカットの名前を 指定しています。Target アトリビュートは、ショートカットの為の 行き先アドレスを 指定しています。
<DirectoryRef> エレメントは、プロジェクト ファイルで既に定義されている ディレクトリー構造を参照する為に 使われています。ApplicationProgramsFolder ディレクトリーを参照する事によって、ショートカットは ユーザーの スタート メニューの "My Application Name" フォルダーの中に インストールされます。