fuchsia.component.decl

新增日期:7

結構化

CapabilityRef

定義於 fuchsia.component.decl/relative_refs.fidl

此元件中宣告的能力參照。

廣闊類型說明預設
name string[100] 無預設

ChildRef

定義於 fuchsia.component.decl/relative_refs.fidl

元件其中一個子項執行個體的參照。

廣闊類型說明預設
name child_name

由父項指派給子項的名稱。如果已設定 collectionname 的範圍會限定為 collection,而子項則是動態例項。

無預設
collection name

name 所屬的集合。如果省略,name 會參照靜態執行個體。如果元件宣告中使用了 ChildRef,則必須省略這個欄位。選用。

無預設

CollectionRef

定義於 fuchsia.component.decl/relative_refs.fidl

元件中其中一個集合的參照。

廣闊類型說明預設
name name 無預設

ConfigType

定義於 fuchsia.component.decl/config.fidl

廣闊類型說明預設
layout ConfigTypeLayout 無預設
parameters vector<LayoutParameter>? 無預設
constraints vector<LayoutConstraint> 無預設

DebugRef

定義於 fuchsia.component.decl/relative_refs.fidl

環境偵錯功能的參考資料。

<EMPTY>

EnvironmentRef

定義於 fuchsia.component.decl/relative_refs.fidl

環境的參照。

已新增:HEAD

<EMPTY>

FrameworkRef

定義於 fuchsia.component.decl/relative_refs.fidl

元件架構本身的參考資料。

<EMPTY>

NameMapping

定義於 fuchsia.component.decl/offer.fidl

用於建立 2 個名稱之間的對應關係。用於重新命名 FIDL 宣告中的服務或元件執行個體。

廣闊類型說明預設
source_name name

來源執行個體中使用的名稱。

無預設
target_name name

目標執行個體所用的名稱。

無預設

ParentRef

定義於 fuchsia.component.decl/relative_refs.fidl

元件父項執行個體的參照。

<EMPTY>

ProgramRef

定義於 fuchsia.component.decl/relative_refs.fidl

元件程式的參照。

已新增:HEAD

<EMPTY>

ResolvedConfig

fuchsia.component.decl/config.fidl 中定義

已由元件管理員完全解析的設定。

新增時間:12 張

廣闊類型說明預設
fields vector<ResolvedConfigField> 無預設
checksum ConfigChecksum 無預設

ResolvedConfigField

fuchsia.component.decl/config.fidl 中定義

新增時間:12 張

廣闊類型說明預設
key string 無預設
value ConfigValue 無預設

SelfRef

定義於 fuchsia.component.decl/relative_refs.fidl

元件本身的參照。

<EMPTY>

VoidRef

定義於 fuchsia.component.decl/relative_refs.fidl

提及刻意缺少優惠來源的內容。

<EMPTY>

ENUMS

AllowedOffers 嚴格

類型:uint32

定義於 fuchsia.component.decl/collection.fidl

可指定集合中兒童為目標的優惠類型。

名稱物超所值說明
1

只有靜態優惠可以指定集合中的元件。「靜態優惠」是指 ComponentDecl 中以集合本身為目標的優惠。

此為預設行為。

2

靜態優惠和動態優惠都能指定集合中的元件。「靜態優惠」是指 ComponentDecl 中針對集合本身指定的優惠。「動態優惠」是在執行階段傳遞至 CreateChild 的額外優惠,

開放使用嚴格

類型:uint32

定義於 fuchsia.component.decl/offer.fidl

說明能力的預期可用性。

某些功能可能不適用於部分系統設定。在這些情況下,系統會在公開/優惠/用途鏈中將供應情形宣告為 OPTIONAL,而如果系統設定無法轉送或提供特定能力 (例如無頭系統上的圖形功能),則會從系統設定中的 void 轉送。

名稱物超所值說明
1

功能必須可用。無法轉送能力會發生錯誤。

2

在用途宣告中:如果元件無法取得該能力,也可以正常運作。

在優惠/公開聲明中:部分系統設定可能無法提供該項能力。做為共同項目,目標元件不得對能力缺少必要的依附元件。

3

如果對應優惠或公開聲明的目標需要能力,則行為相當於必要行為。如果目標對能力有選用依附元件,則行為即為選用功能。這對想要根據內部元件變更轉送可用性的容器元件而言非常實用。

用途宣告中不允許使用這個值。

4

來源可能會完全省略路線,甚至不需要從 void 轉送。

暫時轉換用於導入新功能的軟性轉換。

新增日期:9

ConfigTypeLayout 彈性

類型:uint32

定義於 fuchsia.component.decl/config.fidl

名稱物超所值說明
1
2
3
4
5
6
7
8
9
10
11

DeliveryType 彈性

類型:uint32

定義於 fuchsia.component.decl/types.fidl

DeliveryType 可用於宣告能力,並指定在系統收到這項能力的要求時,指定架構要從供應器元件傳出目錄開啟能力的條件。

已新增:HEAD

名稱物超所值說明
0

一旦部分消費者元件要求這項功能,架構就會立即開啟這項功能。

1

架構會監控消費者元件所發出連線要求伺服器端點上的 ZX_CHANNEL_READABLE 信號,並且只會在伺服器端點可讀取時,從供應商元件的傳出目錄開啟能力。

DependencyType strict

類型:uint32

定義於 fuchsia.component.decl/offer.fidl

說明能力隱含的依附元件類型。

名稱物超所值說明
1

元件可能要求建立強式依附元件。

2

低強度依附元件,可形成循環。使用弱依附元件的元件必須支援在任意時間無法使用的依附元件。

嚴格耐用性

類型:uint32

定義於 fuchsia.component.decl/collection.fidl

在集合中建立的元件執行個體耐用性。

名稱物超所值說明
2

執行個體會一直存在,直到其父項執行個體停止或明確刪除為止。

3

執行個體會在建立時啟動,並在停止時立即刪除。

環境會嚴格

類型:uint32

定義於 fuchsia.component.decl/environment.fidl

指定已宣告環境初始屬性組合的指派方式。

名稱物超所值說明
0

環境沒有任何初始屬性。

1

環境的初始屬性集會繼承其領域。繼承屬性包含 EnvironmentDecl 中定義的任何欄位。

終止嚴格

類型:uint32

定義於 fuchsia.component.decl/child.fidl

說明此元件執行個體意外終止時要採取的動作。

名稱物超所值說明
0

無動作 (預設)

1

如果元件因任何原因終止,請觸發安全系統重新啟動作業。這是受到元件架構安全性政策管制的特殊功能。

StartupMode 嚴格

類型:uint32

定義於 fuchsia.component.decl/child.fidl

說明元件可在哪些條件啟動。

名稱物超所值說明
0

