iOS Widget如何使用本地目录中的动态自定义字体？

1. 是否需要为Widget单独注册字体？ #

需要。主应用和Widget扩展是独立的进程，CoreText通过CTFontManagerRegisterGraphicsFont注册的字体仅对当前进程生效，主应用的注册结果无法跨进程共享给Widget，因此必须在Widget进程内单独执行字体注册逻辑。

2. Widget生命周期中注册字体的最佳阶段 #

建议在Widget的TimelineProvider初始化时完成字体注册，确保在Widget渲染（比如getSnapshot、getTimeline方法执行前）字体已经可用。也可以在Widget结构体的静态初始化块中处理，但TimelineProvider的init更灵活，方便处理异步或错误情况。

示例代码：

struct WidgetProvider: TimelineProvider {
    init() {
        let fontManager = FontManager.shared
        // 从Widget Bundle中获取字体文件路径
        if let fontURL = Bundle(for: Self.self).url(forResource: "CustomFont", withExtension: "ttf") {
            let result = fontManager.loadFont(from: fontURL)
            switch result {
            case .success(let postScriptName):
                print("Widget注册字体成功：\(postScriptName)")
            case .failure(let error):
                print("Widget注册字体失败：\(error)")
            }
        }
    }

    // 实现TimelineProvider的其他方法
    func snapshot(with context: Context, completion: @escaping (SimpleEntry) -> Void) {
        // ...
    }

    func timeline(with context: Context, completion: @escaping (Timeline<Entry>) -> Void) {
        // ...
    }
}

3. Widget使用本地自定义字体的注意事项 #

• 字体文件可访问性：
  • 若字体是主应用本地目录的文件，需通过App Groups共享容器让Widget访问（主应用启动时将字体复制到共享目录）；
  • 更简单的方式是将字体文件同时添加到主应用和Widget扩展的Copy Bundle Resources构建阶段，确保Widget Bundle中包含字体文件。
• 注册时机提前：如果在渲染时才注册，可能导致首次渲染使用 fallback 字体，出现字体闪烁问题。
• 避免重复注册：复用现有FontManager中的registeredFonts集合逻辑，防止重复调用注册接口浪费资源。
• 内存限制：Widget的内存配额远低于主应用，避免一次性注册大量字体，按需注册所需字体即可。
• 错误处理：Widget进程可能被系统随时终止，注册失败时要做好日志记录，避免影响Widget正常渲染。

最优实现方案 #

1. 共享FontManager：将现有的FontManager移到一个共享框架中，让主应用和Widget扩展都依赖这个框架，避免代码重复。
2. 统一字体文件管理：
   • 方式一：将字体文件添加到共享框架的Copy Bundle Resources，主应用和Widget通过框架Bundle访问字体；
   • 方式二：使用App Groups，主应用启动时将字体复制到共享容器，Widget从共享容器读取并注册。
3. Widget侧注册逻辑：在TimelineProvider的初始化方法中调用FontManager的loadFont方法，确保渲染前完成注册。

现有FontManager的逻辑无需大幅修改，只需确保在Widget进程中初始化时，preloadRegisteredFonts能正确读取当前进程的可用字体。

内容的提问来源于stack exchange，提问作者Ranga Reddy