SuperAPI AI 工具集

expo-gluestack-setup

前端与建站

查看项目

更新于 10-16 05:07

技能介绍

用途:在现有 Expo 或 React Native 项目中配置官方 gluestack-ui,可独立运行,也可作为 expo-scaffold 等新建项目脚手架流程中的专门步骤。仅在用户明确要求添加、配置、安装、修复或验证 gluestack-ui,或直接点名该技能,或被脚手架流程调用时触发;仅因消息提到 gluestack、NativeWind、Expo、启动失败或暗色模式不触发。

主要能力:检查项目根目录、包管理器与锁文件策略、Expo SDK/React Native/NativeWind/Tailwind/gluestack 版本、路由布局、UI 组件路径、provider 路径、tailwind/metro/babel 配置、全局 CSS 路径与 TypeScript 别名;确认 NativeWind 是否已配置;按版本参考执行 CLI 初始化与组件添加;修复 Tailwind content/theme、Metro 输入路径、Babel 别名、TypeScript 别名与锁文件等集成点;验证 provider 与组件导入可解析。

使用方式:先判断独立或编排模式,确认 NativeWind 前置条件,选择 gluestack 主版本与 CLI 路径(v3 使用 CLI 管理的 init/add 作为唯一官方路径,需先读 references/v3.md)。CLI 需要交互时暂停并给出确切命令、工作目录、提示选项与诊断,用户完成后继续。包安装策略:Expo SDK 包、React Native 包与原生模块用 Expo CLI;gluestack JS 包由 gluestack CLI 负责;Tailwind 工具与普通 JS 依赖用所选包管理器。

适用场景:现有项目的 gluestack 添加、修复、升级、验证,或脚手架交接。限制:不手写仿制组件或复制手动 provider 源码;不负责选择项目整体形态、创建新 Expo 应用、配置 EAS 或完整脚手架验证;编排模式下未经允许不得改布局或路由文件。结果状态包括 cli_initialized、user_init_required、user_add_required、components_added、blocked,并以 Gluestack Handoff 格式交接。具体版本兼容性、CLI 行为与验证标准需以当前官方文档和工具输出为准。