只在收到傳入的能力要求,或直接使用 fuchsia.component.Controller/Start 啟動元件執行個體時,才啟動元件執行個體。

1

在父項啟動時自動啟動元件執行個體,或於動態元件建立時啟動元件執行個體。

StorageId 嚴格

類型:uint32

定義於 fuchsia.component.decl/capability.fidl

宣告要使用哪個 ID 來識別元件的獨立儲存空間目錄。

名稱物超所值說明
1

隔離的儲存空間目錄會使用元件 ID 索引中指定的元件執行個體 ID 作為索引鍵。未列在索引中的元件無法使用或開啟這項儲存空間能力。

2

如果元件 ID 索引中指定隔離的儲存空間目錄,則會使用元件的執行個體 ID 作為索引鍵。否則,系統會使用儲存空間能力與元件的路徑名稱,為獨立的儲存空間目錄建立索引鍵。

資料表

兒童

定義於 fuchsia.component.decl/child.fidl

以靜態方式宣告子項元件執行個體。

序數廣闊類型說明
name child_name

(必要) 由父項指派給子項的名稱。

不得為空白且與其他同層級項目重複,並且只能包含下列字元:[a-z0-9-_.]。

url fuchsia.url/Url

(必要) 子項元件的網址。

網址不得留空,且網址格式正確無誤。

startup StartupMode

(必要) 元件執行個體的啟動模式。

必須設定。

environment name

(選用) 指派給這個子項的環境。

可能會設定,此時子項會沿用父項元件的環境。如有設定,該名稱必須參照 ComponentDecl 中定義的環境,且只能包含下列字元:[a-z0-9-_.]。

on_terminate OnTerminate

(選用,預設為 NONE) 此元件執行個體意外終止時要採取的動作。

config_overrides vector<ConfigOverride>

套用至子基礎設定的覆寫設定。

如要覆寫設定欄位,必須由父項標示為可變動。

父項必須傳遞與子項宣告結構定義類型完全相符的 ConfigOverride 值。

新增時間:12 張

精選

定義於 fuchsia.component.decl/collection.fidl

以靜態方式宣告元件執行個體集合。

序數廣闊類型說明
name name

(必填) 集合的名稱。在集合中建立的執行個體只會將此範圍限定為這個名稱。

durability Durability

(必要) 集合中的執行個體的耐用性。

environment name

(選用) 指派給這個集合中的子項執行個體的環境。

可能會設定,在此情況下,這個集合中的子項會沿用父項元件的環境。如有設定,該名稱必須參照 ComponentDecl 中定義的環境,且只能包含下列字元:[a-z0-9-_.]。

allowed_offers AllowedOffers

(選用,預設為 STATIC_ONLY) 可指定這個集合中子項執行個體的優惠類型。

只有使用 dynamic_offers 受限制功能的元件才能設定此欄位。

allow_long_names bool

(選用,預設為 false) 這個集合中的子項執行個體名稱是否能夠超過預設長度限制 (100)。

只有使用 allow_long_names 受限制功能的元件才能設定此欄位。

persistent_storage bool

(選用) 動態子項執行個體及其子系所使用的獨立儲存空間資料是否會在執行個體刪除後保留。新的動態執行個體會繼承之前的執行個體資料儲存庫。

如果較低層級的集合是可啟用/停用這項設定的集合子集合,就可以覆寫這項設定。

這項設定適用於集合元件及其子系使用的所有儲存空間功能。

如未設定,預設值為從祖系集合沿用的值,否則預設為 false

元件

定義於 fuchsia.component.decl/component.fidl

元件宣告。

這項資訊通常在元件資訊清單 (.cm 檔案) 中編碼,如果包含這項資訊,或可能由元件解析器在執行階段產生,不含這項資訊。

序數廣闊類型說明
program Program

(選用) 執行元件時要執行的程式相關資訊。如為不可執行的元件,則省略這個值。

uses vector<Use>

(選用) 元件使用的功能清單。這些功能包括提供給元件的功能,而且該元件會安裝在傳入的命名空間中。

已使用的功能不可重複且互不重疊。

exposes vector<Expose>

(選用) 元件公開的功能清單。這些變更包括父項可以看到的功能。父項可以向子項 offer 這些功能,但無法 use 使用。

暴露的功能不得重複且不會重疊。

offers vector<Offer>

(選用) 提供給元件子項的功能清單。這些權限包含特定子項可能 use,且可能來自子項、父項,或元件的傳出命名空間。

提供的功能必須獨一無二且不會重疊。

capabilities vector<Capability>

(選用) 元件定義的功能清單。

children vector<Child>

(選用) 元件的靜態例項化子項。子項的名稱不得重複。

collections vector<Collection>

(選用) 元件的集合。產品素材資源集合的名稱不得重複。

environments vector<Environment>

(選用) 這個元件建立的環境清單。環境會指派給子項,並控制子項元件執行階段的各層面。

facets fuchsia.data/Dictionary

(選填) 元件的其他中繼資料。

config ConfigSchema

(選用) 元件設定介面的結構定義。

ConfigField

fuchsia.component.decl/config.fidl 中定義

宣告單一設定欄位 (鍵 + 類型)

序數廣闊類型說明
key ConfigKey

(必要) 此設定欄位的 ID。 這個金鑰將用於比對覆寫值。

type ConfigType

(必要) 設定值的類型。在建構期間和執行階段,系統都會根據這個版面配置驗證設定值。

mutability ConfigMutability

這個欄位值允許執行的執行階段覆寫來源。

新增時間:12 張

ConfigOverride

定義於 fuchsia.component.decl/child.fidl

用於覆寫子項特定設定欄位值的指令。

新增時間:12 張

序數廣闊類型說明
key ConfigKey
value ConfigValue

ConfigSchema

fuchsia.component.decl/config.fidl 中定義

元件設定介面的結構定義。

序數廣闊類型說明
fields vector<ConfigField>

(必要) 元件設定介面的排序欄位。

checksum ConfigChecksum

(必要) 設定宣告的核對和檢查碼。

value_source ConfigValueSource

(必要) 用於解析設定值的策略。

ConfigSourceCapabilities

fuchsia.component.decl/config.fidl 中定義

已新增:HEAD

序數廣闊類型說明

ConfigValueSpec

fuchsia.component.decl/config.fidl 中定義

個別設定值。系統會根據 ValuesData.values 內的偏移值,與特定設定欄位進行比對。

新增時間:12 張

序數廣闊類型說明
value ConfigValue

ConfigValuesData

fuchsia.component.decl/config.fidl 中定義

設定值檔案的內容。定義元件設定的基本值。

新增時間:12 張

序數廣闊類型說明
values vector<ConfigValueSpec>

元件設定的具體值。

checksum ConfigChecksum

設定結構定義的 SHA-256 總和檢查碼。必須符合元件資訊清單和用來解析最終設定的設定剖析器程式庫中的總和檢查碼。

