[+/-] : WIX Localization

首先, 介紹 WIX Localization Project : http://www.tramontana.co.hu/wix/loc/index.php

從這裡你也許可以找到你要的語系檔案.

然後, 在 Wix 的專案的 Property 當中, 選 Linker , Cultures, 填入你想要的語系 (如 : zh-tw)

最後, 在專案當中加入你的語系檔案 (以 zh-tw 為例, 就是 WixUI_zh-tw.wxl)

這樣最後的檔案就是繁體中文的安裝程式囉!

...
Read more.

[+/-] : WIX and Votive UI Dialog

初步介紹 WIX 之後, 可是該安裝只有最基本的 --- 安裝中...
太陽春了, 要如何產生基本的安裝對話窗呢?

首先, 參考 : http://wix.sourceforge.net/manual-wix2/WixUI_dialog_library.htm

因為我們用 VS2008 + Voltive, 先把 UI Extension DLL 參考進來吧.

透過 References 按右鍵, 我們可以加入 WIX 的參考 DLL.

之後, 可以在  WIX 安裝目錄的 bin當中 (一般是  C:\Program Files\Windows Installer XML V3\bin) 找到一些可以參考的 DLL.

 

 

因為要使用 UI, 所以當然是選 WixUIExtension.dll 囉!

Okay, 然後, 在 wxs 檔案中的 Product 內加入 <UIRef Id="WixUI_Minimal" />,如下:

<Product ....>
...
<UIRef Id="WixUI_Minimal" />
...
</Product>

這樣就有最基本的對話窗囉!

除了 WixUI_Minimal (最基本), 當然還有

WixUI_Mondo : 幾乎所有的對話窗都有了.

WixUI_FeatureTree : 從 WixUI_Mondo 變化而來, 只缺少了 SetupTypeDialog (安裝類型 Dialog)

WixUI_InstallDir: 不讓使用者選擇  SetupType and Features, 但是讓使用者選擇安裝目錄.

 

那...如果上面的還不夠, 就只能自訂 Dialog 囉, 自訂 Dialog 從無到有是很麻煩的一件事, 所以最簡單的方法是, 從上面四個基本的 Dialog UI 模組 copy 下來,

然後自己更改, 這樣最快了!

比方說, <UIRef Id="WixUI_Mondo" /> , 可以去找 WixUI_Mondo.wxs 的原始碼, 改掉 UI 的 ID , 就變成下面的 code:

1:      <UI Id="MyWixUI">
2:   <TextStyle Id="WixUI_Font_Normal" FaceName="Tahoma" Size="8" />
3:   <TextStyle Id="WixUI_Font_Bigger" FaceName="Tahoma" Size="12" />
4:   <TextStyle Id="WixUI_Font_Title" FaceName="Tahoma" Size="9" Bold="yes" />

5:   <Property Id="DefaultUIFont" Value="WixUI_Font_Normal" />
6:   <Property Id="WixUI_Mode" Value="Mondo" />

7:   <DialogRef Id="ErrorDlg" />
8:   <DialogRef Id="FatalError" />
9:   <DialogRef Id="FilesInUse" />
10:   <DialogRef Id="MsiRMFilesInUse" />
11:   <DialogRef Id="PrepareDlg" />
12:   <DialogRef Id="ProgressDlg" />
13:   <DialogRef Id="ResumeDlg" />
14:   <DialogRef Id="UserExit" />

15:   <Publish Dialog="ExitDialog" Control="Finish" Event="EndDialog" Value="Return" Order="999">1</Publish>

16:   <Publish Dialog="WelcomeDlg" Control="Next" Event="NewDialog" Value="LicenseAgreementDlg">1</Publish>

17:   <Publish Dialog="LicenseAgreementDlg" Control="Back" Event="NewDialog" Value="WelcomeDlg">1</Publish>
18:   <Publish Dialog="LicenseAgreementDlg" Control="Next" Event="NewDialog" Value="SetupTypeDlg" Order="2">LicenseAccepted = "1"</Publish>

19:   <Publish Dialog="SetupTypeDlg" Control="Back" Event="NewDialog" Value="LicenseAgreementDlg">1</Publish>
20:   <Publish Dialog="SetupTypeDlg" Control="TypicalButton" Event="NewDialog" Value="VerifyReadyDlg">1</Publish>
21:   <Publish Dialog="SetupTypeDlg" Control="CustomButton" Event="NewDialog" Value="CustomizeDlg">1</Publish>
22:   <Publish Dialog="SetupTypeDlg" Control="CompleteButton" Event="NewDialog" Value="VerifyReadyDlg">1</Publish>

23:   <Publish Dialog="CustomizeDlg" Control="Back" Event="NewDialog" Value="MaintenanceTypeDlg" Order="1">WixUI_InstallMode = "Change"</Publish>
24:   <Publish Dialog="CustomizeDlg" Control="Back" Event="NewDialog" Value="SetupTypeDlg" Order="2">WixUI_InstallMode = "InstallCustom"</Publish>
25:   <Publish Dialog="CustomizeDlg" Control="Next" Event="NewDialog" Value="VerifyReadyDlg">1</Publish>

