HXPhotoPicker 编辑器工具栏自定义配置指南

前言

HXPhotoPicker 是一款功能强大的 iOS 图片和视频选择器库，在 4.2.1 版本中对编辑器工具栏的配置方式进行了调整。本文将详细介绍如何在新版本中自定义编辑器工具栏的功能项，帮助开发者根据实际需求灵活配置编辑功能。

工具栏配置变化

在 HXPhotoPicker 4.1.6 版本中，开发者可以通过 config.editor.toolsView.toolOptions 直接配置工具栏的功能项。而在 4.2.1 版本中，配置方式有所变化，但提供了更灵活的定制能力。

新版配置方法

基本配置方式

在新版本中，可以通过两种方式配置工具栏：

1. 全局修改图片资源：

HX.imageResource.editor.tools.text = .local("hx_editor_photo_tools_text")

2. 直接配置工具选项：

config.editor.toolsView.toolOptions = [
    .init(imageType: .local("hx_editor_photo_tools_text"), type: .text)
]

功能项定制

开发者可以根据实际需求选择性地添加或移除特定功能项。例如，如果不需要音乐功能，只需不在 toolOptions 数组中添加 .music 类型即可。

config.editor.toolsView.toolOptions = [
    .init(imageType: .local("hx_editor_tools_play"), type: .time),
    .init(imageType: .local("hx_editor_tools_graffiti"), type: .graffiti),
    .init(imageType: .local("hx_editor_photo_tools_emoji"), type: .chartlet),
    .init(imageType: .local("hx_editor_photo_tools_text"), type: .text),
    .init(imageType: .local("hx_editor_photo_crop"), type: .cropSize)
]

极简配置

如果只需要保留完成和取消按钮，可以完全清空 toolOptions 数组：

config.editor.toolsView.toolOptions = []

注意事项

1. 确保使用的图片资源名称与实际资源文件匹配
2. 不同版本间的配置方式可能有差异，升级时需注意检查
3. 过度简化功能可能会影响用户体验，需根据实际场景权衡

结语

HXPhotoPicker 4.2.1 版本提供了更灵活的编辑器工具栏配置方式，开发者可以根据应用需求自由定制编辑功能。通过合理配置，可以打造出既满足功能需求又不失简洁的图片/视频编辑体验。