設定

定義於 fuchsia.component.decl/capability.fidl

宣告設定能力。

如要進一步瞭解設定功能,請參閱:https://fuchsia.dev/fuchsia-src/詞彙#configuration-capability 或 https://fuchsia.dev/fuchsia-src/docs/concepts/components/v2/abilities/configuration

已新增:HEAD

序數廣闊類型說明
name name

(必填) 這項設定的名稱

value ConfigValue

(必要) 此設定的值。

DebugProtocolRegistration

定義於 fuchsia.component.decl/environment.fidl

將環境中的通訊協定註冊為偵錯能力。這樣一來,環境中任何與 source == debug 搭配使用的元件都能使用該元件。

如要進一步瞭解通訊協定,請參閱:https://fuchsia.dev/fuchsia-src/glossary#protocol

序數廣闊類型說明
source Ref

(必要) 相對於元件本身的能力供應器。必須為 parentselfchild

source_name name

(必填) 用於識別所提供通訊協定的名稱。

target_name name

(必填) 提供的能力的名稱。

字典

定義於 fuchsia.component.decl/capability.fidl

宣告字典能力。

已新增:HEAD

序數廣闊類型說明
name name

(必填) 這個字典的名稱。

在內建功能中不得重複。

source Ref

(選用) 用來初始化字典的內容來源。必須為 parentselfchild

source_dictionary dictionary_path

(選用) ref 所提供字典中的路徑,其中包含將用於初始化字典的內容。

如果已設定 source,則必須設定這個屬性。

目錄

定義於 fuchsia.component.decl/capability.fidl

宣告此元件支援的目錄能力。

如要進一步瞭解目錄,請參閱: https://fuchsia.dev/fuchsia-src/glossary#directory

序數廣闊類型說明
name name

(必要) 此目錄的名稱。

source_path string[1024]

(選用) 元件傳出目錄中的目錄路徑。

未設定內建功能。

rights fuchsia.io/Rights

(必要) 元件能使用這個目錄設定的最大權限。

環境

定義於 fuchsia.component.decl/environment.fidl

宣告設定領域的環境。

序數廣闊類型說明
name name

(必要) 環境的名稱。

extends EnvironmentExtends

(必要) 指定這個環境的初始狀態建構方式。

runners vector<RunnerRegistration>

(選用) 這個環境中可用的執行器清單。

此清單決定環境中任何元件可供使用的執行器總數。

resolvers vector<ResolverRegistration>

(選用) 元件解析器及其註冊要解析的網址配置清單。這些註冊會決定如何在運作領域中解析元件。如果元件網址配置與上述任何解析器不符,如果這個環境 extends 來自 REALM,系統會將網址解析委派給父項環境。

debug_capabilities vector<DebugRegistration>

(選用) 在元件管理員允許時,公開偵錯部分的功能。

透過具有 source == debuguse 宣告,環境中的任何元件都可以存取這些功能。您只能在此宣告需要支援開發的功能,而且只能在元件管理員許可清單中明確包含這些功能。

stop_timeout_ms uint32

(選用) 元件終止前必須停止的時間長度 (以毫秒為單位)。如果這個環境 extends 來自 NONE,則為必要欄位。

EventStream

定義於 fuchsia.component.decl/capability.fidl

宣告 event_stream 能力

無法在「fuchsia.component.decl.Component」中使用這個類型。僅用於 internal.Config 中宣告的架構內建功能。

新增日期:8

序數廣闊類型說明
name name

(必填) 此事件串流的名稱。

在內建功能中不得重複。

EventSubscription

fuchsia.component.decl/events.fidl 中定義

用於表示特定事件模式要訂閱的事件名稱。

序數廣闊類型說明
event_name name

(必要) 要訂閱的事件名稱。

ExposeConfiguration

定義於 fuchsia.component.decl/expose.fidl

宣告對包含領域內元件公開的設定能力,例如元件或在執行階段公開的能力。

已新增:HEAD

序數廣闊類型說明
source Ref

(必要) 相對於元件本身的能力供應器。必須為 selfchildvoid。如果設為 void,則目標必須公開、提供或使用具有 OPTIONALTRANSITIONAL 可用性的能力。

source_name name

(必要) 識別設定給此元件時採用的設定名稱。

target Ref

(必要) 能力公開的目的地。

target_name name

(必填) 公開能力的名稱。

availability Availability

(選用,預設為 REQUIRED) 這項能力的可用性。 請參閱「可用性」一節。

ExposeDictionary

定義於 fuchsia.component.decl/expose.fidl

宣告一個公開給元件內含領域的字典,例如元件在執行階段中公開的字典,或元件其中一個子項的字典。

如要進一步瞭解字典,請參閱:https://fuchsia.dev/fuchsia-src/詞彙#dictionary

已新增:HEAD

序數廣闊類型說明
source Ref

(必要) 相對於元件本身的能力供應器。必須為 selfchildvoid。如果設為 void,則目標必須公開、提供或使用具有 OPTIONALTRANSITIONAL 可用性的能力。

source_name name

(必要) 用於識別字典的名稱,指向此元件呈現的字典。

target Ref

(必要) 公開字典的目的地:元件的領域或架構。

target_name name

(必填) 公開能力的名稱。

availability Availability

(選用,預設為 REQUIRED) 這項能力的可用性。 請參閱「可用性」一節。

source_dictionary string[1024]

(選用) ref 提供的字典中的路徑,其中包含 source_name。如果沒有這個欄位,source_name 會識別直接由 source 轉送的能力。如果設定,source_name 會識別字典內巢狀結構的能力。頂層字典的名稱由 source_dictionary 的第一個路徑區段指定,而 source 應轉送使用此名稱的字典能力。路徑的其餘部分 (可能為空白) 代表頂層字典中應包含 source_name 的字典路徑。

已新增:HEAD

ExposeDirectory

定義於 fuchsia.component.decl/expose.fidl

宣告在元件內公開的目錄,例如元件在執行階段公開的目錄,或元件的其中一個子項。

序數廣闊類型說明
source Ref

(必要) 相對於元件本身的能力供應器。必須為 selfchildvoid。如果設為 void,則目標必須公開、提供或使用具有 OPTIONALTRANSITIONAL 可用性的能力。

source_name name

(必要) 用於識別向此元件呈現目錄的目錄名稱。

target Ref

(必要) 公開目錄的目的地:元件的領域或架構。

target_name name

(必填) 公開能力的名稱。

rights fuchsia.io/Rights

(選用) 某個元件可使用這個目錄設定的權限上限。如未設定,系統會沿用 source 的權限。

subdir string[1024]

(選用) 要公開而非根目錄的子目錄。

availability Availability

(選用,預設為 REQUIRED) 這項能力的可用性。 請參閱「可用性」一節。

