阅读主题
兼容性与验收范围
这里列出代码和安装包的要求，不是覆盖所有浏览器、手机或游戏引擎的认证矩阵。
H5
| 项目 | 当前要求与说明 |
|---|---|
| 包格式 | ESM、CommonJS、浏览器 IIFE；IIFE 全局为 window.Starlight |
| 类型 | 安装包含独立 TypeScript 声明，无需安装内部共享类型工作区 |
| 运行能力 | 现代 ES2022、Fetch、Web Crypto、structuredClone；部分示例使用 AbortSignal 超时能力 |
| 安全上下文 | 登录依赖 HTTPS 或 localhost 等可信本地上下文 |
| UI | SDK 无界面、不依赖 React；React 演示单独适配 |
| 会话 | 默认内存；显式启用 sessionStorage 后支持同标签页刷新验证恢复 |
| 分发 | 提供本地 .tgz 和可自托管脚本，不承诺已发布公共 npm/CDN |
不同浏览器版本应在自己的支持列表实测。iframe 不会自动共享浮球、存储或界面层级；跨窗口通信必须校验来源和消息结构。移动浏览器横竖屏、键盘、安全区和触摸事件由宿主完成验收。
Android
| 项目 | 当前要求与说明 |
|---|---|
| 最低系统 | Android API 23 |
| 交付 | Java SDK 的 AAR、Manifest 与消费端混淆规则 |
| 构建 | 便携脚本使用 JDK 17 编译 Java 8 字节码；完整工程参考 API 35、Gradle 8.9 兼容工具链 |
| 权限 | SDK 使用网络权限，游戏内悬浮球不要求跨应用悬浮权限 |
| 生命周期 | 推荐每 Activity 创建 SDK，销毁时 destroy 并释放引用 |
| 验证状态 | AAR 与宿主 Java 编译通过；APK 安装、真机/模拟器运行尚需验收 |
原生界面与 H5 参考 UI 不完全同功能，例如 Android 当前未提供 H5 的完整忘记密码、改密页面。需要这些入口的游戏应评估扩展原生页面或受信任账号中心，不应按“安卓支持”推定界面完全一致。
使用模拟器访问本机 API 时，Android 模拟器主机地址通常为 10.0.2.2；真实设备需要受控网络或 USB 端口转发。正式环境使用有效证书的 HTTPS，不能忽略证书错误。
iOS
| 项目 | 当前要求与说明 |
|---|---|
| 最低系统/语言 | iOS 15+、Swift 5.9+ |
| 交付 | starlight-ios-sdk-0.2.1.zip，Swift Package 源码、测试和宿主示例；不是 XCFramework 或 IPA |
| UI | 无自动登录框、浮球或账号中心；由 UIKit/SwiftUI/引擎宿主提供 |
| 并发 | @MainActor 实例与 async/await；宿主负责任务生命周期与回调持有关系 |
| 会话 | 默认内存，可选 Keychain 候选；前台登录期间不恢复旧候选 |
| 网络 | 默认 HTTPS origin，开发 HTTP 需显式配置并完成宿主 ATS/本地网络处理 |
| 验证状态 | 源码交付；Xcode 编译、Swift 测试执行、模拟器/真机与 Keychain 待 Apple 工具链验证 |
当前工作环境为 Windows，源码检查不能证明 Apple 框架链接、签名、设备或 App Store 兼容性。Keychain 删除失败可能留下设备记录；当前 SDK 实例会阻止恢复，但重建实例仍须考虑残留凭据及服务端撤销状态。详见iOS 会话管理。
没有交付 Sign in with Apple 或 StoreKit。payDemoOrder/refundDemoOrder 仅调用本地演示业务，不能替代 Apple 内购、交易验证或退款。安装步骤见iOS 快速开始。
Windows
交付 net8.0 / netstandard2.1 托管 SDK、Windows 凭据管理器和本机授权回调。已执行本地 .NET 与协议测试，游戏全屏、多屏 DPI、实际安装器和 Unity IL2CPP 未验证。使用Windows 指南和四端矩阵确认边界。
游戏服务器
平台本地服务要求 Node.js 22.13 或更新版本。游戏服务器示例采用 Node.js，但任何能够正确实现 HTTPS、JSON、凭据保管和业务会话的服务端技术都可按协议对接；其他语言不代表已提供官方服务端 SDK。
新应用必须通过可信游戏服务器兑换授权码。开发者平台提供账号交换与本地业务验证，不会自动替代你的角色/存档后端或远端发货系统。
Unity 与 Cocos
本版交付 Unity UPM 与 Cocos TypeScript/native 插件，已执行核心编译和协议测试；尚未执行 Unity / Cocos 编辑器导出及设备验收。Android/iOS 门面随插件提供，需在自己的导出工程链接对应 SDK。Swift Package 单独安装不会自动完成引擎桥接。
至少记录引擎版本、构建模板、系统版本、屏幕方向、图形模式和实际 APK/网页构建版本，检查软键盘、返回键、旋转、恢复与重复回调。AAR 或 JavaScript 可被引用，不等于引擎即插即用。