Skip to content

Release v8.1.2

Choose a tag to compare

@Hommy-master Hommy-master released this 28 Sep 03:12
· 57 commits to main since this release

概述

  • 桌面客户端下载草稿到本地时,此前会把素材的绝对路径写进草稿 JSON,导致草稿一旦移动或改名素材就断链,且路径能否对上取决于服务端的运行目录。本次把落盘前的素材路径统一归一化为剪映自身的相对路径写法,使下载到本地的草稿具备可移植性。
  • 改动范围仅限桌面客户端,服务端生成的草稿内容未作变动,仍由客户端在写入磁盘前完成归一化。

改动内容

  • 新增草稿路径工具模块,实现与剪映一致的相对路径写法:素材路径使用剪映的「草稿目录占位符前缀 + 草稿内相对路径」形式,不再写入绝对路径。
  • 路径归一化只针对确实位于草稿目录内的素材。远程 http 与 https 地址、以及指向草稿目录之外的路径均保持原样,避免破坏外部引用型草稿。
  • 依据素材路径的实际形态推断并写入素材保存模式:素材已收纳进草稿目录时记为「草稿内保存」,仍引用远程地址或草稿目录之外的资源时记为「外部引用」。该模式在远程素材下载完成后重新推断,修正了此前 URL 直写模式下服务端声明与实际落盘状态不一致的问题。
  • 草稿信息文件的本地化:草稿名改写为本地文件夹名,草稿目录与草稿根目录改写为本地路径并统一使用正斜杠,素材登记表中的文件路径同样只保留相对形式。这避免了服务端自身的目录结构随草稿下发到用户机器。
  • 素材根目录名收敛为单一常量,便于将来整体调整目录布局。
  • 占位符标识默认采用剪映内置的常量值,并支持通过环境变量覆盖,兼容不同版本剪映。
  • 新增 14 项单元测试,覆盖绝对路径与相对路径的判定、占位符改写与幂等性、远程地址与草稿目录外路径的放行、素材保存模式的推断,以及草稿信息文件的本地化。

收益

  • 下载到本地的草稿可以自由移动或改名,素材不再断链。
  • 不再依赖服务端运行目录的前缀匹配,非容器化部署同样可用。
  • 草稿中的素材保存模式与实际落盘状态保持一致,减少剪映将素材判为缺失而重新复制的可能。

兼容性说明

  • 服务端生成的草稿 JSON 仍写入绝对路径,由客户端在下载落盘前统一归一化,因此新旧服务端下发的草稿都能得到相对路径结果。
  • 素材仍放置在草稿目录下的 assets 子目录中,而剪映原生使用 Resources/local。占位符前缀的替换与目录名无关,播放解析路径必然成立,但该布局尚未在剪映中实测确认。

验证

  • 客户端单元测试 14 项全部通过。
  • 建议发布前用客户端真实下载一份草稿,在剪映中打开确认素材正常显示与播放。