Rust 中記錄

本文說明如何開始在 Fuchsia 登入 Rust 程式。如需記錄及查看記錄的一般資訊，請參閱語言診斷記錄說明文件。

必要功能

在元件資訊清單中加入以下內容，確認您的元件要求適當的記錄功能：

{
  include: [
    "syslog/client.shard.cml"
  ],
  ...
}

初始化

您必須先初始化記錄，才能從 Rust 程式碼記錄記錄。初始化作業是由 fuchsia Crate 設定巨集處理。

GN 依附元件

將下列 deps 新增至 BUILD.gn 檔案：

deps = [
  "//src/lib/fuchsia",
]

設定

在 Rust 來源檔案中，所有使用 fuchsia::main 或 fuchsia::test 巨集初始化的函式都會啟用記錄功能：

#[fuchsia::main]
fn main() {
    // ...
}

#[fuchsia::test]
fn example_test() {
    // ...
}

您也可以傳遞 logging 旗標，明確表示：

#[fuchsia::main(logging = true)]
fn main() {
    // ...
}

#[fuchsia::test(logging = true)]
fn example_test() {
    // ...
}

新增標記

記錄訊息可包含一或多個標記，藉此提供額外的背景資訊。如要為指定範圍啟用記錄標記，請在初始化期間傳遞 logging_tags 參數：

#[fuchsia::main(logging_tags = ["foo", "bar"])]
fn main() {
    // ...
}

#[fuchsia::test(logging_tags = ["foo", "bar"])]
fn example_test_with_tags() {
    // ...
}

錄製記錄

Fuchsia 上的 Rust 程式通常會使用 tracing Crate 巨集來記錄記錄。

GN 依附元件

將 tracing Crate 新增至 BUILD.gn 檔案的 deps 項目中：

deps = [
  "//third_party/rust_crates:tracing",
]

記錄事件

呼叫 tracing crate 提供的巨集，以記錄宣告的嚴重性等級的記錄：

use tracing;

fn main() {
    tracing::trace!("something happened: {}", 5); // maps to TRACE
    tracing::debug!("something happened: {}", 4); // maps to DEBUG
    tracing::info!("something happened: {}", 3);  // maps to INFO
    tracing::warn!("something happened: {}", 2);  // maps to WARN
    tracing::error!("something happened: {}", 1); // maps to ERROR
}

標準串流

println!、eprintln! 等 Rust 巨集會對應至標準輸出 (stdout) 和標準錯誤 (stderr)。如要使用這些串流，可能需要對您的程式進行額外設定。

詳情請參閱各種語言記錄說明文件中的「標準串流」一節。