版本

Alpha v0.3.11(2024 年 1 月)

Relay v0.3.11 为 Figma 插件带来了性能方面的显著提升,尤其是在大型 Figma 文件中。无缝协作,因为您现在可以在 Figma 插件中即时查看其他人做出的实时更改。此外,我们还添加了对在行和列中滚动的支持。此版本还包含对 Figma 和 Android Studio 插件的一系列 bug 修复。

新功能

  • 提升了性能 - 享受快如闪电的性能,实现不间断的工作流。处理大型文件时,尤其要注意这一点。
  • 多人游戏修改 - 使用我们全新的多人游戏功能即时查看队友的变化。无需再手动刷新,也无需等待轮到您。Relay 现在支持在 Figma 中进行实时多人游戏协作。
  • Figma Scroll 属性 - Relay 现在支持在列上垂直滚动,在行上水平滚动。现在,滚动属性会沿用到生成的代码中。

bug 修复

  • Figma 插件

    • 修复了无法针对从嵌套实例公开的自定义参数设置值的问题。
    • 修复了当 Figma 中的变体名称无效时 Relay 插件出现错误的问题。
    • 修复了缺少标题的启动画面。
    • 修复了无法向具有图片填充的帧添加图片内容参数的问题。
    • 修复了以下问题:当参数添加到多个变体时,只有其中一个变体会显示在参数详情页面的“图层”部分中。现在,所有已绑定的变体都会显示。
    • 修正了以下问题:软件包可从开发者模式(一种只能查看的模式)中移除。
    • 修复了在开发者模式(一种只能查看的模式)下启用“与开发者分享”部分的问题。
  • Android Studio 插件和生成的代码

    • 当 Android Studio 导入失败时,Relay 现在会生成信息更丰富的错误消息。
    • 修复了 Relay 无法呈现界面软件包预览时会导致 IDE 错误的问题。
    • 修复了以数字开头的变体会生成错误代码的问题。
    • 修复了无法从 Figma 组件下载字体时显示的错误消息,提供更丰富的信息
    • 修复了横幅无法响应调整大小的问题。
    • 修复了以下问题:使用小写目标映射会导致在构建期间出现错误
    • 修复了在调用其他生成的可组合项时生成的代码有时不设置参数值的 bug。
    • Relay 现在支持 Gradle 配置缓存
    • 中继标头现在具有可访问的标签
    • 对 Android Studio 插件进行了常规稳定性改进

Alpha v0.3.10(2023 年 10 月)

Relay v0.3.10 在 Figma 和 Android Studio 插件中修复了几个 bug。

bug 修复

  • Figma 插件
    • Figma 插件现在会显示参数绑定到的所有变体。
    • 当 Figma 插件在开发者模式下打开时,或者没有要共享的软件包时,分享按钮将不再显示。
    • 在只读开发者模式下无法移除软件包。
    • 选择组件的父层后,系统将不再显示界面软件包详情。
    • 滚动时,错误和警告页面标题不再与列表重叠。
  • Android Studio
    • 在生成的代码中正确计算预览尺寸。

Alpha v0.3.09(2023 年 9 月)

Relay v0.3.09 实现了使用 Figma 插件创建界面软件包的演示,并添加了对同时打包多个 Figma 组件的支持。Figma 插件提升了性能,而 Android Studio 插件对映射工作流进行了改进。

此版本还包括与 Figma 参数以及 Android Studio 导入和构建错误有关的 bug 修复。

Android Studio 兼容性

  • Relay 现在需要 Android Studio Flamingo 或更高版本。如果您使用的是早期版本,请更新。
  • Relay 现在需要 Android Gradle 插件 8.0 或更高版本。请按照说明升级您的 Android Gradle 插件。

新功能

  • Figma 插件中有新的说明演示,旨在引导您完成在 Figma 文件中创建界面软件包的过程。
  • 使用 Figma 插件,您可以同时打包多个 Figma 组件。
  • 在 Android Studio 中,开发者可以在映射对话框中搜索要映射到界面软件包的可用可组合项。
  • 开发者可以使用映射对话框为界面软件包生成桩 @Composable 映射目标。
  • Figma 插件的性能已得到改进。对于大型文件,打开插件或更改选项的速度可提高多达 2 倍。
  • Relay Figma 插件会声明其网络访问政策。Relay 的社区页面会报告网络访问权限“受限”(而非“未知”)。

bug 修复

  • Figma 插件

    • 如果存在具有不同参数类型的重复参数名称,Figma 插件会正确检测和错误。
    • 修复了 Figma 插件根据画布选择从 Figma 画布窃取键盘焦点的问题。
  • Android Studio

    • 修复了导入操作发生在 Windows 上时,由于路径格式不同而导致在 Linux 和 macOS 上构建失败的问题。
    • 修复了组件在摘要或说明字段中仅包含数字时在 Android Studio 中导入失败的问题。
    • 修复了组件具有高度或宽度大小为 0 的预览图片时在 Android Studio 中导入失败的问题。
    • 修复了有时无法在 Windows 上的 Android Studio 中更新界面软件包的问题。
    • 修复了以下问题:如果提供了样式翻译文件,Android Studio 导入对话框会在导入时停止响应。
    • 修复了未向嵌套组件实例的自定义参数提供值时导入失败的问题。

