Web 常见问题

Flutter 目前并非适用于所有的网页内容，不过我们主要关注三个应用场景：

• 渐进式 web 应用 (Progressive web apps, PWA)，兼具 web 的高覆盖面与桌面应用的强大功能。

• 单页应用 (Single page apps, SPA)，只需一次加载，并与互联网服务动态互传数据。

• 将现有 Flutter 移动应用拓展到 web，在两个平台共享代码。

现在阶段，Flutter 不适合具有丰富文本和瀑布流的页面。例如，博客文章等基于流媒体的丰富文本内容，其受益于网络构建的以文档为中心的模式，而不是像 Flutter 这样的 UI 框架可以提供的以应用为中心的服务。然而，你可以使用 Flutter 将交互式体验嵌入到这些网站中。

有关如何在 Web 上使用 Flutter 的更多信息，参考文档： Flutter 的 Web 支持。

一般情况下，Flutter Web 的目标是构建「动态化」网页应用。 Flutter 的 Web 端支持会优先考虑和确保性能、保真度和一致性。这意味着生成的网页页面可能不是搜索引擎「熟悉」的结构化页面。对于一些网页、文档内容，我们建议你使用 HTML 构建，就像我们为 flutter.dev、 dart.dev 以及 pub.dev 官网所做的那样。你还应该考虑将主要的类应用体验（使用 Flutter 构建的 Web 网页）与首页、营销内容以及帮助内容等（使用搜索引擎「熟悉」的 HTML 构建）进行分离，避免将它们混在一起。

That said, as mentioned in the roadmap, the Flutter team plans to investigate search engine indexability of Flutter web.

不能，但是可以使用热重启 (hot restart)。热重启是可以你的应用快速响应改动的方法，无需等待重新编译的载入。它与移动端的热重载功能类似。唯一的区别是热重载可以保持应用的状态。

现在 Flutter web 应用可以运行在以下浏览器中：

• Chrome（移动和桌面端）

• Safari（移动和桌面端）

• Edge（移动和桌面端）

• Firefox（移动和桌面端）

在开发阶段，Chrome（在 macOS、Windows 以及 Linux）以及 Edge（在 Windows 上）将作为默认浏览器用于调试。

你可以在 Android Studio/IntelliJ 和 VS Code 里选择使用 Chrome 或者 Edge 浏览器。

设备下拉列表里现在应该在所有平台里都包含了 Chrome (web)。

请参阅 创建响应式应用。

不行。文件系统在浏览器中是无法访问的。对于网络功能来说，请使用 http package。请注意，安全方面的工作有所不同，因为浏览器（而不是应用程序）控制 HTTP 请求上的标头。

部分插件需要在特定平台导入库或者文件，尤其是当使用浏览器无法访问的文件系统时。若要在你的应用里使用这些插件，请参阅 dart.cn： 选择性的导入。

Dart 通过 isolates 机制实现并发，目前在 Web 中尚未支持。

Flutter Web 没有内置并发的支持，但你可以尝试通过 web workers 来解决这个问题。

请参阅 打包并发布到 Web 平台。

目前还不行。

You might need to configure the Cache-Control header returned by your web server. For example, if this header is set to 3600, then the browser and CDN will cache the asset for 1 hour, and your users might see an out-of-date version of your app up to 1 hour after you deploy a new version. For more information about caching on the web, check out Prevent unnecessary network requests with the HTTP Cache.

It is a good idea to be aware of this behavior to avoid an undesirable user experience. After you deploy your app, users might use a cached version of your app (cached by the browser or CDN) for the duration defined by your cache headers. This can lead to users using a version of your app that is incompatible with changes that have been deployed to backend services.

If you wish to defeat these cache headers after each deployment, a common technique is to append a build ID of some sort to the links of your static resources, or update the filenames themselves. For example, logo.png might become logo.v123.png.

<!-- Option 1, append build ID as a query parameter in your links -->
<script src="flutter_bootstrap.js?v=123" async></script>

<!-- Option 2, update the filename and update your links -->
<script src="flutter_bootstrap.v123.js" async></script>

Flutter does not currently support appending build IDs to resources automatically.

If you are using Firebase Hosting, the shared cache (CDN) is invalidated when you deploy a new version of your app. But you might choose to configure your cache headers as follows, so that the browser cache doesn't cache application scripts, but the shared cache does.

{
  "hosting": {
    "headers": [
      {
        "source":
          "**/*.@(jpg|jpeg|gif|png|svg|webp|css|eot|otf|ttf|ttc|woff|woff2|font.css)",
        "headers": [
          {
            "key": "Cache-Control",
            "value": "max-age=3600,s-maxage=604800"
          }
        ]
      },
      {
        "source":
          "**/*.@(mjs|js|wasm|json)",
        "headers": [
          {
            "key": "Cache-Control",
            "value": "max-age=0,s-maxage=604800"
          }
        ]
      }
    ]
  }
}

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 build web --pwa-strategy=none

If you would like to continue to use a service worker, you can build your own or try third-party tools such as Workbox.

除非另有说明，本文档之所提及适用于 Flutter 的最新稳定版本，本页面最后更新时间: 2024-12-02。 查看文档源码 或者 为本页面内容提出建议。