將元件從儲存庫工作區載入本端工作區。
用途
scm load 次指令會將儲存庫工作區中的元件載入本端工作區中。
如果本端工作區不存在,會加以建立。
用法概要
- 如果要在利用 scm login 來建立儲存認證之後執行 scm load,請執行下列動作:
scm load workspace [ -r | --repository-uri ] 儲存庫 URI 或暱稱
[ -d | --dir ] workspace-path { [ -q | --quiet ] [ -f | --force ] }
- 如果要在指令行提供認證來執行 scm load,請執行下列動作:
scm load workspace [ -r | --repository-uri ] 儲存庫 URI [ -u | --username ] 儲存庫中的使用者 ID [ -P | --password ] password for user ID in repository [ -d | --dir ] workspace-path { [ -q | --quiet ] [ -f | --force ] }
選項和引數
- workspace
- 要載入的儲存庫工作區的名稱、別名或 UUID。
- remote-path
- 要載入的遠端項目清單,可以是元件(名稱、別名或 UUID)或元件中的遠端路徑。
- [ --all ]
- 選取所有元件。萬一發生衝突,則會優先採用明確選取的元件。
- [ -a | --alternative-name ] arg
- remote-path 中指定之項目的替代名稱。
- [ -d | --dir ] workspace-path
- 指定的 workspace 中的檔案和資料夾會載入這個路徑名稱中。
如果路徑名稱不存在,會加以建立。
如果省略這個選項,scm load 會建立新的本端資料夾作為現行工作目錄的子目錄。
新的資料夾會採用指定 workspace 的名稱。
- [ -f | --force ]
- 載入時改寫現有的檔案。
- [ -i
| --include-root ]
- 載入元件根目錄,以作為檔案系統中的目錄。
- [ -L | --local-rules ] Load
rule path
- Load rule path 指定本端工作區中元件之載入規則檔的路徑名稱。
當指定多個 component 時無效。
- [ -P | --password ] password for user ID in repository
- 指名儲存庫中指定使用者 ID 的密碼。
如果指令行不含這個選項,系統會提示您輸入密碼。
如果您指定了已利用 scm login 指令來儲存認證的儲存庫 URI 或暱稱,便會忽略這個選項。
- [ -q | --quiet ]
- 在運作之時,抑制大部分參考訊息。
- [ -R | --remote-rules ] Load
rule path
- Load rule path 指定儲存庫工作區中元件之載入規則檔的路徑名稱。
當指定多個 component 時無效。
- [ -r | --repository-uri ] 儲存庫 URI
- 指定要採取這個動作的儲存庫。
如果您已利用 scm login 指令來儲存儲存庫認證,您可以將提供的暱稱用於這些儲存認證。
- [ -t
| --target ] arg
- 應載入其中變更的選用本端路徑。
- [ -u | --username ] 儲存庫中的使用者 ID
- 指定存在於指名儲存庫中的使用者 ID。
如果您指定了已利用 scm login 指令來儲存認證的儲存庫 URI 或暱稱,便會忽略這個選項。
- component...
- 要載入之元件的清單,以空格來區隔。
請用名稱、別名或 UUID 來指定元件。
如果省略這個選項,便會載入指定工作區中的所有元件。
範例
利用暱稱為 jazzhost 之儲存庫的儲存認證,將名稱為 HelloJazz 之儲存庫工作區的完整內容載入
C:\local-workspaces 的新子目錄中:
C:\local-workspaces> scm load -r jazzhost HelloJazz
Downloading /com.example.hellojazz.rcp.ui/.project (689 B)
Downloading /com.example.hellojazz.rcp.ui/build.properties (109 B)
Downloading /com.example.hellojazz.service/plugin.xml (529 B)
Downloading /com.example.hellojazz.service/.project (690 B)
Downloading /com.example.hellojazz.service/build.properties (109 B)
Downloading /com.example.hellojazz.client.tests/TestHelloJazz.launch (2.6 KB)
Downloading /com.example.hellojazz.rcp.ui/.classpath (307 B)
Downloading /com.example.hellojazz.rcp.ui/HelloJazzClient.launch (1.7 KB)