Fuchsia 針對常見的國際化服務使用 ICU 程式庫,例如日期、時間、時區、語言代碼和語言處理。
ICU 程式庫大約由兩個不同部分組成:包含 ICU 演算法的 ICU 程式庫程式碼,以及 ICU 程式庫 data (包含專供獨立重複使用的語言代碼特定資訊)。
新增 ICU 程式庫依附元件
在 BUILD.gn
檔案中加入必要的程式庫依附元件:
C++
ICU 程式庫是單一第三方依附元件,做為 ${icu_root}:icu
使用
third_party_icu_headers("icu_headers") {
headers = [
"third_party/icu/source/common/unicode/locid.h",
"third_party/icu/source/common/unicode/ucnv.h",
"third_party/icu/source/common/unicode/unistr.h",
"third_party/icu/source/i18n/unicode/calendar.h",
"third_party/icu/source/i18n/unicode/gregocal.h",
"third_party/icu/source/i18n/unicode/smpdtfmt.h",
"third_party/icu/source/i18n/unicode/timezone.h",
"third_party/icu/source/i18n/unicode/tzfmt.h",
]
}
source_set("lib") {
sources = [
"intl_wisdom_client.cc",
"intl_wisdom_client.h",
]
public_deps = [
":icu_headers",
"//examples/intl/wisdom/fidl:wisdom_hlcpp",
"//sdk/lib/fidl/cpp",
"//sdk/lib/sys/cpp",
]
}
Rust
rust_icu
程式庫會細分為數個對應特定 ICU4C 標頭的 Crate:
deps += [
"//third_party/rust_crates:rust_icu_sys",
"//third_party/rust_crates:rust_icu_ucal",
"//third_party/rust_crates:rust_icu_udat",
"//third_party/rust_crates:rust_icu_uloc",
"//third_party/rust_crates:rust_icu_ustring",
]
non_rust_deps = [ "//src/lib/icu:lib" ]
匯入 ICU 標頭
針對程式所需的特定 ICU 程式庫功能新增匯入項目:
C++
ICU 說明文件提供程式庫支援的 API 相關額外資訊。
#include "examples/intl/wisdom/cpp/client/icu_headers.h"
Rust
rust_icu 參考資料提供程式庫支援的 API 額外資訊。
use {
anyhow::Error, fidl_fuchsia_examples_intl_wisdom as fwisdom, fidl_fuchsia_intl as fintl,
rust_icu_sys as usys, rust_icu_ucal as ucal, rust_icu_udat as udat, rust_icu_uloc as uloc,
rust_icu_ustring as ustring,
};
初始化 ICU 資料
在 Fuchsia 中,程式「必須」在執行階段載入 ICU 資料。使用 icu_data
程式庫初始化 ICU 資料:
C++
ZX_ASSERT(icu_data::Initialize() == ZX_OK);
Rust
// Force the loading of ICU data at the beginning of the program. Since
// Fuchsia's ICU does not have `libicudata.so`, we must load the data here
// so that locales could be used in the server.
let _loader = icu_data::Loader::new()?;
如要進一步瞭解如何從各種來源載入 ICU 資料,請參閱 ICU 時區資料。
您現在可以在 Fuchsia 程式中使用 ICU 程式庫功能了。