新增時間:11 張
source_dictionary string[1024]

(選用) ref 提供的字典中的路徑,其中包含 source_name。如果沒有這個欄位,source_name 會識別直接由 source 轉送的能力。如果設定,source_name 會識別字典內巢狀結構的能力。頂層字典的名稱由 source_dictionary 的第一個路徑區段指定,而 source 應轉送使用此名稱的字典能力。路徑的其餘部分 (可能為空白) 代表頂層字典中應包含 source_name 的字典路徑。

已新增:HEAD

ExposeProtocol

定義於 fuchsia.component.decl/expose.fidl

宣告在元件內含領域時公開的通訊協定,例如元件在執行階段中公開的通訊協定或其其中一個子項。

如要進一步瞭解通訊協定,請參閱:https://fuchsia.dev/fuchsia-src/glossary#protocol

序數廣闊類型說明
source Ref

(必要) 相對於元件本身的能力供應器。必須為 selfchildvoid。如果設為 void,則目標必須公開、提供或使用具有 OPTIONALTRANSITIONAL 可用性的能力。

source_name name

(必要) 用於識別向此元件呈現此元件的通訊協定名稱。

target Ref

(必要) 公開通訊協定的目的地:元件的領域或架構。

target_name name

(必填) 公開能力的名稱。

availability Availability

(選用,預設為 REQUIRED) 這項能力的可用性。 請參閱「可用性」一節。

新增時間:11 張
source_dictionary string[1024]

(選用) ref 提供的字典中的路徑,其中包含 source_name。如果沒有這個欄位,source_name 會識別直接由 source 轉送的能力。如果設定,source_name 會識別字典內巢狀結構的能力。頂層字典的名稱由 source_dictionary 的第一個路徑區段指定,而 source 應轉送使用此名稱的字典能力。路徑的其餘部分 (可能為空白) 代表頂層字典中應包含 source_name 的字典路徑。

已新增:HEAD

ExposeResolver

定義於 fuchsia.component.decl/expose.fidl

宣告曝露在元件內具有領域的解析器,例如元件在執行階段公開的解析器或元件的其中一個子項。

序數廣闊類型說明
source Ref

(必要) 相對於元件本身的能力供應器。必須為 selfchild

source_name name

(必要) 提供給此元件的解析器名稱。

target Ref

(必要) 公開解析器的目的地

target_name name

(必填) 公開能力的名稱。

source_dictionary string[1024]

(選用) ref 提供的字典中的路徑,其中包含 source_name。如果沒有這個欄位,source_name 會識別直接由 source 轉送的能力。如果設定,source_name 會識別字典內巢狀結構的能力。頂層字典的名稱由 source_dictionary 的第一個路徑區段指定,而 source 應轉送使用此名稱的字典能力。路徑的其餘部分 (可能為空白) 代表頂層字典中應包含 source_name 的字典路徑。

已新增:HEAD

ExposeRunner

定義於 fuchsia.component.decl/expose.fidl

宣告向元件內所含領域公開的執行元件,例如元件在執行階段公開的執行元件,或元件的其中一個子項。

序數廣闊類型說明
source Ref

(必要) 相對於元件本身的能力供應器。必須為 selfchild

source_name name

(必要) 向此元件呈現的執行元件名稱。

target Ref

(必要) 公開執行元件的目的地:元件的領域或架構。

target_name name

(必填) 公開能力的名稱。

source_dictionary string[1024]

(選用) ref 提供的字典中的路徑,其中包含 source_name。如果沒有這個欄位,source_name 會識別直接由 source 轉送的能力。如果設定,source_name 會識別字典內巢狀結構的能力。頂層字典的名稱由 source_dictionary 的第一個路徑區段指定,而 source 應轉送使用此名稱的字典能力。路徑的其餘部分 (可能為空白) 代表頂層字典中應包含 source_name 的字典路徑。

已新增:HEAD

ExposeService

定義於 fuchsia.component.decl/expose.fidl

宣告在包含領域內暴露在元件中的服務,例如元件在執行階段公開的服務,或元件的其中一個子項。

如要進一步瞭解服務,請參閱: https://fuchsia.dev/fuchsia-src/glossary#service

序數廣闊類型說明
source Ref

(必要) 相對於元件本身的能力供應器。必須為 selfchildvoid。如果設為 void,則目標必須公開、提供或使用具有 OPTIONALTRANSITIONAL 可用性的能力。

source_name name

(必要) 識別服務給此元件時使用的名稱。

target Ref

(必要) 公開服務的目的地:元件的領域或架構。

target_name name

(必填) 公開能力的名稱。

availability Availability

(選用,預設為 REQUIRED) 這項能力的可用性。 請參閱「可用性」一節。

新增時間:11 張
source_dictionary string[1024]

(選用) source 所提供字典中的路徑,其中包含 source_name。如果沒有這個欄位,source_name 會識別直接由 source 轉送的能力。如果設定,source_name 會識別這個字典內巢狀結構的能力。

已新增:HEAD

OfferConfiguration

定義於 fuchsia.component.decl/offer.fidl

將元件提供的設定能力宣告為其其中一個子項,而該功能可能是由元件包含的領域、元件本身或其其他子項提供。

已新增:HEAD

序數廣闊類型說明
source Ref

(必要) 相對於元件本身的能力供應器。必須為 parentselfchildvoid。如果設為 void,則目標必須提供或使用有 OPTIONALTRANSITIONAL 可用性的能力。

source_name name

(必填) 用於識別所提供設定的名稱。

target Ref

(必要) 目標的參照。必須為 childcollection

target_name name

(必填) 提供的能力的名稱。

availability Availability

(選用,預設為 REQUIRED) 這項能力的可用性。 如果設為 required,目標可能會使用或提供 requiredoptional 可用性的能力。如果設為 optional,目標必須使用或提供具有 optional 可用性的能力。same_as_target 值會使這項優惠的供應情形與目標中設定的供應情形相符。

OfferDictionary

定義於 fuchsia.component.decl/offer.fidl

將元件提供的字典宣告為其其中一個子項,而該元件可能是由元件包含的領域、元件本身或其其他子項提供。

如要進一步瞭解字典,請參閱: https://fuchsia.dev/fuchsia-src/詞彙#dictionary

已新增:HEAD

序數廣闊類型說明
source Ref

(必要) 相對於元件本身的能力供應器。必須為 parentselfchildvoid。如果設為 void,則目標必須提供或使用有 OPTIONALTRANSITIONAL 可用性的能力。

source_name name

(必填) 用於識別提供的字典的名稱。

target Ref

(必要) 目標的參照。必須為 childcollection 或字典 capability

target_name name

(必填) 提供的能力的名稱。

dependency_type DependencyType

