FluentUI.HarmonyOS.Assets 1.0.0

Fluent UI Text Fonts Assets NuGet Package

Font and icon assets for Fluent UI-style applications, distributed as source files in this repository and as a NuGet package.

This repository bundles high-quality CJK-friendly font families and an icon set so that apps can ship a polished, local-first typography experience without depending on external CDNs or network access at runtime.

What's Inside

Repository Layout

assets/
├── provider/     # Font & icon assets shipped in the NuGet package
│   ├── HarmonyOS_Sans* /
│   ├── MiSans* /
│   ├── OPPO_Sans_4.0 /
│   ├── AlibabaPuHuiTi-3-* /
│   └── HarmonyOS_Icons /
└── maple/        # Maple Mono family (updated via scripts/update_maple_font.ps1)
scripts/          # Maintenance scripts
nuget/            # NuGet packaging & publishing scripts

Usage

Reference the Assets Directly

The assets/ folder keeps the original directory layout, so you can point your app's font loader or build pipeline directly at it, e.g.:

assets/provider/HarmonyOS_Sans_SC/HarmonyOS_Sans_SC_Regular.ttf
assets/provider/MiSans/ttf/MiSans-Regular.ttf
assets/provider/MiSans/woff2/MiSans-Regular.woff2
assets/provider/HarmonyOS_Icons/ic_public_enlarge.svg
assets/maple/MapleMono-TTF/MapleMono-Regular.ttf

Install via NuGet

The provider assets are published as FluentUI.TextFonts.Assets. Add the package from nuget.org to get the fonts, icons, README and license bundled into your output:

dotnet add package FluentUI.TextFonts.Assets

The package installs the font files under assets/ in the consuming project, e.g.:

<Content Include="$(NuGetPackageRoot)\FluentUI.TextFonts.Assets\1.0.0\assets\HarmonyOS_Sans_SC\HarmonyOS_Sans_SC_Regular.ttf">
    <Link>Fonts\HarmonyOS_Sans_SC_Regular.ttf</Link>
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
</Content>

Note: the NuGet package contains the provider assets only. Maple Mono is kept in this repository under assets/maple/ and updated with the script below; reference it directly if you need it.

Maintenance

The scripts/ folder provides PowerShell helpers for keeping the assets up to date:

• update_maple_font.ps1 — Downloads and extracts the latest maple-font release with SHA256 checksum verification, atomic staging, and automatic use of the Windows system proxy. Re-running it skips the update when the local version already matches; the current version is recorded in assets/maple/.maple-font.version. Use -Version to pin a release tag or -Filter to fetch a subset.

  .\scripts\update_maple_font.ps1 -AssetsDir assets\maple   # update to the latest release
  .\scripts\update_maple_font.ps1 -AssetsDir assets\maple -Version v7.9
  

• normalize_asset_dirs.ps1 — Renames asset folders so spaces in directory names become underscores (e.g. MiSans Latin → MiSans_Latin), processing deepest directories first.

• clean_dsstore.ps1 — Recursively removes macOS .DS_Store files from the repository.

The nuget/ folder contains the packaging pipeline:

• nuget_pack.ps1 — Builds FluentUI.TextFonts.Assets.<version>.nupkg from Package.nuspec.
• nuget_push.ps1 — Publishes the .nupkg to nuget.org (asks for an API key, or pass -ApiKey).

License

Each font family is licensed by its respective owner; the full agreements are bundled in LICENSE.txt:

• HarmonyOS Sans & Icons — © 2021 Huawei Device Co., Ltd., under the HarmonyOS Sans Fonts License Agreement
• MiSans — Xiaomi Technology Co., Ltd., under the MiSans Font Intellectual Property License Agreement
• Maple Mono — © 2022 The Maple Mono Project Authors, under the SIL Open Font License 1.1
• OPPO Sans — © 2024 Guangdong OPPO Mobile Telecommunications Corp., Ltd., under the OPPO Sans Fonts License Agreement
• Alibaba PuHuiTi — © Alibaba (China) Co. Ltd., free for commercial and non-commercial use (see the bundled legal notice)

The license text is also embedded into the NuGet package (LICENSE.txt) so that redistribution obligations are carried along automatically.