升级说明
运行要求
- Flutter 3.47.1 或更高版本;Dart 3.13.1 或更高版本且低于 Dart 4。
- Android API 24 或更高版本,compileSdk 37 或更高版本。示例应用使用 AGP 9.1.1、Gradle 9.3.1 和 Kotlin Gradle Plugin 2.3.20。AGP 需要 JDK 17 或更高版本。
- iOS 15 或更高版本。请使 Xcode 和 Podfile 的最低部署目标保持一致。示例应用包含 Flutter 的 UIScene 迁移和 Swift Package Manager 集成。请参阅 Flutter UIScene 迁移指南。
Android Gradle 设置
在稳定版 flutter_web_auth_2 仍应用 Kotlin Android 插件期间,请保留 android.builtInKotlin=false 和 android.newDsl=false。保留该插件,但将 android.kotlinOptions 替换为 kotlin.compilerOptions 来配置其 JVM 目标。未来的 Flutter 版本可能要求依赖项支持内置 Kotlin。
从 0.2.0-beta.2 升级
退出登录会撤销令牌
signOut 和 signOutAll 现在会先在服务器上撤销令牌,再将其从设备上删除。它们会发出网络请求,因此耗时可能长达请求超时时间。即使撤销失败或服务器不支持撤销,令牌仍会从设备上删除。
- 如需保留以前的行为,请传入
mode: SignOutMode.localOnly。 - 如需限制等待时间,请传入
timeout。 - Misskey 2026.9.0 之前的服务器不支持撤销。与以前一样,这些服务器上的令牌仍然有效。
请参阅退出登录。
新的返回类型
signOut 现在返回 Future<SignOutResult>,signOutAll 返回 Future<List<SignOutResult>>。仅对它们使用 await 的代码无需更改。实现或模拟 MisskeyAuthManager 的类必须更新方法签名:
Future<SignOutResult> signOut(
AccountKey key, {
SignOutMode mode = SignOutMode.revokeAndDelete,
Duration? timeout,
});
Future<List<SignOutResult>> signOutAll({
SignOutMode mode = SignOutMode.revokeAndDelete,
Duration? timeout,
});
升级到 0.2.0-beta.1
Android 用户必须重新登录
此版本将 flutter_secure_storage 从 9.x 升级到 11.x,不经过 10.x 的迁移。在 Android 上,使用旧默认设置加密的凭据无法直接迁移;用户必须为每个受影响的账号重新进行身份验证。
- 这是 Android 存储兼容性方面的破坏性变更,不代表 iOS 上也会发生相同的数据丢失。
- 宿主应用必须处理凭据缺失和存储空间错误。
- 删除本地凭据不会撤销服务器端令牌。
共享存储空间
默认的 SecureTokenStore 使用共享的默认存储空间。flutter_secure_storage 11 默认启用 resetOnError,因此恢复过程中也可能删除该存储空间中用于其他用途的值。如果与其他数据共享同一存储空间,请在升级前检查相关配置。请参阅 flutter_secure_storage 更新日志和令牌存储。
所有变更请参阅更新日志。