패키지, 저장소 및 앱 카테고리 검색

chinese_font_library 표지
패키지 상세v1.3.0

chinese_font_library

중국어 글꼴 렌더링을 위한 보조 패키지로, 크로스 플랫폼 중국어 글꼴 패밀리 백업 및 동적 글꼴 로더를 포함합니다.

AndroidiOSmacOSWindowsLinux
30일 다운로드
5.6천
좋아요
110
Pub 점수
160

패키지 설치

flutter pub add chinese_font_library

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

플랫폼 간 중국어 텍스트 렌더링을 단순화하기 위해 설계된 플러터 패키지입니다. 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 개

소스 저장소

이 패키지를 사용하는 프로젝트