(必要) 此優惠代表的依附關係類型。接收不足優惠的元件必須支援在任何時間點無法使用的能力。

availability Availability

(選用,預設為 REQUIRED) 這項能力的可用性。 如果設為 required,目標可能會使用或提供 requiredoptional 可用性的能力。如果設為 optional,目標必須使用或提供具有 optional 可用性的能力。same_as_target 值會使這項優惠的供應情形與目標中設定的供應情形相符。

source_dictionary dictionary_path

(選用) source 所提供字典中的路徑,其中包含 source_name。如果沒有這個欄位,source_name 會識別直接由 source 轉送的能力。如果設定,source_name 會識別這個字典內巢狀結構的能力。

已新增:HEAD

OfferDirectory

定義於 fuchsia.component.decl/offer.fidl

將元件提供的目錄宣告為其其中一個子項,而該目錄可能是由元件內含的領域、元件本身或其其他子項提供。

序數廣闊類型說明
source Ref

(必要) 相對於元件本身的能力供應器。必須為 parentselfchildvoid。如果設為 void,則目標必須提供或使用有 OPTIONALTRANSITIONAL 可用性的能力。

source_name name

(必填) 用於識別提供的目錄的名稱。

target Ref

(必要) 目標的參照。必須為 childcollection 或字典 capability

target_name name

(必填) 提供的能力的名稱。

rights fuchsia.io/Rights

(選用) 某個元件可使用這個目錄設定的權限上限。如未設定,系統會沿用 source 的權限。

subdir string[1024]

(選用) 此目錄要提供而非根目錄的子目錄。選用。

dependency_type DependencyType

(必要) 此優惠代表的依附關係類型。接收不足優惠的元件必須支援在任何時間點無法使用的能力。

availability Availability

(選用,預設為 REQUIRED) 這項能力的可用性。 如果設為 required,目標可能會使用或提供 requiredoptional 可用性的能力。如果設為 optional,目標必須使用或提供具有 optional 可用性的能力。same_as_target 值會使這項優惠的供應情形與目標中設定的供應情形相符。

source_dictionary dictionary_path

(選用) source 所提供字典中的路徑,其中包含 source_name。如果沒有這個欄位,source_name 會識別直接由 source 轉送的能力。如果設定,source_name 會識別這個字典內巢狀結構的能力。

已新增:HEAD

OfferEventStream

定義於 fuchsia.component.decl/offer.fidl

宣告元件提供的事件串流。

序數廣闊類型說明
source Ref

(必要) 相對於元件本身的能力供應器。必須是 parentframeworkchildvoid。如果設為 void,則目標必須提供或使用有 OPTIONALTRANSITIONAL 可用性的能力。

source_name name

(必填) 所提供活動的名稱。

scope vector<Ref>

(選用) 如果事件是由架構提供,則必須設定範圍,並讓一個範圍定義事件相關的子項 (或子項陣列)。如果事件是由父項提供,該範圍可用於將事件向下範圍限制至特定子項範圍,否則,該事件會攜帶來自父項的範圍。

target Ref

(必要) 提供事件串流的目的地。

target_name name

(必填) 提供事件串流時使用的名稱。

availability Availability

(選用,預設為 REQUIRED) 這項能力的可用性。 如果設為 required,目標可能會使用或提供 requiredoptional 可用性的能力。如果設為 optional,目標必須使用或提供具有 optional 可用性的能力。same_as_target 值會使這項優惠的供應情形與目標中設定的供應情形相符。

OfferProtocol

定義於 fuchsia.component.decl/offer.fidl

宣告元件提供給其其中一個子項的通訊協定,該通訊協定可能是由元件包含的領域、元件本身或其其他子項提供。

如要進一步瞭解通訊協定,請參閱:https://fuchsia.dev/fuchsia-src/glossary#protocol

序數廣闊類型說明
source Ref

(必要) 相對於元件本身的能力供應器。必須為 parentselfchildvoid。如果設為 void,則目標必須提供或使用有 OPTIONALTRANSITIONAL 可用性的能力。

source_name name

(必填) 用於識別所提供通訊協定的名稱。

target Ref

(必要) 目標的參照。必須為 childcollection 或字典 capability

target_name name

(必填) 提供的能力的名稱。

dependency_type DependencyType

(必要) 此優惠代表的依附關係類型。接收不足優惠的元件必須支援在任何時間點無法使用的能力。

availability Availability

(選用,預設為 REQUIRED) 這項能力的可用性。 如果設為 required,目標可能會使用或提供 requiredoptional 可用性的能力。如果設為 optional,目標必須使用或提供具有 optional 可用性的能力。same_as_target 值會使這項優惠的供應情形與目標中設定的供應情形相符。

source_dictionary dictionary_path

(選用) source 所提供字典中的路徑,其中包含 source_name。如果沒有這個欄位,source_name 會識別直接由 source 轉送的能力。如果設定,source_name 會識別這個字典內巢狀結構的能力。

已新增:HEAD

OfferResolver

定義於 fuchsia.component.decl/offer.fidl

將元件提供的解析器能力宣告為其其中一個子項,而該元件可能是由元件包含的領域、元件本身或其其他子項提供。

序數廣闊類型說明
source Ref

(必要) 相對於元件本身的能力供應器。必須為 parentselfchildvoid。如果設為 void,則目標必須提供或使用有 OPTIONALTRANSITIONAL 可用性的能力。

source_name name

(必填) 所提供解析器的名稱。

target Ref

(必要) 目標的參照。必須為 childcollection 或字典 capability

target_name name

(必填) 提供能力時使用的名稱。

source_dictionary dictionary_path

(選用) source 所提供字典中的路徑,其中包含 source_name。如果沒有這個欄位,source_name 會識別直接由 source 轉送的能力。如果設定,source_name 會識別這個字典內巢狀結構的能力。

已新增:HEAD

OfferRunner

定義於 fuchsia.component.decl/offer.fidl

將元件提供的執行元件宣告為其中一個子項,而該元件可能是由元件的領域、元件本身或其其他子項提供。

序數廣闊類型說明
source Ref

(必要) 相對於元件本身的能力供應器。必須為 parentselfchildvoid。如果設為 void,則目標必須提供或使用有 OPTIONALTRANSITIONAL 可用性的能力。

source_name name

(必填) 提供的執行元件名稱。

target Ref

(必要) 目標的參照。必須為 childcollection 或字典 capability

target_name name

(必填) 提供能力時使用的名稱。

source_dictionary dictionary_path

(選用) source 所提供字典中的路徑,其中包含 source_name。如果沒有這個欄位,source_name 會識別直接由 source 轉送的能力。如果設定,source_name 會識別這個字典內巢狀結構的能力。

已新增:HEAD

OfferService

定義於 fuchsia.component.decl/offer.fidl

