Update to oauth2 package README for Flutter Web info

dart-lang · Jan 10, 2025 · f7d91cd · f7d91cd
1 parent 54b8998
commit f7d91cd
Showing 1 changed file with 42 additions and 2 deletions.
diff --git a/pkgs/oauth2/README.md b/pkgs/oauth2/README.md
@@ -128,15 +128,16 @@ because different options exist for each platform.
 For Flutter apps, there's two popular approaches:
 
 1.  Launch a browser using [url_launcher][] and listen for a redirect using
-    [uni_links][].
+    [app_links][].
 
     ```dart
       if (await canLaunch(authorizationUrl.toString())) {
         await launch(authorizationUrl.toString()); }
 
       // ------- 8< -------
 
-      final linksStream = getLinksStream().listen((Uri uri) async {
+      final appLinks = AppLinks();
+      final linksStream = appLinks.uriLinkStream.listen((Uri uri) async {
        if (uri.toString().startsWith(redirectUrl)) {
          responseUrl = uri;
        }
@@ -161,6 +162,45 @@ For Flutter apps, there's two popular approaches:
       );
     ```
 
+
+For Flutter Web you would need to add a html file to the web folder with some additional JS code to
+handle the redirect back to the app (in this case the redirect URI should point to the html file, for example host/callback.html)
+
+    ```html
+        <html>
+        <body>
+        </body>
+        <script>
+            function findAndGetQueryParameter(parameterName) {
+                var result = null,
+                tmp = [];
+                location.search
+                    .substr(1)
+                    .split("&")
+                    .forEach(function (item) {
+                        tmp = item.split("=");
+                        if (tmp[0] === parameterName) result = decodeURIComponent(tmp[1]);
+                     });
+                return result;
+             }
+            let code = findAndGetQueryParameter('code');
+        
+            // Get Hostname
+            var url = window.location.href
+            var arr = url.split("/");
+            var currentUrl = arr[0] + "//" + arr[2]
+        
+            // Build new URL
+            let newUrl = currentUrl + "/#/callback?code=" + code;
+        
+            // Send to new URL
+            window.location.href = newUrl;
+        </script>
+        </html>
+    ```
+
+After redirect to the application the code can be extracted and processed.
+
 For Dart apps, the best approach depends on the available options for accessing
 a browser. In general, you'll need to launch the authorization URL through the
 client's browser and listen for the redirect URL.