Alpha v0.3.08(2023 年 7 月)

Relay v0.3.08 让使用映射组件变得更轻松。现在,您可以使用 Relay for Android Studio 插件界面在项目中生成和管理映射文件。此版本还修复了针对生成的代码质量和 SVG 渲染的多个 bug。

功能亮点

  • 我们添加了一个新对话框,用于在 Android Studio 中生成映射文件。借助此界面,您可以轻松设置和配置界面软件包的组件映射。

  • 您现在可以在 Android Studio 中的界面软件包详情视图中创建和打开软件包映射文件。

bug 修复

  • Figma 插件

    • 修复了无法正确报告重复图层错误的问题。
    • 添加了额外的界面增强功能以支持 Figma DevMode
  • Android Studio

    • 修复了 Relay 无法在 Windows 和 Linux 上正确构建的问题。
    • 修复了 SVG 渲染的几个问题。
    • 修复了 null 尺寸导致代码生成错误的问题。
    • 修复了在代码生成过程中无法正确识别 Images 的问题。

Alpha 0.3.07(2023 年 6 月)

Relay v0.3.07 为 Figma 配置会议上公布的新 Figma 开发者模式实现了界面支持。此版本还包含多个 bug 修复,能够进一步增强 Relay Figma 插件和 Android Studio 插件的性能、易用性和稳定性。

功能亮点

Figma 插件现在具有开发者模式界面;此界面直接与 Figma 的新开发者视图集成。

bug 修复

  • Figma 插件
    • 修复了激活“Create Relay Component”按钮后焦点不正确的问题。
    • 修复了在离开 Relay 标题后,按 Tab 键导航回 Relay 标题时出现的问题。
    • 现在,“Property”(属性)字段旁边的菜单弹出式按钮会以弹出式菜单(而不是可选文本)的形式正确读出。
    • 错误和警告链接现在可正确处理焦点。
    • 更新了错误页面界面。
  • Android Studio 插件
    • 可滚动区域已得到修复,具有无障碍名称,可清晰标识这些区域中的内容类型。这有助于屏幕阅读器用户了解他们是否想要与该区域进行进一步互动,而无需实际进入该区域。

Alpha 0.3.06(2023 年 4 月)

对于 Relay v0.3.06,我们专注于解决性能和易用性问题。变更包括界面易用性功能以及旨在简化导入界面组件软件包时的用户体验的改进。Compose 1.2 现在是 Relay 的最低要求版本。需要进行此更改才能使 Figma 和 Compose 对行高的解释保持一致。

功能亮点

我们更新了适用于 Figma 的 Relay 插件中的游乐场文件,在其中添加了新的练习和示例,以帮助设计人员熟悉 Relay 的使用。

备注

Compose 的新最低版本现在为 v1.2

bug 修复

  • 降低了 Figma 和 Compose 之间布局的不一致性,因为这两个应用对行高的解释不同。
    • Relay 现在需要 Compose 1.2 才能应用此修复。
  • 现在,Figma 插件上的“Fix it”按钮已正确放置。
  • Figma 插件现在只会检查当前页面上是否存在重复的软件包名称,而不会检查整个 Figma 文件。
  • 解决了 Figma 插件中的以下问题:启动时焦点不会移至应用的第一个元素。
  • 改进了屏幕阅读器和键盘用户在使用 Android Studio 插件导入界面软件包时的提示可访问性。
  • 提升了 Figma 插件的启动速度。
  • 解决了 Figma 插件的“Fix It”功能无法正确处理实心填充区域的问题。现在,它会将渐变的第一种颜色或黑色作为后备。
  • 解决了“导入界面软件包”文本无法传递给屏幕阅读器的问题。
  • 修复了极端情况,该问题会导致在使用 Android Studio 插件导入界面软件包期间出现虚假的“未找到文件”错误。
  • 修复了构建警告在 Android Studio 中无法正确显示的问题。

Alpha 0.3.05(2023 年 3 月)

新功能

  • 生成映射文件
    • 开发者现在可以在 Android Studio 中右键点击界面软件包,然后选择“Generate mapping file”以创建默认映射文件。此文件是一个起点,用户可通过修改此文件来设置自己的自定义组件映射。还会生成 README.md 文件,其中附有关于如何使用映射文件的说明。如果界面软件包已存在映射文件,上下文菜单中会显示“Open mapping file”。
    • 新增了三种自定义参数类型,以允许映射的组件在值发生更改时进行报告。
  • 在 Figma 插件的“Issues”页面中,设计人员可以对打包组件应用一键式修复程序,以实现无缝问题解决。此版本针对以下三个不同问题提供了解决方案:
    • 将填充中不受支持的渐变替换为纯色填充。
    • 将描边中不受支持的渐变替换为纯色填充。
    • 请移除不受支持的填充图片。