將元件提供的服務宣告為其其中一個子項,而該元件可能是由元件包含的領域、元件本身或其其他子項提供。

如要進一步瞭解服務,請參閱: https://fuchsia.dev/fuchsia-src/glossary#service

序數廣闊類型說明
source Ref

(必要) 相對於元件本身的能力供應器。必須為 parentselfchildvoid。如果設為 void,則目標必須提供或使用有 OPTIONALTRANSITIONAL 可用性的能力。

source_name name

(必填) 用於識別所提供服務的名稱。

target Ref

(必要) 目標的參照。必須為 childcollection 或字典 capability

target_name name

(必填) 提供能力時使用的名稱。

source_instance_filter vector<string>

(選用) 要提供的已加入許可清單執行個體清單。目標元件將無法存取這份清單未列出的服務執行個體。如未設定,系統會提供來源服務的所有執行個體。

renamed_instances vector<NameMapping>

(選用) 要提供的已加入許可清單執行個體清單,其中具有重新命名項目。

如果您將這個值設為非空白,目標服務中的一組執行個體將僅限於這份清單中的執行個體,將 source_name 重新命名為 target_name

如果已設定且非空白,source_instance_filter 會進一步限制 target_name 出現在這份清單中的執行個體組合。一般而言,您無法同時設定兩者,但我們會支援相容性。

availability Availability

(選用,預設為 REQUIRED) 這項能力的可用性。 如果設為 required,目標可能會使用或提供 requiredoptional 可用性的能力。如果設為 optional,目標必須使用或提供具有 optional 可用性的能力。same_as_target 值會使這項優惠的供應情形與目標中設定的供應情形相符。

source_dictionary dictionary_path

(選用) source 所提供字典中的路徑,其中包含 source_name。如果沒有這個欄位,source_name 會識別直接由 source 轉送的能力。如果設定,source_name 會識別這個字典內巢狀結構的能力。

已新增:HEAD

OfferStorage

定義於 fuchsia.component.decl/offer.fidl

宣告元件提供給其子項的儲存空間能力,例如元件內含的領域或由元件提供的快取儲存空間提供的中繼儲存空間。

序數廣闊類型說明
source_name name

(必填) 提供的儲存空間能力名稱

source Ref

(必要) 相對於元件本身的能力供應器。必須為 parentselfchildvoid。如果設為 void,則目標必須提供或使用有 OPTIONALTRANSITIONAL 可用性的能力。

target Ref

(必要) 目標的參照。必須為 childcollection 或字典 capability

target_name name

(必填) 所提供之儲存空間能力的名稱

availability Availability

(選用,預設為 REQUIRED) 這項能力的可用性。 如果設為 required,目標可能會使用或提供 requiredoptional 可用性的能力。如果設為 optional,目標必須使用或提供具有 optional 可用性的能力。same_as_target 值會使這項優惠的供應情形與目標中設定的供應情形相符。

程式

定義於 fuchsia.component.decl/program.fidl

計畫宣告。

這項宣告是由可執行元件設定,藉此指定執行器要使用的執行器,並將執行器專屬的程式資訊傳遞至該元件。

如要進一步瞭解跑者,請參閱: https://fuchsia.dev/fuchsia-src/詞彙#runner

序數廣闊類型說明
runner name

用來執行元件的執行器名稱。必須與元件環境中的 RunnerRegistration 相符。如未提供這個值,元件必須「使用」執行元件。如果提供這個值,元件可能會「使用」執行元件,但必須相同 (與環境中的名稱相符)。

info fuchsia.data/Dictionary

(必要) 元件執行時要執行的程式相關資訊。元件管理員在執行這個程式時,會將這個字典的內容提供給執行元件。

舉例來說,這可能包含程式的可執行映像檔路徑,或是程式引數。

  • 這些鍵代表命名空間屬性,並以「.」分隔。
  • 屬性可以嵌入值中,但只有在物件向量的情況下。

通訊協定

定義於 fuchsia.component.decl/capability.fidl

宣告此元件支援的通訊協定能力。

如要進一步瞭解通訊協定,請參閱:https://fuchsia.dev/fuchsia-src/glossary#protocol

序數廣闊類型說明
name name

(必填) 此通訊協定的名稱。

source_path string[1024]

(選用) 元件傳出目錄中的通訊協定路徑。

未設定內建功能。

delivery DeliveryType

(選用,預設為 EAGER) 指定在有人要求這項能力時,架構會從這個元件的傳出目錄開啟通訊協定的時間。詳情請參閱「DeliveryType」。

已新增:HEAD

解析器

定義於 fuchsia.component.decl/capability.fidl

宣告解析器,該解析器負責將元件網址解析為實際元件。如要瞭解應實作的通訊協定解析器,請參閱 fuchsia.component.resolution.Resolver

序數廣闊類型說明
name name

(必要) 此解析器的名稱。

不得與同一個 ComponentDecl 中宣告的解析器重複。

source_path string[1024]

(選用) 元件傳出目錄中的解析器通訊協定路徑

未設定內建功能。

ResolverRegistration

定義於 fuchsia.component.decl/environment.fidl

網址配置與解析器名稱的對應。

序數廣闊類型說明
resolver name

(必要) 解析器的名稱。

source Ref

(必要) 相對於元件本身的能力供應器。必須為 parentselfchild

scheme url_scheme

(必要) 解析器註冊要處理的網址配置。每個網址配置只能註冊一個解析器。網址配置必須以小寫 ASCII 字母 (a-z) 開頭,可包含小寫 ASCII 字母、數字、+-.

跑酷

定義於 fuchsia.component.decl/capability.fidl

宣告服務支援的執行元件能力。

序數廣闊類型說明
name name

(必填) 此執行元件的名稱。

不得與同一個 ComponentDecl 中宣告的執行器重複。

source_path string[1024]

(選用) 元件傳出目錄中的執行元件通訊協定路徑。

未設定內建功能。

RunnerRegistration

定義於 fuchsia.component.decl/environment.fidl

環境中可用的執行器存放區。

序數廣闊類型說明
source_name name

(必要) 由這個元件公開、提供或定義的執行元件能力名稱。

source Ref

(必要) 相對於元件本身的能力供應器。必須為 parentselfchild

target_name name

(必填) 在此環境中可使用執行元件的名稱。

服務

定義於 fuchsia.component.decl/capability.fidl

宣告此元件支援的服務能力。

如要進一步瞭解服務,請參閱: https://fuchsia.dev/fuchsia-src/glossary#service

序數廣闊類型說明
name name

(必填) 此服務的名稱。

source_path string[1024]

(選用) 元件傳出目錄中的服務路徑。

未設定內建功能。

儲存空間

定義於 fuchsia.component.decl/capability.fidl

宣告由目錄支援的儲存空間能力,該目錄可提供資料、快取或中繼儲存空間。

