パッケージ、リポジトリ、アプリカテゴリを検索

chinese_font_library のカバー
パッケージ詳細v1.3.0

chinese_font_library

中国語フォントのレンダリング用ヘルパー パッケージで、クロスプラットフォーム対応の中国語フォントファミリーフォールバックと動的フォントローダーを含みます。

AndroidiOSmacOSWindowsLinux
30日間ダウンロード
5630
いいね数
110
Pub ポイント
160

パッケージをインストール

flutter pub add chinese_font_library

パッケージ概要

公開情報に基づく選定ガイドです。参考としてご利用ください。

クロスプラットフォームでの中国語テキストのレンダリングを簡素化することを目的としたFlutterパッケージです。Android、iOS、macOS、Windows、Linuxで中国語文字を一貫して表示できるように、自動フォントファミリーフォールバックとダイナミックフォントローダーを提供しています。ライブラリはフォントの読み込みと選択を透明に処理し、開発者のセットアップの複雑さを軽減します。手動でのフォント設定なしで信頼性の高い中国語タイポグラフィが必要なアプリに最適です。

用途

  • クロスプラットフォームアプリで中国語テキストを表示する
  • 中国語文字のフォントフォールバックを自動化する
  • 実行時におけるカスタム中国語フォントの読み込み
  • 中国語コンテンツを含む多言語アプリのサポート
  • デバイス間で一貫した中国語のタイポグラフィを確保する

主な機能

  • クロスプラットフォーム対応の中国語フォントサポート
  • 自動フォントファミリーフォールバック
  • 動的フォントローダー
  • 最小限のセットアップが必要
  • すべての主要なデスクトップおよびモバイルプラットフォームをサポートしています

適している対象

  • 中国語話者をターゲットとしたアプリ
  • 信頼できる中国語テキストレンダリングが必要な開発者
  • 複雑な多言語要件を持つプロジェクト
  • プラットフォームの一貫性を重視するチーム
  • カスタムまたはシステム中国語フォントを使用するアプリケーション

注意事項

  • アセット内の適切なフォントファイルのインクルードが必要です
  • 埋め込みフォントによりアプリサイズが増加する可能性があります
  • Limited to Chinese character sets
  • 正しいアセットパスの構成に依存しています
  • 中国語以外のテキストレンダリングには対応していません

元の README

関連するソースリポジトリの README 原文のスナップショットです。最新の内容はリポジトリをご覧ください。

chinese_font_library

chinese_font_library 意在优化中文字体的跨平台渲染,目前支持:

  • 多字重的渲染
  • 动态加载字体

Sponsor

庞征博引 — 想学的,慢慢都会

本项目由 庞征博引 赞助:把复杂主题拆成一篇篇 5–10 分钟的阅读,边读边问,按自己的节奏慢慢学懂。

Requirements

chinese_font_library Flutter Dart
1.3.0 >=3.41.0 >=3.11.0
1.2.0 >=3.22.0 >=2.19.0

Flutter 3.41 起,框架会自动把 TextStyle.fontWeight 映射到可变字体的 wght 轴, 本包也随之改用 FontWeight.value,因此 FontWeight(550) 这类非整百字重不再被向下取整。

Install

dependencies:
  chinese_font_library: ^1.3.0

Features

多字重的渲染

Flutter 使用的系统默认字体多为西文字体,因此不同平台下的中文字体通常渲染为 normal 字重或 bold 字重,且 bold 字重为计算后得到的字重,并非原生 bold 字重,严重影响观感。

解决方案为使用 .useSystemChineseFont() 修改已有的 textStyle:

Text(
  '你好世界 hello world',
  style: const TextStyle(fontWeight: FontWeight.w100).useSystemChineseFont(),
)

或者使用 .useSystemChineseFont() 修改已有的 textTheme:

return MaterialApp(
  theme: ThemeData(
    textTheme: yourCustomTextTheme.useSystemChineseFont(Brightness.light),
  ),
);

也可以使用 .useSystemChineseFont() 修改已有的 themeData:

return MaterialApp(
  theme: yourCustomThemeData.useSystemChineseFont(Brightness.light),
);

动态加载字体

如果您不满足于系统内置的中文字体,想使用自己精选的中文字体,而中文字体通常体积较大,放在安装包中并非最佳选择。

解决方案为通过网络动态加载字体,仅需下载一次:

DynamicFont.url(
  fontFamily: 'CustomFontFromWeb',
  url:
      'https://raw.githubusercontent.com/LastMonopoly/chinese_font_library/master/example/assets/SmileySans-Oblique.ttf',
).load();

也支持从 asset 与本地文件加载:

DynamicFont.asset(fontFamily: 'CustomFont', key: 'assets/MyFont.ttf').load();
DynamicFont.file(fontFamily: 'CustomFont', filepath: '/path/to/MyFont.ttf').load();

Results

Font weights demo from multiple devices

Roadmap

如有任何意见或建议,请在 Github 上联系我。(❔ 表示尚未在真机上验证)

iOS 华为 鸿蒙 小米 miui macOS Windows Web html 荣耀 Vivo Oppo Linux
✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ❔

Reference

Flutter 小技巧之玩转字体渲染和问题修复

Contributions

LiTang0908

カテゴリー

依存関係

依存関係一覧 2 件

ソースリポジトリ

このパッケージを使用しているプロジェクト