bug 修复

  • 生成的代码和翻译问题
    • 修复了 Figma 自动布局框架具有已定位子项(这些子项具有不透明或半透明背景)时会出现双背景的问题。
    • 修复了布尔值(显示/隐藏)组件属性在组件实例层上无法转换的问题。
    • 修复了点按操作器在生成的代码中响应缓慢的问题。
    • 修复了嵌套 Figma 组件中的互动处理程序未正确转换的问题。
    • 修复了嵌套组件无法接收正确的布局相关值和点按处理程序值的问题。
    • 修复了在多个 Relay 组件上使用点按回调的问题,在这种情况下,系统会使用错误的参数调用某些回调。
  • Android Studio 体验
    • 当样式转换文件发生更改时,Android Studio 现在会重新构建所有界面软件包。
    • 修复了由于缺少预览图片(例如发生网络错误)而导致导入失败的问题。
    • 在构建期间,Relay 现在会忽略空的 ui-packages 子文件夹。
    • 向 Android Studio 的 Android 视图中添加了 ui-package-resources 文件夹。
  • Figma 和 Figma 插件体验
    • 修复了组件存在的设计变体无法可靠地公开自定义参数的问题。
    • 修复了从组件中移除 Figma 插件打包后不会移除所有 Relay 元数据的问题。
    • 修复了未打包组件的 Figma 组件属性在添加到父组件后会自动显示在父组件中的问题。
  • 无障碍方面的改进
    • 修复了在 Android Studio 中导入期间“正在提取界面组件”消息对屏幕阅读器不可见的问题。
    • 使用 VoiceOver 时,“Set Figma Access Token”对话框现在会返回列表项。
    • Figma 插件中的只读输入字段现在具有不允许使用的光标,以指明其不可修改。

改进

  • Android Studio 插件现在会记住主题和样式转换信息,因此不需要在每次导入时都指定此信息。
  • 通过一起输出与某个操作关联的所有消息,提高了 Gradle 输出的可读性;以前,这些消息可以与来自其他操作的消息交错进行。此外,默认的日志记录级别现在是 INFO 而不是 LIFECYCLE
  • 生成的可组合函数现在包含所有参数的默认值。

Alpha 0.3.04(2023 年 2 月)

新功能

  • 我们改进了 Figma 插件中的“Share with developer”(与开发者分享)页面,让您可以搜索打包的组件上是否存在任何阻止问题。如果检查结果正确无误,您就可以从插件界面在版本记录中保存一个新条目,而无需任何麻烦!如需了解详情,请参阅共享界面软件包页面
  • Relay 现在支持 Figma 组件属性。Figma 组件属性与 Relay 参数非常相似;在适用的情况下,Relay 现在会将组件属性识别为其等效的参数,并扩展了对组件属性的支持,以处理没有等效参数的情况。如需了解详情,请参阅我们的 Figma 组件属性文档
  • Relay 实现中存在冲突的导入问题现已解决,因此 Jetpack Compose 应用现在可以在同一项目中同时使用 Relay 和 Material 3。

bug 修复

  • 改进了大型 Figma 文档中的 Figma for Relay 插件的性能。
  • 长层名称可在 Relay for Figma 插件中正确封装。
  • 已对 Android Studio 插件应用多项无障碍功能修复:
  • 永久性标签现已添加到 Android Studio 导入对话框中。
  • Android Studio 导入对话框中的横幅和组件图片添加了无障碍标签。
  • 修复了包含美元符号的文本内容的翻译。以前,这会导致构建错误。
  • 修复了提取没有命名版本的远程组件的问题:如果远程组件没有命名版本,系统会提取最新的远程组件。
  • 修复了顶级图层设置为具有绝对定位子项的自动布局的组件的转换。这之前会导致导入或构建错误。
  • 自定义参数允许修改“类型”(而不是“属性”),因为自定义参数不与图层属性相关联。
  • 修复了 Figma 界面中表示带有子参数的深层嵌套组件的问题。
  • 修复了具有子参数的深层嵌套组件可能无法导入的问题。

Alpha 0.3.02(2022 年 12 月)

bug 修复

  • 当设置为“hug”时,现在可以正确处理包含已确定位置子项的自动布局帧。
  • 现在可以在组件的根位置正确处理包含已确定位置子项的自动布局帧。

Alpha 0.3.01(2022 年 11 月)

Android Studio Electric Eel 现在支持 Android Studio 插件。

bug 修复

  • Windows:样式映射文件现在可以位于与 Android Studio 不同的驱动器上。之前这样阻止了导入操作。
  • 现在,仅当在 Figma 插件中选择了单个有效的界面软件包时,“Create UI Package”按钮才会启用。
  • 现在,使用较大字体(例如,AppleSystemUIFont 中的 16+)的用户在 Android Studio 插件的“Settings”对话框中不会再看到被截断的文本。
  • 现在,Android Studio 中的“Import UI Packages”菜单项始终处于启用状态,除非您的项目有多个模块,并且未选择任何文件,或所选文件不在任何模块中。
  • Figma 插件现在可以正确处理向使用变体并包含多个子组件实例的组件添加参数的操作。

Alpha 0.3.00(2022 年 10 月)

Android 开发者峰会 Alpha 版发布