序數廣闊類型說明
name name

(必填) 這個儲存空間的名稱

source Ref

(必要) 相對於元件本身,支援目錄能力的提供者。必須為 parentselfchild

backing_dir name

(必要) 備份儲存空間的 source 目錄能力名稱。

subdir string[1024]

(選用) 傳回儲存空間的來源目錄子目錄

storage_id StorageId

(必要) 此列舉決定如何為元件的獨立儲存空間目錄建立索引鍵。每個選項都會對應不同的金鑰策略。

UseConfiguration

定義於 fuchsia.component.decl/use.fidl

已新增:HEAD

序數廣闊類型說明
source Ref

(必要) 相對於元件本身的設定提供者。必須為 parentselfchild

source_name name

(必要) 用於識別設定,給此元件使用的設定。

target_name name

(必要) 元件會看到此設定的名稱。這必須與這個元件「設定」架構中的鍵相符。相符設定欄位的類型必須與這個設定類型相符。

availability Availability

(選用,預設為 REQUIRED) 這項能力的可用性。 如果設為 required,如未提供此能力,元件可能會無法正常運作。如果設為 optional,元件就能處理缺少能力。

type ConfigType

(必要) 此設定值的類型。如果 target_nameconfig 結構定義中的鍵相符,則這個類型必須與該類型相符。

UseDirectory

定義於 fuchsia.component.decl/use.fidl

宣告元件使用的目錄,而該目錄會提供該元件。

序數廣闊類型說明
source Ref

(必要) 與元件本身相關的目錄提供者。必須為 parentframeworkchild

source_name name

(必要) 用於識別向此元件呈現目錄的目錄名稱。

target_path string[1024]

(必要) 應將能力安裝在元件命名空間中的路徑。

必須為開頭為 / 的絕對路徑。

rights fuchsia.io/Rights

(必要) 元件使用這個目錄所需的權限。

subdir string[1024]

(選用) 此目錄用於替代根目錄的子目錄。

dependency_type DependencyType

(必要) 這個使用行為代表的依附元件類型。

如果元件本身為子項提供能力,並採用同一子項的能力,就必須將依附元件標示為 weakweak 依附元件表示該能力在任何時間點可能無法使用。若為子項的能力建立強而有力的依附元件,會導致子項在其父項之前關閉。使用弱依附元件時,父項會在子項之前關閉。

availability Availability

(選用,預設為 REQUIRED) 這項能力的可用性。 如果設為 required,如未提供此能力,元件可能會無法正常運作。如果設為 optional,元件就能處理缺少能力。

source_dictionary dictionary_path

(選用) source 所提供字典中的路徑,其中包含 source_name。如果沒有這個欄位,source_name 會識別直接由 source 轉送的能力。如果設定,source_name 會識別這個字典內巢狀結構的能力。

已新增:HEAD

UseEventStream

定義於 fuchsia.component.decl/use.fidl

宣告元件使用的 EventStream。

序數廣闊類型說明
source_name name

(必要) 事件串流的名稱。

source Ref

(必要) 事件的提供者。必須為 parentframeworkchild

scope vector<Ref>

(選用) 如果從架構使用事件,則必須利用範圍來指定事件所在的子項 (或子項陣列)。如果從父項使用事件,該範圍可用於將事件範圍縮小至特定子項範圍,否則,該事件會沿用父項範圍。

target_path name

(必要) 應將能力安裝在元件命名空間中的路徑。必須為開頭為 / 的絕對路徑。

availability Availability

(選用,預設為 REQUIRED) 這項能力的可用性。 如果設為 required,如未提供此能力,元件可能會無法正常運作。如果設為 optional,元件就能處理缺少能力。

filter fuchsia.data/Dictionary

(選用) 事件串流的篩選器。篩選器的結構取決於事件串流類型。僅適用於 CapabilityRequested 事件類型。

新增日期:9

UseProtocol

定義於 fuchsia.component.decl/use.fidl

宣告元件使用的通訊協定,以及該元件提供的通訊協定。

「通訊協定」是具有單一執行個體的服務,由單一 FIDL 通訊協定提供。

序數廣闊類型說明
source Ref

(必要) 與元件本身相關的通訊協定提供者。須為 parentframeworkdebugcapabilitychild

source_name name

(必要) 用於識別向此元件呈現的通訊協定的名稱。

target_path string[1024]

(必要) 應在元件命名空間中安裝這項能力的路徑。

必須為開頭為 / 的絕對路徑。

dependency_type DependencyType

(必要) 這個使用行為代表的依附元件類型。

如果元件本身為子項提供能力,並採用同一子項的能力,就必須將依附元件標示為 weakweak 依附元件表示該能力在任何時間點可能無法使用。若為子項的能力建立強而有力的依附元件,會導致子項在其父項之前關閉。使用弱依附元件時,父項會在子項之前關閉。

availability Availability

(選用,預設為 REQUIRED) 這項能力的可用性。 如果設為 required,如未提供此能力,元件可能會無法正常運作。如果設為 optional,元件就能處理缺少能力。

source_dictionary dictionary_path

(選用) source 所提供字典中的路徑,其中包含 source_name。如果沒有這個欄位,source_name 會識別直接由 source 轉送的能力。如果設定,source_name 會識別這個字典內巢狀結構的能力。

已新增:HEAD

UseRunner

定義於 fuchsia.component.decl/use.fidl

宣告元件使用的執行元件。

已新增:HEAD

序數廣闊類型說明
source Ref

(必要) 元件相對於元件的提供者。必須是 parentchildframeworkenvironment

source_name name

(必要) 識別執行元件,向此元件呈現的執行器名稱。

source_dictionary dictionary_path

(選用) source 所提供字典中的路徑,其中包含 source_name。如果沒有這個欄位,source_name 會識別直接由 source 轉送的能力。如果設定,source_name 會識別這個字典內巢狀結構的能力。

已新增:HEAD

UseService

定義於 fuchsia.component.decl/use.fidl

宣告元件使用的服務,

如要進一步瞭解服務,請參閱: https://fuchsia.dev/fuchsia-src/glossary#service

序數廣闊類型說明
source Ref

(必要) 與元件本身相關的通訊協定提供者。必須是 parentframeworkselfchild

source_name name

(必要) 識別服務給此元件時使用的名稱。

target_path string[1024]

(必要) 應將能力安裝在元件命名空間中的路徑。

必須為開頭為 / 的絕對路徑。

dependency_type DependencyType

(必要) 這個使用行為代表的依附元件類型。

如果元件本身為子項提供能力,並採用同一子項的能力,就必須將依附元件標示為 weakweak 依附元件表示該能力在任何時間點可能無法使用。若為子項的能力建立強而有力的依附元件,會導致子項在其父項之前關閉。使用弱依附元件時,父項會在子項之前關閉。

