[Plugin] 如何寫一個最簡單的 INF 檔

如果你寫的是 ActiveX 元件, 而且希望將一堆相關的 dll 複製到使用者電腦的 c:\windows\system32\自訂的目錄, 你就要會寫 INF.

INF 檔全名是 information file , 裡面放著如何安裝你的軟体在使用者電腦的指令. 基本上, IE 3.0 以後的瀏覽器都是用 Internet Component Download 這個 service 自動安裝你的 ActiveX 軟体, 而這個 service 吃的就是 INF 檔.

詳細說明: http://msdn.microsoft.com/en-us/library/aa741213(VS.85).aspx

本文大綱

1. 最簡單 INF 檔寫作範例
2. 最簡單建立 CAB 檔範例

開始

C & C++ 的程式設計師都知道每一個程式都有一個進入點, 也就是第一個執行的函式. 那麼 INF 檔的 main 是哪一個呢?

是這樣的.

如果你的 INF 檔沒有 [Add.Code] and [Setup Hooks] 那就會找 [DefaultInstall] section 開始執行

我們今天用 [DefaultInstall] 的方法, 主要原因是 standard Microsoft Win32 INF file 提供更有彈性的功能. 所以下面的 inf 檔裡面沒有 [Add.Code] 與 [Setup Hooks] sections.

現在開始動手吧.
我希望當使用者安裝我的 ActiveX 元件時, 做下面工作 ...

1. 把 a.dll, b.dll, c.ocx 複製到 c:\windows\system32\jing 目錄中
2. 把 JingPlugin1.dll 與 JingPlugin2.dll 複製到 c:\windows\system32\jing\plugins
3. 若使用者沒有這兩個目錄, 系統必須要自己建立
4. b.dll 與 c.ocx 必須註冊, 而且 b.dll 必須先註冊然後才是 c.ocx

最簡單 INF 檔寫作範例

; ---------------------------- d.inf ------------------------
; 這個 inf 檔必須要放在 cab 檔裡面一起散佈出去

[version]
signature=$Chicago$
AdvancedINF=1.0

; Step 1: (這是註解) INF file 的第一個執行指令
; CopyFiles = 要複製的檔案列表 sections
; RegisterOCXs = 要註冊的檔案列表 (你的元件可能有一堆 dll 或 ocx 要註冊)
[DefaultInstall]
CopyFiles= MyFiles, MyInf, PluginFileList
RegisterOCXs=RegisterOCXSection

; Step 2: 指定這些檔案要複製的目的地
; INF 中的號碼意義: see http://www.osronline.com/ddkx/install/create-inf_3aav.htm
[DestinationDirs]
; 在 MyFiles的檔案, 全部裝到 c:\Windows\system32\jing
; 目錄裡面 (11 對應到 system32)
MyFiles=11,jing ; 你看的沒錯, 就是 11,jing

; 在 MyInf 描述的檔案, 全部裝到 c:\Windows\Inf 裡面
MyInf=17

; 把 PluginFileList 描述的檔案, 全部倒進
; c:\Windows\system32\jing\plugins 裡面
PluginFileList=11,jing\plugins ; 同樣的 11,jing\plugins

; 如果要把一堆檔案放到任意位置, 則使用 -1即可

; 例如: 下面的指令會把 PluginFileList 的一堆檔案放到 c:\jing\plugins 裡面

; PluginFileList=-1,c:\jing\plugins

; Step 3: 定義 MyFiles 中包含哪些檔案
[MyFiles]
a.dll=a.dll ; a.dll 檔案的詳細資料, 參考 a.dll 描述
b.dll=b.dll ; b.dll 檔案的詳細資料, 參考 b.dll 描述
c.ocx=c.ocx ; c.ocx 檔案的詳細資料, 參考 c.ocx 描述

[a.dll] ; a.dll 描述
file=thiscab ; 這個檔案從目前的 cab 檔解析出來
FileVersion=0,0,0,0
;DestDir=11 ; 這個檔案要複製到 C:\Windows\system32 但適用於 [Add.Code ] 的方式, 目前使用 standard Microsoft Win32 INF file 的方式進行描述, 所以 DestDir 指令無效.

[b.dll] ; b.dll 描述
file=thiscab ; 這個檔案從目前的 cab 檔解析出來
FileVersion=0,0,0,0
RegisterServer=yes

[c.ocx] ; c.ocx 描述
file=thiscab ; 這個檔案從目前的 cab 檔解析出來
FileVersion=0,0,0,0
RegisterServer=yes

; Step 4: 定義 MyInf 中包含哪些檔案
[MyInf]
d.inf=d.inf ; d.inf 檔案的詳細資料, 參考 d.inf描述

[d.inf] ;d.inf 檔案的詳細描述
file-win32-x86=thiscab
FileVersion=1,0,0,0

; Step 5: 定義 PluginFileList 中包含哪些檔案
[PluginFileList]
JingPlugin1.dll=JingPlugin1.dll ; 詳細資料, 參考 JingPlugin1.dll描述
JingPlugin2.dll=JingPlugin2.dll ; 詳細資料, 參考 JingPlugin2.dll描述
[JingPlugin1.dll]
file=thiscab ; 這個檔案從目前的 cab 檔解析出來
FileVersion=0,0,0,0
[JingPlugin2.dll]
file=thiscab ; 這個檔案從目前的 cab 檔解析出來
FileVersion=0,0,0,0

; Step 6: 要註冊的全部放在這裡
[RegisterOCXSection]
"%11%\jing\b.dll" ; 自動註冊放在 system32\jing 裡面的 b.dll
"%11%\jing\c.ocx" ; 自動註冊放在 system32\jing 裡面的 c.ocx

; ---------------------------- end of d.inf ------------------------

最簡單建立 CAB 檔範例: 製作 cab 檔, 把你的 ActiveX 元件散佈出去

Step 1: 假設你的元件檔案結構如下:

a.dll
b.dll
c.ocx
d.inf
plugins
|______ JingPlugin1.dll
|______ JingPlugin2.dll

Step 2: 下達壓縮指令
"C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\Bin\cabarc.exe" -r -s 6144 n my.cab c.ocx d.inf a.dll b.dll plugins\*.dll
Note:

1. 你不能用 -p 的方式建立 cab, 否則當安裝時, 會找不到子目錄裡面的檔案
2. 6144 是留給將來數位簽章使用的空間

Step 3: 完成產生 my.cab

Enjoy. 希望對你有幫助.

by Jing

延伸閱讀

[1] Using INF Files
[2] 一堆 INF 檔可用的指令

[3] Jing, "如何產生 certification 文件, 用來 sign 你的軟體?," 2009/5
http://mqjing.blogspot.com/2009/05/certification-sign.html

[4] Jing, "如何為你的 ActiveX 元件 (cab 檔) 加入數位簽章 -- signtool?," 2009/3
http://mqjing.blogspot.com/2009/03/plugin-activex-cab-signtool.html

[5] Jing, "ActiveX 元件版本問題," 2009/3
http://mqjing.blogspot.com/2009/03/plugin-activex.html

[6] Jing, "INF 檔裡面可不可以使用變數?," 2009/3
http://mqjing.blogspot.com/2009/03/plugin-inf.html