WIX

Windows Installer

• Preparation
• Env設定
• 1ststep
• InstallerUI
• Reference
• Tools

Preparation

• WiXの動作には.NET Framework 1.1または2.0のランタイムが必要
• PlatformSDK をインストールします。(Windows Installer SDKはその一部)
• msi.lib （c:\Program Files\Microsoft SDKs\Windows\v6.0\Lib\Msi.Lib）
• Orca フル・インストール （c:\Program Files\Microsoft SDKs\Windows\v6.0\Bin\Orca.Msi）
• Windows Installer XML（WiX） toolset  Core Tool Set WiX v2 (stable)  wix-2.0.5325.0-binaries.zip (see)

Env設定

• zipの解凍先にリンク

  $ ls -al /usr/local/bin
  total 260
  drwxr-x---+ 2 smnb Users      0 Oct 17 13:49 .
  drwxr-x---+ 5 smnb Users      0 Mar 10  2007 ..
  lrwxrwxrwx  1 smnb None      70 Oct 17 13:49 WIX -> /cygdrive/c/Users/smnb/Downloads/Microsoft/WIX/wix-2.0.5325.0-binaries
  -rwxr-xr-x  1 smnb None  234314 Mar 12  2007 nkf.exe

• .bashrc PATHに登録

  $ which candle
  /usr/local/bin/WIX/candle
  
  smnb@vista WSDK ~/myprog/wix/codezine/0001_first_msi
  $ which light
  /usr/local/bin/WIX/light

1ststep

• .wxs ファイル生成。文字コードそのものは何でも良いが、UTF-8を使う
• makefile 作成
• Windows VersionCheck
• ShortCut in start bar with Icon

Tools

• Ocra
• light

Ocra

• Windows InstallerデータベースGUIエディタ
• 画面GUIはデータベーステーブルの基本参照機能（グリッド形式）
• 主な利用方法
  • msiやmsm（マージモジュール）の検証
  • パッチ（msp）をオリジナルのmsiに一時的に適用してDEBUG

Windows Installer XML（WiX） toolset

• Windows Installerデータベース（msi/msm/pcp）を作成
• ライセンス形式 CPL（Common Public License Version 1.0）
• コードベースによる開発スタイル
• プリプロセッサを搭載
• 分割コンパイル

• Designed for Windows XP
• Windows Vista ロゴ プログラム
• Certified for Windows Vista ロゴ技術要件
• WiXではじめるWindows Installer作成入門 第6回
• WiXのマニュアル
• Windows Installer MSDN
• とっちゃん's Blog
• とっちゃんのBlog(旧館)

makefile

TARGET=readme_txt
RESOURCE_DIR=resource
TARGET_DIR=/cygdrive/c/Program\ Files/smnb

.PHONY: all test mmm clean uninstall install
.SUFFIXES: .msi .wixobj .wxs

all:$(TARGET).msi

$(TARGET).msi: $(TARGET).wixobj $(RESOURCE_DIR)/*
$(TARGET).wixobj: $(TARGET).wxs 

.wixobj.msi:
	light $<

.wxs.wixobj:
	candle $<
	@echo 
	
test:
	cygstart ./$(TARGET).msi
	ls -al $(TARGET_DIR)/ReadMe

install: test

uninstall:
	control appwiz.cpl

clean:
	@-rm $(TARGET).msi 1>/dev/null 2>&1
	@-rm $(TARGET).wixobj 1>/dev/null 2>&1
	@-rm *~ 1>/dev/null 2>&1

mmm:
	cat makefile
	cat $(TARGET).wxs
	pwd
	make clean
	ls -al resource

ProductCode Property

• The ProductCode property is a unique identifier for the particular product release, represented as a string GUID.
• example "{12345678-1234-1234-1234-123456789012}".
• Letters used in this GUID must be uppercase.
• This ID must vary for different versions and languages.
• A product upgrade that updates a product into an entirely new product must also change the product code.
• The 32-bit and 64-bit versions of an application's package must be assigned different product codes.
• The ProductCode is advertised as a product property, and is the primary method of specifying the product.
• This property is REQUIRED.

GUIDを生成するツールとして、Microsoft Windows SDKに付属するGuidGenなどがある。

Microsoft,GuidGenのダウンロードサイト

cat makefile
.PHONY: test clean mmm
TARGET=guid_gen 
test:
	cscript $(TARGET).js

clean:
	-rm*~ 1>/dev/null 2>&1

mmm:
	cat makefile
	cat $(TARGET).js

	
cat guid_gen.js
// Generate GUID
//var TypeLib = CreateObject("Scriptlet.TypeLib");
var TypeLib = new ActiveXObject("Scriptlet.Typelib");
WScript.Echo(TypeLib.Guid);


{B693E257-C4FB-4FED-831C-85A2E1473642}

readme.txt sample

<?xml version="1.0" encoding="UTF-8"?>
<!-- readme_txt.wxs -->
<Wix xmlns="http://schemas.microsoft.com/wix/2003/01/wi">
  <Product 
        Id="12345678-1234-1234-1234-123456789012" Name="ReadMe_txt"
           Version="1.00.0000" Manufacturer="smnb"
           Language="1041" Codepage="932">
  <Package Id="????????-????-????-????-????????????"
           Description="SampleReadMe_txt"
           Comments="Database for ReadMe_txt" InstallerVersion="200"
           Platforms="Intel" Manufacturer="smnb"
           Keywords="Installer,MSI,Database" Languages="1041"
           SummaryCodepage="932"/>
		<Media Id="1" Cabinet="Product.cab" EmbedCab="yes" />

		<Directory Id="TARGETDIR" Name="SourceDir">
		  <Directory Id="ProgramFilesFolder">
			<Directory Id="smnb" Name="smnb">
			  <Directory Id="INSTALLLOCATION" Name="ReadMe">
				<Component Id="Component1"
						   Guid="960E5941-FE2A-4384-A96F-8AED231DB301">
				  <File Id="File1" Name="Readme.txt" KeyPath="yes"
					Compressed="yes" DiskId="1" Source="resource\Readme.txt"/>
				</Component>
			  </Directory>
			</Directory>
		  </Directory>
		</Directory>

		<Feature Id="Feature1" Level="1">
		  <ComponentRef Id="Component1" />
		</Feature>
  </Product>
</Wix>

Wix Schema

Product Attributes

Package attributes

Platforms

Media Element

Directory attributes

Component Element

File Element

Feature Element

ComponentRef Element