目錄
- External Tool Specification Files
- 檔案名
- 位置
- 檔案格式
- 主要標簽
- 描述標簽
- 可執行規范標簽
- 示例
External Tool Specification Files
外部工具規范檔案描述了可以從工具>外部選單運行的工具， 它指定工具的名稱，要運行的可執行檔案，可選引數以及如何處理工具的輸出，
檔案名
<yourtoolname>.xml
位置
用戶指定工具位于Mac和Linux上的$HOME/.config/QtProject/qtcreator/externaltools中，以及Windows上的%APPDATA%\QtProject\qtcreator\externaltools中，
系統級別工具位于Windows和Linux上的<Qt Creator install>/share/qtcreator/externaltools中，以及在Mac上的Qt Creator.app/Contents/Resources/externaltools中，
檔案格式
外部工具規范是具有以下結構的XML檔案，
主要標簽
根標簽是externaltool， 它具有強制屬性id，
| 標簽 | 含義 |
|---|---|
| externaltool | XML檔案中的根元素，指定外部工具 |
| 屬性 | 含義 |
|---|---|
| id | 標識外部工具的字串，兩個工具不能具有相同的ID，要求項 |
描述標簽
您必須為該工具指定描述，顯示名稱和類別， 您可以通過添加包含語言代碼的多個描述，顯示名稱和類別標簽，來將其值轉換為不同的語言，
| 標簽 | 含義 |
|---|---|
| description | 關于工具用途的簡短的單行描述，要求項， |
| displayname | 要顯示在工具選單項中的名稱，要求項， |
| category | 顯示工具所在類別的名稱，這是放置工具的工具>外部選單的子選單的名稱，例如，指定值text以顯示在工具>外部>text選單中，要求項， |
| 屬性 | 含義 |
|---|---|
| xml:lang | 用于描述，顯示名稱或類別的語言的語言代碼（例如"en"或"de"），可選項， |
可執行規范標簽
您必須在根標簽下添加一個可執行標簽，該標簽指定要運行的可執行檔案，可選引數，以及如何處理輸出，
| 標簽 | 含義 |
|---|---|
| executable | 包含多個子標簽，用于指定運行的程式和使用的引數，要求項， |
| 屬性 | 含義 |
|---|---|
| output | 指定如何處理工具的標準輸出流，默認為ShowInPane，可選項， |
| error | 指定如何處理工具的標準錯誤流，默認為ShowInPane，可選項， |
| modifiesdocument | 指定Qt Creator是否應期望對當前檔案進行更改，如果設定了此標志，則Qt Creator會提示用戶在運行該工具之前，將更改保存到當前檔案中，并在該工具完成后無提示地重新加載當前檔案， 可能的值為："yes"或"no"（默認為"no"），可選項， |
executable標簽允許以下子標簽， 您必須至少指定一個path子標簽， 所有子標簽都可以包含特殊的Qt Creator變數，
| 子標簽 | 含義 |
|---|---|
| path | 要運行的可執行檔案的檔案路徑，包括檔案名， 如果您指定可執行檔案名不帶路徑，則Qt creator將在檢查系統PATH環境變數用作可執行檔案的路徑， 您可以多次指定路徑，Qt Creator嘗試以給定的順序決議參考，并運行它找到的第一個可執行檔案，要求項， |
| arguments | 可執行檔案的命令列引數，以工具所在系統平臺命令列相同的格式指定字串（例如，有關引號和引數拆分），可選項， |
| workingdirectory | 可執行檔案作業目錄，可選項， |
| input | 潛在多行字串，通過標準輸入流傳遞給工具， |
示例
<?xml version="1.0" encoding="UTF-8"?>
<externaltool id="sort">
<description>Sorts the selected text</description>
<description xml:lang="de">Sortiert den ausgewaehlten Text</description>
<displayname>Sort Selection</displayname>
<displayname xml:lang="de">Auswahl Sortieren</displayname>
<category>Text</category>
<category xml:lang="de">Text</category>
<executable output="replaceselection" error="ignore">
<path>sort</path>
<input>%{CurrentDocument:Selection}</input>
<workingdirectory>%{CurrentDocument:Path}</workingdirectory>
</executable>
</externaltool>
原創造福大家，共享改變世界
獻出一片愛心，溫暖作者心靈
轉載請註明出處，本文鏈接：https://www.uj5u.com/qita/17798.html
標籤：其他