使用Relay插件导入Figma UI包时缺失config.json及解码异常

错误1：config.json文件缺失 #

编译项目时出现路径错误：

/Users/oli/AndroidStudioProjects/RelayTest/app/src/main/ui-packages/text_elements/config.json (No such file or directory)

排查方向：

• 检查Figma导出的UI包：确认导出的压缩包内是否包含config.json，如果Figma端导出时遗漏，重新导出完整的UI包。
• 核对导入路径：确保导入时选择的目标目录是app/src/main/ui-packages/，若导入到了错误路径，手动移动UI包到正确目录，或重新导入选择正确路径。
• 插件版本bug：Relay 0.3.05属于早期版本，可能存在导入时文件丢失的问题，尝试重启Android Studio后重新导入。

错误2：JSON解码异常（未知key 'menu'） #

导入UI包后直接触发JSON解析错误，核心报错：

kotlinx.serialization.json.internal.JsonDecodingException: Unexpected JSON token at offset 632: Encountered an unknown key 'menu'.
Use 'ignoreUnknownKeys = true' in 'Json {}' builder to ignore unknown keys.

解决方法：

• 升级Relay插件：0.3.05版本存在字体配置解析的兼容性问题，在项目根目录的build.gradle中更新插件到最新稳定版，示例：

  id 'com.google.relay' version '最新稳定版本号'
  

• 手动修改字体配置：如果暂时无法升级，找到UI包中包含字体配置的JSON文件，删除其中的"menu"字段及其对应值，再重新导入。
• 检查Figma字体配置：确认Figma文件中使用的字体是否为Relay支持的类型，避免特殊字体配置导致导出的JSON包含插件不识别的字段。

内容的提问来源于stack exchange，提问作者olistocks98