NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #609 most downloaded on pub.dev
This plugin provides an abstraction around the Android and iOS AppAuth SDKs so it can be used to communicate with OAuth 2.0 and OpenID Connect providers
Latest stable
13.0.0
Last release 22 days ago
30 Oct 2026
Ships fairly regularly
a new release about every 6 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
8 years old
108 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
Breaking change updated minimum supported SDK version to Flutter 3.44.0/Dart 3.12.0
SFSafariViewController now throws an FlutterAppAuthUserCancelledException. Thanks to the PR from bshvets-amaYour coding agent can read these notes before it upgrades. Set up the MCP server →
[iOS] Breaking change minimum iOS version is now 15.0 to align with requirements of AppAuth iOS SDK 3.0.0
SFSafariViewController now throws an FlutterAppAuthUserCancelledException. Thanks to the PR from bshvets-amaBreaking change updated minimum supported SDK version to Flutter 3.44.0/Dart 3.12.0
[iOS] added custom browser support. Thanks to the PR from Kuurse
[iOS][macOS] improved SPM (Swift Package Manager) compatibility
Removed assertion around tied to idTokenHint and postLogoutRedirectUrl parameters passed to the EndSessionRequest constructor. This was done as both a
idTokenHint and postLogoutRedirectUrl parameters passed to the EndSessionRequest constructor. This was done as both are optional according to the OIDC RP-initiated logout specificationBreaking change updated minimum supported SDK version to Flutter 3.38.1/Dart 3.10. Consequently the minimum OS requirements for each platform has been…
Breaking change updated minimum supported SDK version to Flutter 3.38.1/Dart 3.10. Consequently the minimum OS requirements for each platform has been…
Potentiallu breaking change [Android] plugin will now throw a PlatformException with a null_activity error code when plugin runs into a scenario where…
Prompt class that exposes standard prompt string values as defined in the OIDC specification. Thanks to the PR from Valentin MichalakPlatformException with a null_activity error code when plugin runs into a scenario where the bound Flutter activity has been detached/disposed. Thanks to the PR from Sam CostaBreaking change updated minimum supported SDK version to Flutter 3.29/Dart 3.7
flutter_lints dev dependencycompileSdkVersion to 35 and AGP to 8.6.0[iOS][macOS] bumped AppAuth iOS dependency to 2.0.0
Breaking change updated minimum supported SDK version to Flutter 3.19/Dart 3.3
compileSdkVersion to 33 and AGP to 8.0.1 to align with what's used by the AppAuth Android SDKflutter_lints dev dependencyBreaking change updated minimum supported SDK version to Flutter 3.19/Dart 3.3
compileSdkVersion to 33 and AGP to 8.0.1 to align with what's used by the AppAuth Android SDKflutter_lints dev dependencyNothing published for this version
[iOS][macOS] bumped AppAuth iOS dependency to 1.7.6
Fixed issue 568 where compilation could fail with a 'OIDExternalUserAgent.h' file not found error
'OIDExternalUserAgent.h' file not found errorBreaking change Replaced the preferEphemeralSession property in the AuthorizationRequest, AuthorizationTokenRequest and EndSessionRequest classes with…
preferEphemeralSession property in the AuthorizationRequest, AuthorizationTokenRequest and EndSessionRequest classes with externalUserAgent. Thanks to the PR from john-slow. externalUserAgent is presented by the newly ExternalUserAgent enum that has the following values
asWebAuthenticationSession: uses the ASWebAuthenticationSession APIs where possible. This is the default value and was the default behaviour behaviour that aligns with what the AppAuth iOS SDK would do in choosing the best available user-agentephemeralAsWebAuthenticationSession: uses an ephemeral session via the ASWebAuthenticationSession APIs. Applications that previously used preferEphemeralSession and specified to be true can migrate by specifying this enum valuesfSafariViewController: uses the SFSafariViewController APIsallowInsecureConnections has been done in response to issue 554AuthorizationService have been disposedpreferEphemeralSession property in the AuthorizationRequest, AuthorizationTokenRequest and EndSessionRequest classes with externalUserAgent. Thanks to the PR from john-slow. externalUserAgent is presented by the newly ExternalUserAgent enum that has the following values
asWebAuthenticationSession: uses the ASWebAuthenticationSession APIs where possible. This is the default value and was the default behaviour behaviour that aligns with what the AppAuth iOS SDK would do in choosing the best available user-agentephemeralAsWebAuthenticationSession: uses an ephemeral session via the ASWebAuthenticationSession APIs. Applications that previously used preferEphemeralSession and specified to be true can migrate by specifying this enum valuesfSafariViewController: uses the SFSafariViewController APIsallowInsecureConnections has been done in response to issue 554AuthorizationService have been disposedFlutterAppAuthUserCancelledException when an authorization request has been cancelled as a result of the user closing the browser. For other scenarios the plugin will throw FlutterAppAuthPlatformException. See the API docs for both classes for more details on the available details. Both exception classes inherit from PlatformException so the changes should be backwards compatibleTheme.AppCompat.Translucent.NoTitleBar as the theme for the RedirectUriReceiverActivity from the AppAuth Android SDK. This is to fix a crash raised with issues #362 and #515authorize() or authorizeAndExchange(), rather than crashing the plugin will now throw a PlatformException with an error code of no_browser_available. Thanks to the PR from NikHomannPlatformException. Thanks to the PR from Johninit and to use initWithPresentingWindow via the AppAuth iOS/macOS SDK instead. Thanks to the PR from Ivan TivonenkoUpdated 8.0.0 as it was missing mention of the privacy manifest file to the macOS implementation of the plugin
[Android] some refactoring around code related to allowInsecureConnections has been done in response to issue 554
Includes changes from the 7.0.1 release
[iOS] Fixed issue 547 bug where specifying ExternalUserAgent.sfSafariViewController was using ephemeral session. Should now properly use the SFSafariV
ExternalUserAgent.sfSafariViewController was using ephemeral session. Should now properly use the SFSafariViewController APIsBreaking change Replaced the preferEphemeralSession property in the AuthorizationRequest, AuthorizationTokenRequest and EndSessionRequest classes with…
preferEphemeralSession property in the AuthorizationRequest, AuthorizationTokenRequest and EndSessionRequest classes with externalUserAgent. Thanks to the PR from john-slow. externalUserAgent is presented by the newly ExternalUserAgent enum that has the following values
asWebAuthenticationSession: uses the ASWebAuthenticationSession APIs where possible. This is the default value and was the default behaviour behaviour that aligns with what the AppAuth iOS SDK would do in choosing the best available user-agentephemeralAsWebAuthenticationSession: uses an ephemeral session via the ASWebAuthenticationSession APIs. Applications that previously used preferEphemeralSession and specified to be true can migrate by specifying this enum valuesfSafariViewController: uses the SFSafariViewController APIs[iOS] correctly bumped AppAuth iOS dependency to 1.7.5. The 7.0.0 release mistakenly only bumped the dependency for macOS
Breaking change Bumped minimum Flutter and Dart SDK constraints to 3.13.0 and 3.1.0 respectively
FlutterAppAuthUserCancelledException when an authorization request has been cancelled as a result of the user closing the browser. For other scenarios the plugin will throw FlutterAppAuthPlatformException. See the API docs for both classes for more details on the available details. Both exception classes inherit from PlatformException so the changes should be backwards compatibleFixed visibility of FlutterAppAuthOAuthError class so that it's exported by the plugin
FlutterAppAuthOAuthError class so that it's exported by the pluginBreaking change all methods have now been made to return non-nullable types
FlutterAppAuthOAuthError class that contains string constants representing OAuth 2.0 error codes defined by the specification.The errorUri property of the FlutterAppAuthPlatformErrorDetails class will now be populated on iOS/maCOS if available
errorUri property of the FlutterAppAuthPlatformErrorDetails class will now be populated on iOS/maCOS if availableBreaking change Bumped minimum Flutter and Dart SDK constraints to 3.13.0 and 3.1.0 respectively
FlutterAppAuthUserCancelledException when an authorization request has been cancelled as a result of the user closing the browser. For other scenarios the plugin will throw FlutterAppAuthPlatformException. See the API docs for both classes for more details on the available details. Both exception classes inherit from PlatformException so the changes should be backwards compatible.[Android] updated plugin to specify Theme.AppCompat.Translucent.NoTitleBar as the theme for the RedirectUriReceiverActivity from the AppAuth Android S
[iOS][macOS] bumped AppAuth iOS dependency to 1.7.4
[iOS] bumped AppAuth iOS dependency to 1.7.2
[Android] when no suitable browser is found when calling either authorize() or authorizeAndExchange(), rather than crashing the plugin will now throw
authorize() or authorizeAndExchange(), rather than crashing the plugin will now throw a PlatformException with an error code of no_browser_available. Thanks to the PR from NikHomann[Android] community has reported that there seem to be instances where the plugin encounters a null intent on some devices upon processing a end sessi
PlatformException. Thanks to the PR from John* [iOS] added privacy manifest
[macOS] fixed deprecation warning around using init and to use initWithPresentingWindow via the AppAuth iOS/macOS SDK instead. Thanks to the PR from I…
init and to use initWithPresentingWindow via the AppAuth iOS/macOS SDK instead. Thanks to the PR from Ivan Tivonenko[iOS] updated plugin so it supports apps that leverage the multiple window capability that Apple added to iOS 13. Thanks to the PR from Jerold Alberts
Potentially breaking change [iOS][macOS] bumped AppAuth dependency to 1.6.2 where fixes were done to allow SDK to compile in Xcode 14 by bumping the m…
Breaking change Bumped minimum Flutter SDK version to 3.0.0 and Dart SDK version to 2.17
compileSdkVersion to 31 (Android 12)flutter_appauth plugin has done this change ahead of timeflutter run command on the stable channel (i.e. Flutter version 3.7.1) to debug/run the app will in an error that says "package identifier or launch activity not found". However, an APK or app bundle can still be built and will run on a device. The Flutter team have already addressed this issue on the master channel that is currently on version 3.10.0-17.0.pre.21 so would expect the next stable release to contain the fix. Alternatively developers can manually restore the package identifier though this change was done to avoid issues from happening in the futureAdded comments to example app to explain how code challenge takes place per PKCE. Thanks to PR from Davide Ravasi
[iOS][macOS] bumped AppAuth dependency to 1.6.0
Added preferEphemeralSession to EndSessionRequest Thanks to the PR from Daniel Ziegler
preferEphemeralSession to EndSessionRequest Thanks to the PR from Daniel ZieglerAdded missing credit to 4.1.0 changelog entry
queries in AndroidManifest.xml as that is now handled directly with the AppAuth Android SDKAdded ability to specify the nonce as part of requests
nonce as part of requestsnonce as part of requests. Thanks to the PR from TiernanBumped AppAuth iOS dependency. Thanks to PR from Didier Prophete
Added support for macOS. Thanks to the PR from Jordy Langen
[iOS] fix nonce not being returned correctly on iOS
nonce not being returned correctly on iOSBreaking change AuthorizationResponse's constructor now includes nonce and has changed to take positional parameters
AuthorizationResponse's constructor now includes nonce and has changed to take positional parametersnonce can now be specified for TokenRequest class. This is especially useful on Android as the AppAuth Android SKD had turned on ID token validation that results in nonce mismatch errors. These errors should no longer appear when using the nonce value returned by the AuthorizationResponse object after calling authorize() and passing the value to the TokenRequest when calling the token() methodAdded const constructor to FlutterAppAuth
FlutterAppAuthExample app has been updated to point to the new demo IdentityServer instance
[iOS] fixed issue with scopes not being sent correctly as they should've been space-delimited instead of comma-delimited. Thanks to the PR from Angle
scopes not being sent correctly as they should've been space-delimited instead of comma-delimited. Thanks to the PR from Angle WangAdded scopes property to TokenResponse class and AuthorizationTokenResponse class that inherits from it. Thanks to PR from leoshusar
scopes property to TokenResponse class and AuthorizationTokenResponse class that inherits from it. Thanks to PR from leoshusar[Android] claims can now be passed as part of the additionalParameters included with requests without triggering an exception by the AppAuth Android S
claims can now be passed as part of the additionalParameters included with requests without triggering an exception by the AppAuth Android SDK. Thanks to the PR from Garry Jeromson[Android] updated error handling so more details are returned. Thanks to Andreas Kägi for originally starting on the PR
Fix grammar in 2.1.0 changelog entry
[Android] ui_locales can now be passed as part of the additionalParameters included with requests without triggering an exception by the AppAuth Andro
ui_locales can now be passed as part of the additionalParameters included with requests without triggering an exception by the AppAuth Android SDK. Thanks to the PR from dimitristozBreaking change AuthorizationServiceConfiguration constructor has changed to take named parameters
AuthorizationServiceConfiguration constructor has changed to take named parametersendSession() method, EndSessionRequest and EndSessionResponse classes to support end session requestsallowInsecureConnections is true. Thanks to the PR from Roman Fürst[iOS] Fixed issue where cancelling an end session request from dialog prompt prevented subsequent end session requests from working
Nothing published for this version
Includes changes from 1.1.0+1 release
[Android] skips https issuer check if allowInsecureConnections is true. Thanks to the PR from Roman Fürst
allowInsecureConnections is true. Thanks to the PR from Roman FürstOne column per quarter.