The FIDL compiler

Usage: fidlc [--json JSON_PATH]
             [--available PLATFORM:VERSION[,VERSION]...]
             [--versioned PLATFORM[:VERSION]]
             [--name LIBRARY_NAME]
             [--experimental FLAG_NAME]
             [--werror]
             [--format=[text|json]]
             [--json-schema]
             [--depfile DEPFILE_PATH]
             [--files [FIDL_FILE...]...]
             [--help]

All of the arguments can also be provided via a response file, denoted as
`@responsefile`. The contents of the file at `responsefile` will be interpreted
as a whitespace-delimited list of arguments. Response files cannot be nested.

See <https://fuchsia.dev/fuchsia-src/development/languages/fidl/reference/compiler>
for more information.


選項:

  • --json JSON_PATH。如果有這個標記,此標記會指示 fidlc 輸出 程式庫的中繼表示法。中階 表示法為 JSON,且符合透過 --json-schema 提供的結構定義 中繼表示法會做為各種後端的輸入內容。

  • --available PLATFORM:VERSION\[,VERSION]...。如果有這個標記,這個標記會指示 fidlc 在任何指定 VERSION 中,加入 PLATFORM 下註解 @available 的元素。 PLATFORM 對應到資料庫的 @available(platform="PLATFORM") 屬性。 如果省略 platform 引數,則會改為程式庫名稱的第一個元件。 例如:--available example:1,3 會選取平台「範例」的版本 1 和 3。

  • --versioned PLATFORM\[:VERSION]。如果有這個標記,此標記會指示 fidlc 將 驗證要編譯的主要程式庫是否已建立在 PLATFORM 下的版本。 如果提供 VERSION,也會驗證程式庫是否在 VERSION 版本新增。 程式庫的平台決定如下:

    • 如果沒有任何 @available 屬性,平台就會「解鎖」。
    • 您可以使用 @available(platform="PLATFORM") 明確指定平台。
    • 否則,平台是程式庫名稱的第一個元件。
  • --name LIBRARY_NAME。如果有這個旗標,會指示 fidlc 驗證 您編譯的主程式庫具有特定名稱。這個標記很實用 交叉比對建構系統中程式庫的宣告內容,以及 實際內容

  • --experimental FLAG_NAME。如果有這個旗標,系統會啟用實驗功能 就是 fidlc 的主要效果

  • --depfile DEPFILE_PATHfidlc 產生的 depfile 路徑。這個 Dpfile 取得正確的漸進式編譯規則這個檔案由 fidlc 填入 例如 Line1: out1: in1 in2 in3、Line2: out2: in1 in2 in3 ... 但是 [1-2] 全都是 而 fidlc 和 in[1-3] 產生的輸出內容都是讀取的檔案。輸入檔案 會傳遞 --files 傳遞的內容輸出檔案是由 fidlc 產生的檔案。

  • --files \[FIDL_FILE...]...。每個 --files \[FIDL_FILE...] 引數區塊 描述了程式庫,而且所有內容都必須共用相同的頂層程式庫名稱 宣告內容程式庫必須按照依附元件順序呈現,以便稍後提供 程式庫可以使用上述程式庫中的宣告,反之亦然。 系統只會針對最終程式庫產生輸出內容,不會針對其每個依附元件產生輸出內容。

  • --json-schema。如果有這個標記,此標記會指示 fidlc 輸出 中繼表示法的 JSON 結構定義。

  • --format=\[text|json]。如果有這個標記,這個標記就會設定 fidlc 的輸出模式。 這會指定在編譯失敗時,是否要輸出錯誤和警告, 純文字 (預設值) 或 JSON

  • --werror。將警告視為錯誤。

  • --help。顯示說明並立即結束。