availability Availability

(選用,預設為 REQUIRED) 這項能力的可用性。 如果設為 required,如未提供此能力,元件可能會無法正常運作。如果設為 optional,元件就能處理缺少能力。

source_dictionary dictionary_path

(選用) source 所提供字典中的路徑,其中包含 source_name。如果沒有這個欄位,source_name 會識別直接由 source 轉送的能力。如果設定,source_name 會識別這個字典內巢狀結構的能力。

已新增:HEAD

UseStorage

定義於 fuchsia.component.decl/use.fidl

宣告元件使用的儲存空間,

序數廣闊類型說明
source_name name

(必要) 識別向此元件呈現的儲存空間名稱。

target_path string[1024]

(必要) 應將能力安裝在元件命名空間中的路徑。

必須為開頭為 / 的絕對路徑。

availability Availability

(選用,預設為 REQUIRED) 這項能力的可用性。 如果設為 required,如未提供此能力,元件可能會無法正常運作。如果設為 optional,元件就能處理缺少能力。

聯合國

功能彈性

定義於 fuchsia.component.decl/capability.fidl

宣告此元件定義的能力。

序數Variant類型說明
service Service
protocol Protocol
directory Directory
storage Storage
runner Runner
resolver Resolver
event_stream EventStream
新增日期:8
dictionary Dictionary
已新增:HEAD
config Configuration
已新增:HEAD

ConfigChecksum 彈性

fuchsia.component.decl/config.fidl 中定義

為設定介面產生的總和檢查碼。如果兩者的總和檢查碼相同,則兩個設定介面相同。

序數Variant類型說明
sha256 uint8[32]

透過元件設定介面產生的 SHA-256 雜湊。

ConfigSingleValue 彈性

fuchsia.component.decl/config.fidl 中定義

單一設定值。

新增時間:12 張
序數Variant類型說明
bool bool
uint8 uint8
uint16 uint16
uint32 uint32
uint64 uint64
int8 int8
int16 int16
int32 int32
int64 int64
string string

ConfigValue 彈性

fuchsia.component.decl/config.fidl 中定義

可提供給元件的設定值。

同時用於儲存靜態設定和執行階段設定 API。

新增時間:12 張
序數Variant類型說明
single ConfigSingleValue
vector ConfigVectorValue

ConfigValueSource 彈性

fuchsia.component.decl/config.fidl 中定義

可用於解析設定值的策略。

序數Variant類型說明
package_path string

(必要) 元件套件中可尋找設定檔值的路徑。

capabilities ConfigSourceCapabilities

如果設定了這個值,系統就會透過 CML 檔案找到所有設定值。

已新增:HEAD

ConfigVectorValue 彈性

fuchsia.component.decl/config.fidl 中定義

向量設定值。

新增時間:12 張
序數Variant類型說明
bool_vector vector<bool>
uint8_vector vector<uint8>
uint16_vector vector<uint16>
uint32_vector vector<uint32>
uint64_vector vector<uint64>
int8_vector vector<int8>
int16_vector vector<int16>
int32_vector vector<int32>
int64_vector vector<int64>
string_vector vector<string>

DebugRegistration 彈性

定義於 fuchsia.component.decl/environment.fidl

宣告在環境偵錯部分中註冊的能力。

序數Variant類型說明
protocol DebugProtocolRegistration

公開彈性

定義於 fuchsia.component.decl/expose.fidl

宣告向元件內含領域或架構公開的能力。例如,元件在執行階段公開的舊版服務。

序數Variant類型說明
service ExposeService
protocol ExposeProtocol
directory ExposeDirectory
runner ExposeRunner
resolver ExposeResolver
dictionary ExposeDictionary
已新增:HEAD
config ExposeConfiguration
已新增:HEAD

LayoutConstraint 彈性

fuchsia.component.decl/config.fidl 中定義

序數Variant類型說明
max_size uint32

LayoutParameter 彈性

fuchsia.component.decl/config.fidl 中定義

序數Variant類型說明
nested_type ConfigType

提供彈性方案

定義於 fuchsia.component.decl/offer.fidl

將元件提供的能力宣告為其其中一個子項,而該功能可能是由元件內含的領域、元件本身或其其他子項提供。

序數Variant類型說明
service OfferService
protocol OfferProtocol
directory OfferDirectory
storage OfferStorage
runner OfferRunner
resolver OfferResolver
event_stream OfferEventStream
dictionary OfferDictionary
已新增:HEAD
config OfferConfiguration
已新增:HEAD

參考彈性

定義於 fuchsia.component.decl/relative_refs.fidl

相對於這個元件的能力來源或目的地的參照。

序數Variant類型說明
parent ParentRef
self SelfRef
child ChildRef
collection CollectionRef
framework FrameworkRef
capability CapabilityRef
debug DebugRef
void_type VoidRef
environment EnvironmentRef
已新增:HEAD
program ProgramRef
已新增:HEAD

使用「彈性」模式

定義於 fuchsia.component.decl/use.fidl

宣告元件使用的能力,以及該元件提供的功能。

序數Variant類型說明
service UseService
protocol UseProtocol
directory UseDirectory
storage UseStorage
event_stream UseEventStream
runner UseRunner
已新增:HEAD
config UseConfiguration
已新增:HEAD

帳單

ConfigMutability 彈性

類型:uint32

fuchsia.component.decl/config.fidl 中定義

允許用於覆寫設定欄位值的執行階段來源。

新增時間:12 張

名稱物超所值說明
1

允許父項元件提供設定欄位的覆寫值。

業者

名稱物超所值類型說明
CONFIG_KEY_MAX_SIZE 64 uint32

設定金鑰只能包含所需位元組數

MAX_CHILD_NAME_LENGTH 1024 uint32
MAX_MONIKER_LENGTH 4096 uint32
MAX_NAME_LENGTH 100 uint32
MAX_NUM_EVENT_STREAM_SUBSCRIPTIONS 100 uint64

EventStream 中的 Event 訂閱數量上限。

MAX_PATH_LENGTH 1024 uint32
MAX_URL_SCHEME_LENGTH 100 uint32

別名

名稱物超所值說明
ConfigKey string[CONFIG_KEY_MAX_SIZE]

設定欄位的字串 ID。

child_name string[MAX_CHILD_NAME_LENGTH]
dictionary_path string[MAX_PATH_LENGTH]

字典中的路徑。格式與目錄路徑類似,但不包含 ...。,且每個路徑區段都必須符合 name 類型的格式。

「目錄名稱」(最前面區段,一個區隔則為空白) 代表一系列的巢狀字典。「basename」(最後一個區段) 可識別最後一個巢狀字典中的能力。

已新增:HEAD
名稱 string[MAX_NAME_LENGTH]
url_scheme string[MAX_URL_SCHEME_LENGTH]