luoyi_flutter_font 1.0.4

flutter dynamic load font, optimize chinese font render effect

优化flutter中文字体渲染问题，动态从网络加载字体

安装依赖

flutter pub add luoyi_flutter_font

初始化默认字体

• 更新main.dart

import 'package:flutter/material.dart';
import 'package:luoyi_flutter_font/luoyi_flutter_font.dart';

/// 简易状态管理，保存当前选择的字体
final ValueNotifier<String?> fontFamily = ValueNotifier<String?>(null);

/// 如果使用的是系统字体，它会保存当前平台合适的字族
List<String>? _fontFamilyFallback;

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 初始化字体，并指定谷歌中文字体为默认值，若不传则指定系统字体
  _fontFamilyFallback = await FlutterFont.init(FlutterFontModel.notoSansSC);
  fontFamily.value = FlutterFont.fontFamily;
  runApp(const _App());
}

class _App extends StatelessWidget {
  const _App();

  @override
  Widget build(BuildContext context) {
    return ValueListenableBuilder(
      valueListenable: fontFamily,
      builder: (context, value, child) {
        return MaterialApp(
          theme: ThemeData(
            fontFamily: value,
            fontFamilyFallback: _fontFamilyFallback,
            materialTapTargetSize: MaterialTapTargetSize.padded,
          ),
          home: const HomePage(),
        );
      },
    );
  }
}

• pubspec.yaml添加谷歌中文字体，这是裁剪后的谷歌 NotoSansSC 字体，包含常用的3500个中文汉字

flutter:
  uses-material-design: true
  fonts:
    - family: NotoSansSC
      fonts:
        - asset: packages/luoyi_flutter_font/fonts/NotoSansSC/NotoSansSC-Medium.ttf
        - asset: packages/luoyi_flutter_font/fonts/NotoSansSC/NotoSansSC-Bold.ttf

加载动态字体

void test() {
  // 调用loadFont函数动态加载字体，根据结果刷新页面状态
  // 加载系统字体
  bool result = FlutterFont.loadFont(FlutterFontModel.systemFont);
  if (result == true) {
    fontFamily.value = FlutterFont.fontFamily;
  }
  
  // 加载初始化时应用的字体
  FlutterFont.loadFont(FlutterFontModel.initialFont);
  
  // 加载谷歌 NotoSansSC 中文字体，需要引入
  FlutterFont.loadFont(FlutterFontModel.notoSansSC);

  // 加载资产包中的字体，不要定义 fontUrl 和 fontWeights
  FlutterFont.loadFont(FlutterFontModel(
    fontFamily: 'my_font',
  ));

  // 加载在线字体
  FlutterFont.loadFont(FlutterFontModel(
    fontFamily: 'LongCang',
    fontUrl: 'https://fonts.gstatic.com/s/a/f626a05f45d156332017025fc68902a92f57f51ac57bb4a79097ee7bb1a97352.ttf',
  ));

  // 加载多种字重在线字体
  FlutterFont.loadFont(FlutterFontModel(
    fontFamily: 'NotoSansSC',
    fontWeights: {
      400: 'https://fonts.gstatic.com/s/a/eacedb2999b6cd30457f3820f277842f0dfbb28152a246fca8161779a8945425.ttf',
      500: 'https://fonts.gstatic.com/s/a/5383032c8e54fc5fa09773ce16483f64d9cdb7d1f8e87073a556051eb60f8529.ttf',
      700: 'https://fonts.gstatic.com/s/a/a7a29b6d611205bb39b9a1a5c2be5a48416fbcbcfd7e6de98976e73ecb48720b.ttf',
    },
  ));
}

库中所有预设字体

以下字体配置已是测试出的最佳显示，均是裁剪后的字库

flutter:
  uses-material-design: true
  fonts:
    # 谷歌开源字体，可以商用
    - family: NotoSansSC
      fonts:
        - asset: packages/luoyi_flutter_font/fonts/NotoSansSC/NotoSansSC-Bold.ttf
        - asset: packages/luoyi_flutter_font/fonts/NotoSansSC/NotoSansSC-Medium.ttf
        - asset: packages/luoyi_flutter_font/fonts/NotoSansSC/NotoSansSC-Regular.ttf
    # 苹方字体，Apple下的设备可以商用
    # Medium字库可以渲染500、700两种字重，如果需要400字重请加上Regular字库
    - family: PingFang SC
      fonts:
        - asset: packages/luoyi_flutter_font/fonts/PingFangSC/PingFangSC-Medium.otf
        - asset: packages/luoyi_flutter_font/fonts/PingFangSC/PingFangSC-Regular.otf
    # 小米字体，可以商用
    # 小米源文件字体不能同时加载400、500字重，具体原因未知
    - family: MiSans
      fonts:
        - asset: packages/luoyi_flutter_font/fonts/MiSans/MiSans-Semibold.ttf
        - asset: packages/luoyi_flutter_font/fonts/MiSans/MiSans-Medium.ttf
    # 鸿蒙字体，可以商用
    - family: HarmonyOS Sans SC
      fonts:
        - asset: packages/luoyi_flutter_font/fonts/HarmonyOS/HarmonyOS-Bold.ttf
        - asset: packages/luoyi_flutter_font/fonts/HarmonyOS/HarmonyOS-Medium.ttf
        - asset: packages/luoyi_flutter_font/fonts/HarmonyOS/HarmonyOS-Regular.ttf