26:   <Publish Dialog="VerifyReadyDlg" Control="Back" Event="NewDialog" Value="CustomizeDlg" Order="1">WixUI_InstallMode = "InstallCustom"</Publish>
27:   <Publish Dialog="VerifyReadyDlg" Control="Back" Event="NewDialog" Value="SetupTypeDlg" Order="2">WixUI_InstallMode = "InstallTypical" OR WixUI_InstallMode = "InstallComplete"</Publish>
28:   <Publish Dialog="VerifyReadyDlg" Control="Back" Event="NewDialog" Value="CustomizeDlg" Order="3">WixUI_InstallMode = "Change"</Publish>
29:   <Publish Dialog="VerifyReadyDlg" Control="Back" Event="NewDialog" Value="MaintenanceTypeDlg" Order="4">WixUI_InstallMode = "Repair" OR WixUI_InstallMode = "Remove"</Publish>

30:   <Publish Dialog="MaintenanceWelcomeDlg" Control="Next" Event="NewDialog" Value="MaintenanceTypeDlg">1</Publish>

31:   <Publish Dialog="MaintenanceTypeDlg" Control="ChangeButton" Event="NewDialog" Value="CustomizeDlg">1</Publish>
32:   <Publish Dialog="MaintenanceTypeDlg" Control="RepairButton" Event="NewDialog" Value="VerifyReadyDlg">1</Publish>
33:   <Publish Dialog="MaintenanceTypeDlg" Control="RemoveButton" Event="NewDialog" Value="VerifyReadyDlg">1</Publish>
34:   <Publish Dialog="MaintenanceTypeDlg" Control="Back" Event="NewDialog" Value="MaintenanceWelcomeDlg">1</Publish>
35:   </UI>

36:   <UIRef Id="WixUI_Common" />
 

 

就從這個開始修改起, 會快速不少.

...
Read more.

[+/-] : WIX and Votive 初步介紹

WIX (Windows Installer XML), 是 Rob Mensching (Windows Team 的  SDE) 寫的安裝工具, 用這個工具, 可以產生出 msi 安裝程式.
這個工具也被微軟內部的 Team 用來包裝  Office, MSN 等等.

以下我用 Visual Studio 2008 簡介如何初步上手.

一旦安裝了 VS2008 以及  WIX 3.0 (beta), Votive, 在 VS2008 新增專案中, 應該可以看到 WIX 的專案.

有 WIX Project - 產生 msi 安裝程式, WIX Merge Module Project - 產生 MSM , 是安裝程式用的模組包裝, WIX Library Project (這是給 WIX 用的)

新增了  WIX Project, 畫面上就會出現主要 WIX XML code (.wxs)

 
1:  <?xml version="1.0" encoding="UTF-8"?>
2:  <Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
3:  <Product Id="c53ce83b-aafe-46e9-904b-63c3c729dba8" Name="PUT-PRODUCT-NAME-HERE" Language="1033" Version="1.0.0.0" Manufacturer="PUT-COMPANY-NAME-HERE" UpgradeCode="2c194b8b-ec7e-4d39-90da-2a3ec66f967b">
4:  <Package InstallerVersion="200" Compressed="yes" />
5:  <Media Id="1" Cabinet="WixProject1.cab" EmbedCab="yes" />
6:  <Directory Id="TARGETDIR" Name="SourceDir">
7:  <Directory Id="ProgramFilesFolder">
8:  <Directory Id="INSTALLLOCATION" Name="PUT-APPLICATION-DIRECTORY-HERE">
9:  <Component Id="ProductComponent" Guid="2f8969d7-4d29-4ab0-b763-f4b96a57ac8f">
10:  <!-- TODO: Insert your files, registry keys, and other resources here.-->
11:  </Component>
12:  </Directory>
13:  </Directory>
14:  </Directory>
15:  <Feature Id="ProductFeature" Title="PUT-FEATURE-TITLE-HERE" Level="1">
16:  <ComponentRef Id="ProductComponent" />
17:  </Feature>
18:  </Product>
19:  </Wix>

這是最基本的 WIX code, 首先當然是把該填的資訊填好 , WIX 已經提到的有 : PUT-PRODUCT-NAME-HERE, PUT-COMPANY-NAME-HERE, PUT-APPLICATION-DIRECTORY-HERE, PUT-FEATURE-TITLE-HERE, 就分別填上產品名稱, 公司名稱, 安裝目錄名稱, 安裝的功能名稱.
不過, 這樣還不夠, WIX 要求 Component 一定要列在 CreateFolders 當中.
所以, 在 Component 當中放入 <Create Folder/> 就可以達到基本要求囉.

1:  <Component Id="ProductComponent" Guid="2f8969d7-4d29-4ab0-b763-f4b96a57ac8f">
2:   <CreateFolder/>

3:  </Component>
 

一直到現在還只是空的安裝程式, 雖然可以執行, 但是甚麼也沒有安裝.
要安裝檔案, 只要在 Component 當中填入 File 就可以囉, 如下:

1:  <Component Id="ProductComponent" Guid="2f8969d7-4d29-4ab0-b763-f4b96a57ac8f">
2:   <CreateFolder/>
3:   <File Id="WixProject1.wxs" Source="WixProject1.wxs" />
4:  </Component>

 

這樣這個安裝程式就會在 C:\Program Files\[PUT-APPLICATION-DIRECTORY-HERE] 下面放入一個 WixProject1.wxs 檔案囉.

...
Read more.