wangyang
/
tencent_cloud_chat_uikit_flutter
1
0
Fork 0
Code Pull Requests Actions Releases Activity
tencent_cloud_chat_uikit_fl.../LOCAL_CHANGES.md

2.8 KiB
Raw Blame History

本地定制变更记录 (Local Custom Changes Log)

此文件用于记录本项目相对于官方 Upstream 代码的所有定制化修改。 每次修改源码或资源时，必须在此更新，以便后续维护人员清楚知道我们改了什么。

1. 资源定制 (Resource Customizations)

我们替换了官方的默认图标/图片，以符合项目 UI 风格。

路径 (Path) 说明 (Description) 保护策略 (Protection)
images/ 整个目录被替换为私有设计资源 High: 在 sync_from_upstream.sh 中被硬编码保护，合并时永远使用 Our Version。

2. UI/逻辑修改 (UI/Logic Modifications)

我们修改了部分源码以调整布局或逻辑。

lib/ui/widgets/video_screen.dart

  • 修改日期: 2026-01-05
  • 修改目的: 统一视频播放页的按钮样式，使其与图片浏览页一致。
  • 详细改动:
    • IconButton 被包裹在 48x48 的 SizedBox 中。
    • iconSize 调整为 30。
    • Positioned 底部距离从 20 调整为 50。
    • Positioned 左右距离从 20 调整为 10。

lib/ui/views/TIMUIKitChat/TIMUIKitTextField/tim_uikit_more_panel.dart 及相关 SVG

  • 修改日期: 2026-01-05
  • 修改目的: 完全使用官方 upstream 版本，避免本地定制导致的兼容性问题。
  • 详细改动:
    • 从 upstream/main 同步了 tim_uikit_more_panel.dart 的完整官方代码。
    • 从 upstream/main 同步了 images/photo.svg、images/screen.svg、images/file.svg 官方资源。
    • 移除了之前的所有本地修改（包括使用 images/svg/send_image.svg 等的尝试）。

lib/ui/views/TIMUIKitChat/tim_uikit_multi_select_panel.dart

  • 修改日期: 2026-01-06
  • 修改目的: 修复 Material 3 下多选面板图标按钮尺寸显示问题。
  • 详细改动:
    • 为所有 Image.asset 添加明确的 width 和 height 参数。
    • 桌面端（desktopWidget）图标设置为 30x30。
    • 移动端（defaultWidget）图标设置为 40x40。
    • 解决 IconButton 的 iconSize 参数对 Image.asset 不生效的 M3 兼容性问题。

scripts/sync_from_upstream.sh

  • 修改日期: 2026-01-05
  • 修改目的: 修复同步脚本的关键 bug，确保 images/ 真正被保护。
  • 详细改动:
    • 在合并前保存 master 的 commit hash (MASTER_BEFORE_MERGE)。
    • 在恢复保护路径时使用保存的 commit，而非 HEAD（HEAD 在合并后已被污染）。

3. 维护指南 (Maintenance Guide)

当您在 upstream-main (官方流) 之外修改了任何代码：

  1. 请务必在此文件中新增记录。
  2. 如果修改涉及新文件或新目录，请检查是否需要添加到 scripts/sync_from_upstream.sh 的 PROTECTED_PATHS 变量中。