Gleap SDK Setup 是一个面向开发者的集成辅助技能，用于将 Gleap 客户反馈 SDK 接入各类项目。它通过自动检测平台、解析 API Key、引导安装与初始化，帮助用户快速完成 SDK 集成。
用途 该技能的核心用途是简化 Gleap SDK 的接入流程。它适用于需要集成客户反馈功能的项目，覆盖移动端、Web 前端和跨平台框架等多种技术栈。
主要能力
- 平台检测：按优先级扫描项目文件，自动识别目标平台。检测顺序为：pubspec.yaml（Flutter 或 FlutterFlow）、package.json（React Native、Ionic/Capacitor、Cordova、Angular、React、Vue、Next.js、Nuxt 或通用 npm）、Xcode 工程文件或 Podfile（iOS）、Gradle 文件（Android）、index.html（JavaScript CDN）、以及服务端 Web 框架（PHP/Laravel、Ruby on Rails、Python/Django/Flask、.NET/ASP.NET、Java/Spring Boot 等）。若无法检测，则询问用户目标平台。
- API Key 解析：按顺序从对话内容、项目根目录的 .env 文件（GLEAP_API_KEY）、环境变量中查找 API Key。若未找到，则提示用户从 Gleap 控制台获取。找到后可选择保存到 .env 并加入 .gitignore。
- 安装与初始化：运行脚本获取最新 SDK 版本，读取对应平台指南，引导用户安装依赖、添加初始化代码、配置平台权限或清单项，并建议构建运行以验证集成。
- 集成后 API 指导：提供常见任务说明，包括用户识别、事件追踪、自定义数据附加和小组件控制。
使用方式 技能按固定工作流执行：先获取最新 SDK 版本，再检测平台，解析 API Key，与用户确认平台，读取平台指南，安装 SDK，初始化，配置平台，最后验证。用户可明确指定平台以跳过检测。
适用场景 适用于需要将 Gleap 反馈 SDK 集成到 JavaScript、iOS、Android、React Native、Flutter、FlutterFlow、Ionic/Capacitor、Cordova 项目，或使用服务端 Web 框架的 Web 项目中。
限制与注意事项 initialize() 在应用生命周期中只能调用一次；跨平台框架需同时配置 iOS 和 Android 权限；JavaScript CDN 方式无需 npm；身份验证的用户哈希必须在服务端使用项目密钥生成；自定义数据仅支持原始值（字符串、数字、布尔值），最多 35 个键。常见问题包括 pod install 失败、Gradle 同步失败、Flutter 版本冲突、Web 端小组件不显示、软重载清除小组件以及 Android 硬件加速配置等。