版本核心

指令列選項

核心指令列選項可以間接 (做為平台實作詳細資料) 或直接由開發人員新增至產品組件,用於本機偵錯和測試。

在主機板或產品檔案中指定選項

產品和主機板只能透過產品組件,間接新增核心指令列選項:

在本機指定選項

在本機開發時,可以將應附加至核心指令列的字串清單指定為組件開發人員覆寫的一部分。

這需要兩個步驟:

1. 定義組件覆寫目標

在 //local/* 下方的 //local/BUILD.gn 或其他 BUILD.gn 檔案中,定義組件覆寫目標。

import("//build/assembly/developer_overrides.gni")

assembly_developer_overrides("custom_kernel_args") {
  kernel = {
    command_line_args = [ "foo" ]
  }
}

每組覆寫設定只需執行一次,之後即可在建構作業中,與任何產品組合或 outdir 重複使用。

接下來,請告訴 GN 產品要使用哪個開發人員覆寫目標。

2a. 將該目標與「主要」產品組合搭配使用

對於「主要」產品組件 (fx set 指令中指定的組件),請使用下列指令,指示 GN 使用上述定義的產品組件目標:

fx set ... --assembly-override //local:custom_kernel_args

或者,您也可以執行 fx args,並按照下列方式新增或修改一行,藉此修改現有的 args.gn 檔案:

product_assembly_overrides_label = "//local:custom_kernel_args"

2b. 「主要」組件以外的產品組件

對於「主要」產品組件以外的組件 (例如 zedboot 或復原組件),則需要稍微詳細的機制。方法是使用以萬用字元為基礎的模式比對:

fx set ... --assembly-override '//products/zedboot/*=//local:custom_kernel_args'

或

fx set ... --assembly-override '//products/microfuchsia/*=//local:custom_kernel_args'

處理多個產品組合時,直接在 args.gn 中指定會比較容易:

product_assembly_overrides = [
  {
    # For assemblies in Bazel, use their product label
    assembly = "//products/core/*"
    overrides = "//local:custom_kernel_args"
  },
  {
    assembly = "//products/zedboot/*"
    overrides = "//local:zedboot_overrides"
  },
  {
    assembly = "//products/microfuchsia/*"
    overrides = "//local:zedboot_overrides"
  }
]

請注意,使用 //vendor/* 板時,產品組件目標也會位於 //vendor 存放區 (例如 //vendor/<foo>/products/minimal)。