用途:在 LaunchDarkly SDK 安装引导流程中,位于“检测仓库技术栈”之后、“应用代码改动”之前,负责根据检测结果选择正确的 SDK 并规划最小改动集。
主要能力:依据 SDK recipes 参考,将检测到的技术栈匹配到对应 SDK。关键决策包括:后端 API、服务端渲染应用、CLI 工具用服务端 SDK 与 SDK Key;浏览器 SPA(React、Vue、Angular、原生 JS)用客户端 SDK 与客户端 ID;iOS/Android 原生、React Native 用移动 SDK 与移动 Key;Flutter 应用目标用 Flutter 客户端 SDK 与移动 Key,Flutter web 用客户端 ID;Electron 用 Node.js 客户端 SDK;Cloudflare Workers、Vercel Edge、Lambda@Edge 用 Edge SDK;.NET 客户端(MAUI、Xamarin、WPF、UWP)用 .NET 移动 SDK;C/C++ 客户端用客户端 SDK,服务端用服务端 SDK;Haskell、Lua 服务端用对应服务端 SDK;Roku 用客户端 SDK。
双 SDK 集成:当用户同时要求服务端与客户端集成,或技术栈明显需要两个 SDK(如 Next.js 服务端评估加浏览器 UI 标志)时,需为两条轨道分别列出配方/片段名、精确包名、完整安装命令、依赖文件、入口文件、环境变量与初始化摘要;若无法说出两个包和两个入口点,则规划未完成。
规划内容:明确要修改的文件(依赖文件、入口文件、环境/配置文件,优先在集成根目录使用 .env 并确保其在 .gitignore 中,.env.example 只放占位符);每个 SDK 的代码改动(添加依赖、导入、初始化、通过环境变量配置凭据,绝不硬编码);环境变量约定(LAUNCHDARKLY_SDK_KEY、LAUNCHDARKLY_CLIENT_SIDE_ID 或带打包器前缀的客户端 ID、LAUNCHDARKLY_MOBILE_KEY)。
使用方式:先向用户展示计划摘要,采用非阻塞方式继续,除非用户反对;入口点不明确或可能适用多个 SDK 时,这些具体问题为阻塞项,需询问并等待回答。不要在计划确认阶段索要密钥。
限制:除 LaunchDarkly SDK 包外,未经用户明确批准不添加其他依赖,也不承诺升级无关依赖。