UI 视觉设计 / 系统课时

发布团队库并检查引用升级

发布团队库并检查引用升级

共享设计库发布后,修改不会自动安全落到所有设计稿中。这里用一次按钮圆角升级演练,先整理命名和弃用信息,再在 Figma 中发布库更新,最后用独立消费文件审阅差异,确认组件实例与变量引用没有被意外破坏。

学习目标

  • 按组件命名、弃用标记和引用风险整理待发布内容。
  • 从 Figma 源文件发布团队库,并留下可供消费方判断的变更说明。
  • 在消费文件中逐项审阅更新,检查实例覆盖、主题颜色和布局回归。

发布前冻结变更范围

以下操作针对支持团队库发布的 Figma 付费计划;发布者需要源文件的编辑权限及 Full 席位。首次发布前,先把源文件从 Drafts 移入团队文件夹,并确保文件至少包含一个组件、样式或变量。

以 DS Core 库的一次改版为例,先写好变更台账:

资产 本次变更 消费文件需要检查的内容
Button 组件集 Hierarchy=Primary 的圆角从 8 px 调到 10 px 按钮高度、文本居中与自定义宽度
Button/Legacy 名称和描述标为 [Deprecated],指向 Button 老实例仍能用,新页面不再选旧组件
color/action/primary 保持变量名称及别名关系不变 Light、Dark 模式下填充颜色正确

组件集的变体属性名称应统一,例如都用 Hierarchy、State、Size,不要在同一库里混用 Type、Status 表示同一维度。要弃用旧资产时,先在名称和组件描述中注明替代项及迁移期限;不要直接删除主组件或复制重建来代替原主组件,以免失去既有实例的链接关系。

从源文件发布共享库

  1. 打开 DS Core 源文件,检查主组件、变量以及要发布的内容。
  2. 在左侧进入 Assets,点击 Libraries;在 This file 区域找到当前文件并点击 Publish。
  3. 审核待发布的组件、样式和变量。若使用 Organization 或 Enterprise 计划,按实际协作范围选择团队、组织或可用工作区,避免扩大可见范围。
  4. 填写有影响范围的说明,例如:“v1.3:Primary 按钮圆角 8→10 px;Legacy 标记弃用,替代项为 Button;请重点检查登录页和设置页。”然后点击 Publish。
  5. 返回库面板确认该批修改不再显示为待发布变更,并在文件版本历史中核对发布记录。

发布是源文件向消费方提供新版本,不等于强制替换所有设计稿里的实例。尤其是组件属性、变量别名、尺寸约束一起改动时,应让消费方先看差异,再决定何时接收。

在消费文件逐项审阅升级

  1. 新建一个独立的测试设计文件,在 Assets → Libraries 中找到 DS Core,选择 Add to file。将 Button 实例放在测试画板,分别准备默认态、禁用态、修改按钮文案和自定义宽度四个样本。
  2. 在源文件发布更改后,回到测试文件。左侧导航底部的 Libraries 图标出现蓝色标记时,点击 Review library updates,进入 Updates 标签;打开 Show updates for all pages,避免只检查当前页面。
  3. 选中 Button 的更新并进入 Review update。先用 Side by side 对照旧版和新版,再切换 Overlay 检查圆角与位置;确认无误后对单个实例使用 Update instance,而不是立即批量 Update all。
  4. 检查四个样本的文字覆盖、禁用状态、图标间距、Auto layout 和响应式宽度;如果库还修改了变量,切换 Light、Dark 模式核对按钮填充及文字对比度。全部通过后再对其余实例接收更新。

源文件发布与消费文件审阅更新的界面和数据流

判断异常并决定是否放行

测试现象 优先检查 修正动作
消费文件看不到更新 源文件是否完成 Publish、消费文件是否启用该库、是否引用了变化的资产 重新核对发布内容及库连接,刷新文件后再查 Updates
文字未随主组件变化 实例上的文本覆盖可能仍在生效 在该实例检查覆盖值;需要统一时再重置相应覆盖
深色模式颜色不对 语义变量的 Dark 模式映射或实例是否用了直接填色 修复别名或填充引用,重新发布并逐项验证
旧组件无法从资产面板新增 是否设为 Hide when publishing 或被删除 未完成迁移则恢复发布,明确替代组件与迁移日期

验收门槛可定为:四个测试实例全部检查通过,Light 与 Dark 两种模式均无颜色错误,登录页和设置页两处真实使用场景无布局溢出,且未完成迁移的旧组件仍可追溯。任一项失败,暂停批量更新,先修复源组件或消费文件中的覆盖配置。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

发布团队库并检查引用升级

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通