본문으로 건너뛰기

업그레이드

요구 사항​

  • Flutter 3.47.1 이상, Dart 3.13.1 이상 4.0 미만
  • 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를 유지하세요. 플러그인 적용은 유지하되 JVM 대상을 설정하는 코드를 android.kotlinOptions에서 kotlin.compilerOptions로 변경합니다. 향후 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에서는 다시 로그인해야 합니다​

이 버전에서는 10.x 마이그레이션을 거치지 않고 flutter_secure_storage를 9.x에서 11.x로 업그레이드합니다. Android에서는 이전 기본 암호화 방식으로 저장한 인증 정보를 직접 이전할 수 없으므로 해당 계정마다 다시 인증해야 합니다.

  • Android 저장 데이터 호환성에 관한 하위 호환성이 깨지는 변경입니다. iOS에서도 같은 데이터 손실이 발생한다는 뜻은 아닙니다.
  • 호스트 앱은 인증 정보 누락과 저장 영역 오류를 처리해야 합니다.
  • 기기의 인증 정보를 삭제해도 서버 측 토큰은 폐기되지 않습니다.

공유 저장 영역​

기본 SecureTokenStore는 공용 기본 저장 영역을 사용합니다. flutter_secure_storage 11에서는 resetOnError가 기본으로 활성화되어 있어 복구 과정에서 해당 영역의 다른 값도 삭제될 수 있습니다. 공유 저장 영역을 사용한다면 업그레이드 전에 설정을 확인하세요. flutter_secure_storage 변경 기록과 토큰 저장도 참조하세요.

모든 변경 사항은 변경 기록을 참조하세요.