跳到主内容

从软件包导出字体

如何从包中导出字体。

你可以将字体声明为独立包的一部分,而不是将其声明为应用的一部分。这是一种在多个不同项目之间共享同一字体的便捷方式,也适合开发者向 pub.dev 发布自己的包。本指南包含以下步骤:

  1. 将字体添加到包中。
  2. 将包和字体添加到应用中。
  3. 使用字体。

1. 将字体添加到包中

#

要从包中导出字体,你需要将字体文件导入到该包项目的 lib 文件夹中。你可以将字体文件直接放在 lib 文件夹中,或放在子目录(例如 lib/fonts)中。

在此示例中,假设你有一个名为 awesome_package 的 Flutter 库,且字体位于 lib/fonts 文件夹中。

awesome_package/
  lib/
    awesome_package.dart
    fonts/
      Raleway-Regular.ttf
      Raleway-Italic.ttf

2. 将包和字体添加到应用中

#

现在,你可以通过更新应用根目录下的 pubspec.yaml 文件来使用该包中的字体。

将包添加到应用中

#

要将 awesome_package 添加为依赖项,请运行 flutter pub add

flutter pub add awesome_package

声明字体资源

#

导入包之后,需要告知 Flutter 到哪里查找 awesome_package 中的字体。

要声明包字体,请在字体路径前加上 packages/awesome_package 前缀。这会告知 Flutter 去该包的 lib 文件夹中查找字体。

yaml
flutter:
  fonts:
    - family: Raleway
      fonts:
        - asset: packages/awesome_package/fonts/Raleway-Regular.ttf
        - asset: packages/awesome_package/fonts/Raleway-Italic.ttf
          style: italic

3. 使用字体

#

使用 TextStyle 来更改文本外观。要使用包中的字体,请声明你想要使用的字体以及该字体所属的包。

dart
child: Text(
  'Using the Raleway font from the awesome_package',
  style: TextStyle(fontFamily: 'Raleway'),
),

完整示例

#

字体

#

Raleway 和 RobotoMono 字体下载自 Google Fonts

pubspec.yaml

#
yaml
name: package_fonts
description: An example of how to use package fonts with Flutter

dependencies:
  awesome_package:
  flutter:
    sdk: flutter

dev_dependencies:
  flutter_test:
    sdk: flutter

flutter:
  fonts:
    - family: Raleway
      fonts:
        - asset: packages/awesome_package/fonts/Raleway-Regular.ttf
        - asset: packages/awesome_package/fonts/Raleway-Italic.ttf
          style: italic
  uses-material-design: true

main.dart

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

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

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

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(title: 'Package Fonts', home: MyHomePage());
  }
}

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

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      // The AppBar uses the app-default font.
      appBar: AppBar(title: const Text('Package Fonts')),
      body: const Center(
        // This Text widget uses the Raleway font.
        child: Text(
          'Using the Raleway font from the awesome_package',
          style: TextStyle(fontFamily: 'Raleway'),
        ),
      ),
    );
  }
}

Package Fonts Demo