From 786976c6c0007cef256b5ffb39a4787f1a76c9f0 Mon Sep 17 00:00:00 2001 From: harshyadavDeveloper Date: Thu, 30 Apr 2026 15:44:19 +0530 Subject: [PATCH 1/4] docs: update service worker section in Web FAQ --- src/content/platform-integration/web/faq.md | 21 +++++++++------------ 1 file changed, 9 insertions(+), 12 deletions(-) diff --git a/src/content/platform-integration/web/faq.md b/src/content/platform-integration/web/faq.md index 9413ff3039d..f0acd2a0c26 100644 --- a/src/content/platform-integration/web/faq.md +++ b/src/content/platform-integration/web/faq.md @@ -206,21 +206,18 @@ you can configure your cache headers as follows, ### How do I configure a service worker? -The service worker generated by `flutter build web` is deprecated, -and you can disable it by setting the `--pwa-strategy` flag to `none` -when running the `flutter build web` command. +Flutter no longer generates or manages a service worker by default. -```console -flutter build web --pwa-strategy=none -``` +If your application requires offline support or advanced caching, +you need to configure a service worker yourself using standard +web tooling or third-party solutions such as [Workbox][workbox]. -If you would like to continue to use a service worker, you can -[build your own][using-service-workers] or try third-party tools -such as [Workbox][workbox]. +For more information on building custom service workers, see +[using-service-workers][]. -If your service worker is not refreshing, -configure your CDN and browser cache by setting -the `Cache-Control` header to a small value such as 0 or 60 seconds. +If your service worker is not refreshing, configure your CDN and +browser cache by setting the `Cache-Control` header to a small +value such as 0 or 60 seconds. [building a web app with Flutter]: /platform-integration/web/building [Creating responsive apps]: /ui/adaptive-responsive From 49e57d29c177a2bc6be6cac0d6aff8b0acdc5b28 Mon Sep 17 00:00:00 2001 From: Harsh Yadav Date: Sat, 2 May 2026 09:56:01 +0530 Subject: [PATCH 2/4] docs: remove remaining ios-ffi references to avoid broken links --- firebase.json | 1 - src/content/platform-integration/android/c-interop.md | 3 +-- src/content/platform-integration/macos/c-interop.md | 3 +-- 3 files changed, 2 insertions(+), 5 deletions(-) diff --git a/firebase.json b/firebase.json index 83ce1696302..56834621896 100644 --- a/firebase.json +++ b/firebase.json @@ -850,7 +850,6 @@ { "source": "/to/ios-create-flutter-engine", "destination": "/add-to-app/ios/add-flutter-screen#create-a-flutterengine", "type": 301 }, { "source": "/to/ios-deploy", "destination": "/deployment/ios", "type": 301 }, { "source": "/to/ios-development-team", "destination": "/deployment/ios#review-xcode-project-settings", "type": 301 }, - { "source": "/to/ios-ffi", "destination": "/platform-integration/ios/c-interop", "type": 301 }, { "source": "/to/ios-minimum-target", "destination": "/deployment/ios#review-xcode-project-settings", "type": 301 }, { "source": "/to/to/java-gradle-incompatibility", "destination": "/release/breaking-changes/android-java-gradle-migration-guide", "type": 301 }, { "source": "/to/java-gradle-incompatibility", "destination": "/release/breaking-changes/android-java-gradle-migration-guide", "type": 301 }, diff --git a/src/content/platform-integration/android/c-interop.md b/src/content/platform-integration/android/c-interop.md index ff52225d096..9dc5fe05e27 100644 --- a/src/content/platform-integration/android/c-interop.md +++ b/src/content/platform-integration/android/c-interop.md @@ -26,14 +26,13 @@ _native interface_ and _language bindings._ :::note This page describes using the `dart:ffi` library in Android apps. For information on iOS, see -[Binding to native iOS code using dart:ffi][ios-ffi]. +Binding to native iOS code using `dart:ffi`. For information in macOS, see [Binding to native macOS code using dart:ffi][macos-ffi]. This feature is not yet supported for web plugins. ::: -[ios-ffi]: /platform-integration/ios/c-interop [dart:ffi]: {{site.dart.api}}/dart-ffi/dart-ffi-library.html [macos-ffi]: /platform-integration/macos/c-interop [FFI]: https://en.wikipedia.org/wiki/Foreign_function_interface diff --git a/src/content/platform-integration/macos/c-interop.md b/src/content/platform-integration/macos/c-interop.md index a0e8d65d68d..6ede9a123f8 100644 --- a/src/content/platform-integration/macos/c-interop.md +++ b/src/content/platform-integration/macos/c-interop.md @@ -29,13 +29,12 @@ in macOS desktop apps. For information on Android, see [Binding to native Android code using dart:ffi][android-ffi]. For information on iOS, see -[Binding to native iOS code using dart:ffi][ios-ffi]. +Binding to native iOS code using `dart:ffi`. This feature is not yet supported for web plugins. ::: [android-ffi]: /platform-integration/android/c-interop -[ios-ffi]: /platform-integration/ios/c-interop [dart:ffi]: {{site.dart.api}}/dart-ffi/dart-ffi-library.html [FFI]: https://en.wikipedia.org/wiki/Foreign_function_interface From 68196f4f293a76ebd4df09c287d292cbd0c7b851 Mon Sep 17 00:00:00 2001 From: Parker Lougheed Date: Wed, 6 May 2026 21:57:22 +0200 Subject: [PATCH 3/4] Revert unrelated ffi doc changes This reverts commit 49e57d29c177a2bc6be6cac0d6aff8b0acdc5b28. --- firebase.json | 1 + .../docs/src/content/platform-integration/android/c-interop.md | 3 ++- sites/docs/src/content/platform-integration/macos/c-interop.md | 3 ++- 3 files changed, 5 insertions(+), 2 deletions(-) diff --git a/firebase.json b/firebase.json index 7687da89d69..856c9f28d31 100644 --- a/firebase.json +++ b/firebase.json @@ -852,6 +852,7 @@ { "source": "/to/ios-create-flutter-engine", "destination": "/add-to-app/ios/add-flutter-screen#create-a-flutterengine", "type": 301 }, { "source": "/to/ios-deploy", "destination": "/deployment/ios", "type": 301 }, { "source": "/to/ios-development-team", "destination": "/deployment/ios#review-xcode-project-settings", "type": 301 }, + { "source": "/to/ios-ffi", "destination": "/platform-integration/ios/c-interop", "type": 301 }, { "source": "/to/ios-minimum-target", "destination": "/deployment/ios#review-xcode-project-settings", "type": 301 }, { "source": "/to/to/java-gradle-incompatibility", "destination": "/release/breaking-changes/android-java-gradle-migration-guide", "type": 301 }, { "source": "/to/java-gradle-incompatibility", "destination": "/release/breaking-changes/android-java-gradle-migration-guide", "type": 301 }, diff --git a/sites/docs/src/content/platform-integration/android/c-interop.md b/sites/docs/src/content/platform-integration/android/c-interop.md index 9dc5fe05e27..ff52225d096 100644 --- a/sites/docs/src/content/platform-integration/android/c-interop.md +++ b/sites/docs/src/content/platform-integration/android/c-interop.md @@ -26,13 +26,14 @@ _native interface_ and _language bindings._ :::note This page describes using the `dart:ffi` library in Android apps. For information on iOS, see -Binding to native iOS code using `dart:ffi`. +[Binding to native iOS code using dart:ffi][ios-ffi]. For information in macOS, see [Binding to native macOS code using dart:ffi][macos-ffi]. This feature is not yet supported for web plugins. ::: +[ios-ffi]: /platform-integration/ios/c-interop [dart:ffi]: {{site.dart.api}}/dart-ffi/dart-ffi-library.html [macos-ffi]: /platform-integration/macos/c-interop [FFI]: https://en.wikipedia.org/wiki/Foreign_function_interface diff --git a/sites/docs/src/content/platform-integration/macos/c-interop.md b/sites/docs/src/content/platform-integration/macos/c-interop.md index 6ede9a123f8..a0e8d65d68d 100644 --- a/sites/docs/src/content/platform-integration/macos/c-interop.md +++ b/sites/docs/src/content/platform-integration/macos/c-interop.md @@ -29,12 +29,13 @@ in macOS desktop apps. For information on Android, see [Binding to native Android code using dart:ffi][android-ffi]. For information on iOS, see -Binding to native iOS code using `dart:ffi`. +[Binding to native iOS code using dart:ffi][ios-ffi]. This feature is not yet supported for web plugins. ::: [android-ffi]: /platform-integration/android/c-interop +[ios-ffi]: /platform-integration/ios/c-interop [dart:ffi]: {{site.dart.api}}/dart-ffi/dart-ffi-library.html [FFI]: https://en.wikipedia.org/wiki/Foreign_function_interface From 9647125987b836f79845d2b59961cf93a0df3577 Mon Sep 17 00:00:00 2001 From: Parker Lougheed Date: Wed, 6 May 2026 21:59:16 +0200 Subject: [PATCH 4/4] Apply review suggestion about Markdown link --- sites/docs/src/content/platform-integration/web/faq.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/sites/docs/src/content/platform-integration/web/faq.md b/sites/docs/src/content/platform-integration/web/faq.md index f0acd2a0c26..c911defd158 100644 --- a/sites/docs/src/content/platform-integration/web/faq.md +++ b/sites/docs/src/content/platform-integration/web/faq.md @@ -212,8 +212,8 @@ If your application requires offline support or advanced caching, you need to configure a service worker yourself using standard web tooling or third-party solutions such as [Workbox][workbox]. -For more information on building custom service workers, see -[using-service-workers][]. +For more information on building custom service workers, +check out [Using service workers][]. If your service worker is not refreshing, configure your CDN and browser cache by setting the `Cache-Control` header to a small @@ -232,7 +232,7 @@ value such as 0 or 60 seconds. [Preparing a web app for release]: /deployment/web [roadmap]: {{site.github}}/flutter/flutter/blob/master/docs/roadmap/Roadmap.md#web-platform [run your web apps in any supported browser]: /platform-integration/web/building#create-and-run -[using-service-workers]: https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API/Using_Service_Workers +[Using service workers]: https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API/Using_Service_Workers [Web content in Flutter]: /platform-integration/web/web-content-in-flutter [Web support for Flutter]: /platform-integration/web [web workers]: https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Using_web_workers