跳到主要内容

升级说明

运行要求​

  • 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 更新日志和令牌存储。

所有变更请参阅更新日志。