本節說明向使用者顯示網址的語法。
網址格式
原則上,元件網址可以有任何配置。您可能會遇到的一些常見配置如下:
紫紅色-褲子
fuchsia-pkg
元件網址是一種套件網址,可用來尋找在 Fuchsia 套件中發布的元件。
其格式與套件網址相同,並具有會定位元件資訊清單的套件根目錄相關聯的資源路徑。這個路徑通常格式為 meta/<manifest_name>.cm
。
fuchsia-pkg://<repo-hostname>[/<pkg-name>[/<pkg-variant>][?hash=<pkg-hash>][#<path-to-manifest>]]
例子:
fuchsia-pkg://fuchsia.com/stash#meta/stash_secure.cm
紫紅色靴
fuchsia-boot
元件網址會在系統啟動映像檔中找到某個元件。這個配置是用來找出必須在 fuchsia-pkg
解析器可用之前,早期啟動期間必須解決的元件。格式如下:
fuchsia-boot:///<path-to-manifest-in-bootfs>
例子:
fuchsia-boot:///#meta/driver_manager.cm
http(s)
http(s)
元件網址會將網頁識別為元件。舉例來說,這類元件可在網路runner中做為網頁執行。
例子:
https://en.wikipedia.org/wiki/Hippos
相對網址
元件架構支援部分相對網址 (相對網址定義於網址 RFC 3986 中)。具體來說,元件架構支援將相對路徑網址 (加上元件資訊清單路徑的網址片段) 至子封裝的元件,以及僅限片段的網址。
元件資訊清單的路徑是相對元件網址片段 (#meta/<component>.cm
) 中唯一允許的內容。如果片段包含任何其他內容,或是相對元件包含網址查詢參數 (?key=value
),元件就無法解析。
子封裝元件的相對路徑網址
相對路徑網址在執行階段會根據已知的「內容」解析。若是使用相對網址解析子項元件的元件,結構定義是由與父項元件相關聯的解析器提供值。
path
相關子套件路徑網址是以相對套件網址開頭,並採用下列格式:
<subpackage-path>#<path-to-manifest>
例子:
child#meta/default.cm
如要進一步瞭解子套件和子封裝元件,請參閱 Fuchsia Subpackages 說明文件。
僅限片段的相對網址
系統會根據父項元件套件的網址,在執行階段解析相對片段的相對片段網址。僅限片段的網址採用以下格式:
#<path-to-manifest>
例子:
#meta/child.cm
針對使用下列網址的 fuchsia-pkg
父項元件:
fuchsia-pkg://fuchsia.com/package#meta/component.cm
相對網址會解析為:
fuchsia-pkg://fuchsia.com/package#meta/child.cm