将 Flutter 添加到现有应用

如果你正在从头开始编写一个新应用，那么开始使用 Flutter 很容易。但是如果你已经有一个不是用 Flutter 编写的应用，并且从头开始不切实际，该怎么办呢？

对于这些情况，Flutter 可以作为一个模块，逐步集成到你现有的应用中。这个功能被称为“添加到应用”。该模块可以导入到你现有的应用中，使用 Flutter 渲染应用的一部分，而其余部分则可以使用现有技术渲染。这种方法还可以通过利用 Dart 的可移植性以及与其他语言的互操作性来运行共享的非 UI 逻辑。

添加到应用目前支持 Android、iOS 和 Web。

Flutter 支持两种添加到应用的方式

• 多引擎：支持 Android 和 iOS，允许运行一个或多个 Flutter 实例，每个实例将一个部件嵌入到宿主应用中并进行渲染。每个实例都是一个独立的 Dart 程序，与其他程序隔离运行。拥有多个 Flutter 实例允许每个实例维护独立的应用程序和 UI 状态，同时使用最少的内存资源。更多信息请参见多个 Flutter 实例页面。
• 多视图：支持 Web，允许创建多个 FlutterView，每个视图将一个部件嵌入到宿主应用中并进行渲染。在这种模式下，只有一个 Dart 程序，所有视图和部件都可以共享对象。

添加到应用支持集成任意大小的多个 Flutter 视图，支持各种用例。其中两个最常见的用例是

• 混合导航栈：一个应用由多个屏幕组成，其中一些由 Flutter 渲染，另一些由其他框架渲染。用户可以自由地从一个屏幕导航到另一个屏幕，无论使用哪种框架渲染屏幕。
• 局部屏幕视图：应用中的一个屏幕渲染多个部件，其中一些由 Flutter 渲染，另一些由其他框架渲染。用户可以自由滚动并与任何部件交互，无论使用哪种框架渲染该部件。

• 通过向你的 Gradle 脚本添加 Flutter SDK hook，自动构建和导入 Flutter 模块。
• 将你的 Flutter 模块构建为通用的 Android Archive (AAR)，以便集成到你自己的构建系统中，并更好地与 AndroidX 进行 Jetifier 互操作。
• FlutterEngine API 用于独立于附加 FlutterActivity/FlutterFragment 等来启动和持久化你的 Flutter 环境。
• Android Studio Android/Flutter 协同编辑以及模块创建/导入向导。
• 支持 Java 和 Kotlin 宿主应用。
• Flutter 模块可以使用 Flutter 插件与平台交互。
• 通过从 IDE 或命令行使用 flutter attach 连接到包含 Flutter 的应用，支持 Flutter 调试和有状态热重载。

• 通过在 CocoaPods 和 Xcode 构建阶段添加 Flutter SDK hook，自动构建和导入 Flutter 模块。
• 将你的 Flutter 模块构建成通用的 iOS Framework，以便集成到你自己的构建系统。
• FlutterEngine API 用于独立于附加 FlutterViewController 来启动和持久化你的 Flutter 环境。
• 支持 Objective-C 和 Swift 宿主应用。
• Flutter 模块可以使用 Flutter 插件与平台交互。
• 通过从 IDE 或命令行使用 flutter attach 连接到包含 Flutter 的应用，支持 Flutter 调试和有状态热重载。

请参阅我们的 add-to-app GitHub 示例仓库，获取 Android 和 iOS 中导入 Flutter 模块以实现 UI 的示例项目。

Flutter 可以添加到任何现有的基于 HTML DOM 的 Web 应用中，这些应用可以是任何客户端 Dart Web 框架（jaspr、ngdart、over_react 等）、任何客户端 JS 框架（React、Angular、Vue.js 等）、任何服务器端渲染框架（Django、Ruby on Rails、Apache Struts 等），甚至是没有框架（俗称“VanillaJS”）的应用。最低要求是你的现有应用程序及其框架支持导入 JavaScript 库，并创建 HTML 元素供 Flutter 渲染。

要将 Flutter 添加到现有应用，请正常构建它，然后遵循嵌入说明，将 Flutter 视图放置到页面上。

开始之前，请参阅我们的 Android 和 iOS 项目集成指南

将 Flutter 集成到你的项目后，请通过以下链接查看我们的 API 用法指南

移动端限制

• 不支持多视图模式（仅支持多引擎）。
• 不支持在应用程序中打包多个 Flutter 库。
• 不支持 FlutterPlugin 的插件如果它们做出在添加到应用中站不住脚的假设（例如假设 Flutter Activity 始终存在），则可能会出现意外行为。
• 在 Android 上，Flutter 模块仅支持 AndroidX 应用程序。

Web 限制

• 不支持多引擎模式（仅支持多视图）。
• 没有办法完全“关闭”Flutter 引擎。应用程序可以移除所有 FlutterView 对象，并确保使用正常的 Dart 概念进行所有数据垃圾回收。然而，即使引擎没有渲染任何东西，它也会保持预热状态。