您可以使用 .scan 指令來新增其他資訊至 BOM。當 .scan 指令執行時,系統會將檔案狀態的相關資訊儲存在步驟的工作目錄中。本節顯示其用法範例。另請參閱 .scan中的參照資訊。
該指令有二種形式。
- .scan baseline
- 將所有檔案的清單儲存在步驟的工作目錄樹狀結構中,並儲存各檔案的 MD5 值。系統會針對工作,在 BOM 中顯示清單。您可能會想在執行某些設定步驟以及移出適當的一組檔案之後,發出這個指令。一個專案可以有多個 baseline 指令,但是當 .baseline 指令執行時,每個 baseline 指令都會將清單重設為步驟的工作目錄狀態。
- .scan checkpoint
- 儲存自前次在專案中執行 .scan baseline 或 .scan checkpoint 之後,所有新建、變更及刪除的檔案清單,包含各檔案的 MD5 值。若是使用 .scan baseline 指令,系統會在 BOM 中顯示清單。您必須先發出 .scan baseline 指令,才能發出專案中的第一個 .scan checkpoint 指令。在 .scan baseline
指令之前的 .scan checkpoint 指令會被忽略。
下列範例顯示 .scan baseline 及 checkpoint 指令如何共同運作:
| 號碼
|
步驟
|
步驟之後的檔案
|
BOM 資料
|
1
|
移出起始檔案
|
config.c
execute.c
|
|
2
|
.scan baseline
|
config.c
execute.c
|
基礎線:
config.c
execute.c
|
3
|
新增資料檔
|
config.c
execute.c
data.txt
|
|
4
|
.scan checkpoint
|
config.c
execute.c
data.txt
|
核對點 1:
新增的 data.txt
|
5
|
新增其他資料檔
|
config.c
execute.c
data.txt
data2.txt
data3.txt
|
|
6
|
刪除 data.txt
|
config.c
execute.c
data2.txt
data3.txt
|
|
7
|
.scan checkpoint
|
config.c
execute.c
data2.txt
data3.txt
|
核對點 2:
新增的 data2.txt、data3.txt
刪除的 data.txt
|