用途:本技能是 revyl-cli-auth-bypass 在识别出 Flutter 应用后的实现分支,提供应用代码层面的指引,属于测试专用认证绕过,并非 Revyl 的认证捷径。首次配置应从 revyl-cli-auth-bypass 开始,由其识别技术栈、套用共享安全约定后委派到本技能。
主要能力:定义统一深链形状 myapp://revyl-auth?token=<token>&role=<role>&redirect=<allowlisted-route>;用 Revyl 启动变量作为开关:revyl global launch-var create REVYL_AUTH_BYPASS_ENABLED=true 与 revyl global launch-var create REVYL_AUTH_BYPASS_TOKEN=<test-only-token>;在 Dart 入口处理初始与运行时深链,在 iOS/Android 原生壳注册 URL scheme/intent filter,通过平台通道或暂存后端把 REVYL_AUTH_BYPASS_* 暴露给 Dart,并在账号/调试页面展示接受或拒绝状态。
使用方式:Dart 侧可用现有深链库(示例用 app_links),校验 scheme、host、token、角色与重定向白名单后再调用应用的会话与路由。iOS 在 ios/Runner/Info.plist 的 CFBundleURLTypes 中加入 myapp;Android 在 AndroidManifest.xml 添加 scheme="myapp"、host="revyl-auth" 的 intent filter。原生读取 iOS 的 ProcessInfo.processInfo.arguments 或 Android 的 Intent extras。验证时用 revyl dev --no-build --launch-var 启动会话,再通过 revyl device navigate 与 revyl device screenshot 检查有效与拒绝链接。
适用场景与限制:仅在 debug/staging/test 构建加开关启用时用于测试会话;角色与重定向白名单要小且随应用定制,拒绝状态需在界面可见。禁止上线无条件生产绕过,禁止把原始令牌写入源码、YAML、截图或 PR。资料未提供具体 Revyl 版本与依赖要求。