soup_fonts

一个 Flutter 字体包，提供常用的高质量字体资源，方便在 Flutter 应用中使用。

📦 包含的字体

本包提供以下两个字体：

  • SourceHanSansCN-Regular.otf - 思源黑体 CN 常规版本

  • SourceHanSansCN-Bold.otf - 思源黑体 CN 粗体版本

🚀 快速开始-->

1. 添加依赖

在你的 Flutter 应用的 pubspec.yaml 文件中添加 soup_fonts 依赖：

Features


dependencies:

  flutter:

    sdk: flutter

  soup_fonts:

    path: ../soup_fonts

2. 声明字体资源## Usage

在应用的 pubspec.yaml 文件的 flutter 部分添加字体声明：


  fonts:

    - family: SourceHanSansCN```

      fonts:

        - asset: packages/soup_fonts/fonts/SourceHanSansCN-Regular.otf
        - asset: packages/soup_fonts/fonts/SourceHanSansCN-Bold.otf

          weight: 700

3. 使用字体

在你的 Flutter 代码中使用 TextStyle 来应用字体：

import 'package:flutter/material.dart';

void main() => runApp(const MyApp());

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Soup Fonts Demo',
      home: Scaffold(
        appBar: AppBar(title: const Text('Soup Fonts')),
        body: const Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              Text(
                '使用常规字体',
                style: TextStyle(
                  fontFamily: 'SourceHanSansCN',
                  fontSize: 20,
                  fontWeight: FontWeight.normal,
                ),
              ),
              SizedBox(height: 20),
              Text(
                '使用粗体字体',
                style: TextStyle(
                  fontFamily: 'SourceHanSansCN',
                  fontSize: 20,
                  fontWeight: FontWeight.bold,
                ),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

📖 详细使用指南

更多关于在 Flutter 中使用 Package 字体的信息，请参考 Flutter 官方文档。

常见用法

设置全局字体

在 MaterialApp 中设置默认字体：

MaterialApp(
  theme: ThemeData(
    fontFamily: 'SourceHanSansCN',
  ),
)

在特定文本中使用字体

Text(
  '这是一段使用 SourceHanSansCN 字体的文本',
  style: TextStyle(
    fontFamily: 'SourceHanSansCN',
    fontSize: 16,
    fontWeight: FontWeight.w700,  // 使用粗体
  ),
)

📋 系统要求

  • Flutter: >= 1.17.0
  • Dart: >= 3.8.1

📄 许可证

本项目遵循 LICENSE 文件中的许可证条款。

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📞 支持

如有问题或建议，请创建一个 Issue。

Libraries

soup_fonts