HXPhotoPicker 多语言文案自定义方案解析

项目背景

HXPhotoPicker 是一款功能强大的 iOS 照片选择器框架，广泛应用于需要图片选择功能的 iOS 应用中。在实际开发中，开发者经常需要根据产品需求自定义界面显示的文案内容。

文案自定义的实现方式

在 HXPhotoPicker 中，提供了两种主要的文案自定义方式：

1. 通过 TextManager 直接修改

最新推荐的方式是通过 HX.TextManager.shared 单例来修改文案内容。这种方式具有以下优点：

• 避免命名冲突
• 结构清晰，便于管理
• 支持链式调用

使用示例：

HX.TextManager.shared.picker.albumCameraRollTitle = .custom("我的相册")

2. 通过配置对象修改（即将废弃）

早期版本中可以通过 config.textManager 来修改文案，但这种方式将在未来版本中被移除，不建议新项目使用。

实际应用场景

在实际开发中，文案自定义通常用于以下场景：

1. 产品品牌一致性：将默认的"相册"改为符合产品调性的名称
2. 多语言支持：当框架内置语言不满足需求时，可以完全自定义
3. 特殊业务需求：根据业务场景调整提示文字

注意事项

1. 文案修改应在初始化照片选择器之前完成
2. 对于结构体类型的属性，不能直接修改，需要通过提供的接口
3. 建议在 App 启动时就完成所有文案的配置

最佳实践

推荐将文案配置集中管理，例如：

func setupPhotoPickerTexts() {
    let textManager = HX.TextManager.shared
    textManager.picker.albumCameraRollTitle = .custom("全部照片")
    textManager.picker.albumAllPhotosTitle = .custom("所有图片")
    textManager.picker.albumVideosTitle = .custom("视频集")
    // 其他文案配置...
}

然后在 App 启动时调用此方法，确保在使用照片选择器前文案已配置完成。

通过这种方式，开发者可以灵活控制 HXPhotoPicker 的显示文案，同时保持代码的整洁性和可维护性。