使用Relay插件导入Figma UI包后Android视图中不可见

问题概述 #

使用Google Relay插件（版本0.3.10-hotfix）导入自定义Figma文件后，UI包实际存在于磁盘路径中，但Android视图里完全看不到。用官方提供的Figma文件和项目测试正常，自定义文件就出现该问题。已尝试删除后重新导入、点击顶层文件夹「从磁盘重新加载」，均无效果。

解决方法 #

• 检查Figma文件结构规范
  Relay对Figma文件的结构有严格要求，自定义文件可能不符合规则：

  • 确保所有要导入的组件都放在单独的Frame里，且Frame命名符合Android资源命名规则（仅允许小写字母、数字、下划线，不能有空格或特殊字符）
  • 排查Figma文件中是否有嵌套过深的组件、未命名图层，这类内容可能被Relay忽略
  • 确认组件未使用Relay不支持的属性（比如特殊动效、非标准布局）

• 验证项目配置正确性

  • 打开项目根目录的settings.gradle，确认Relay依赖配置与官方示例一致：

    plugins {
        id "com.google.relay" version "0.3.10-hotfix" apply false
    }
    

  • 检查模块的build.gradle，确认已应用Relay插件：

    plugins {
        id "com.android.application"
        id "com.google.relay"
    }
    

• 清理重建项目
  依次执行：

  1. 顶部菜单栏「Build」→「Clean Project」
  2. 完成后点击「Rebuild Project」
  3. 重启Android Studio后重新导入Figma文件

• 检查Android视图过滤设置

  • 点击Android视图右上角的漏斗图标，取消「Hide Empty Middle Packages」等可能隐藏UI包的过滤选项
  • 先切换到「Project」视图确认UI包路径，再回到Android视图手动展开对应路径查看

• 重置Android Studio缓存
  点击「File」→「Invalidate Caches...」，选择「Invalidate and Restart」，清除IDE缓存后重新导入

内容的提问来源于stack exchange，提问作者최제영