Skip to content

Commit ee68003

Browse files
committed
Mention more breaking changes in migration guide
1 parent 9173c3f commit ee68003

1 file changed

Lines changed: 12 additions & 4 deletions

File tree

flutter_web_auth_2/README.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -82,9 +82,17 @@ final accessToken = jsonDecode(response.body)['access_token'] as String;
8282

8383
**Note:** To use multiple scopes with Google, you need to encode them as a single string, separated by spaces. For example, `scope: 'email https://www.googleapis.com/auth/userinfo.profile'`. Here is [a list of all supported scopes](https://developers.google.com/identity/protocols/oauth2/scopes).
8484

85-
## Upgrading to `4.x`
85+
## Migration
8686

87-
Version `4.0.0` introduced a new approach for Linux and Windows to authenticate users - using
87+
### Upgrading to `4.x`
88+
89+
Generally, the following constraints have been added in version `4.0.0`:
90+
- Android embedding v1 support has been removed (it was deprecated already long ago)
91+
- Android min SDK and JVM version has been increased to 21 and 11, respectively (in accordance with
92+
Flutter `3.22.0`)
93+
- Migrated away from deprecated iOS and macOS functions (now iOS 17.4 and macOS 14.4 are required!)
94+
95+
Version `4.0.0` also introduced a new approach for Linux and Windows to authenticate users - using
8896
Webview APIs. Hence, you only need to change your code if you are targeting Linux or Windows.
8997
If you are fine with still using the old version, here is what you need to change:
9098
- Pass `useWebview: false` into the options of your call to `authenticate`, like so:
@@ -102,7 +110,7 @@ If you want to use the new approach (**default behaviour!**), you need to do a b
102110
- Make sure that your users know about the new requirements, as described
103111
[here](https://pub.dev/packages/desktop_webview_window)
104112
105-
## Upgrading to `3.x`
113+
### Upgrading to `3.x`
106114
107115
Version `3.0.0` featured a huge refactor which made it possible to maintain even more configuration
108116
possibilities. Even platform-specific ones! If you want to upgrade, you need to do the following:
@@ -118,7 +126,7 @@ possibilities. Even platform-specific ones! If you want to upgrade, you need to
118126
exactly the same. However, if you want the old behaviour using `preferEphemeral` on Android, use
119127
the `ephemeralIntentFlags` constant as value for `intentFlags`.
120128
121-
## Upgrading from `flutter_web_auth`
129+
### Upgrading from `flutter_web_auth`
122130
123131
If you used `flutter_web_auth` correctly (and without extra hackage) before, it should be sufficient to replace the following strings *everywhere* (yes, also in `AndroidManifest.xml` for example):
124132
- `FlutterWebAuth` -> `FlutterWebAuth2`

0 commit comments

Comments
 (0)