在Flutter中如何基于单项目构建UI存在细微差异的多应用

这套场景不需要拆分多套代码仓库，依托Flutter原生的flavor机制和编译期绑定能力，就能高效产出仅UI存在差异的独立应用，整体配置逻辑如下：

一、入口层拆分，实现编译期UI绑定 #

摒弃项目默认的单main.dart入口结构，为每个目标应用单独创建独立入口文件，通过编译期的代码绑定替代运行时的逻辑判断，从根源上避免冗余代码进安装包：

• 为每个首页变体创建对应的入口文件，例如main_home1.dart、main_home2.dart、main_home3.dart
• 在入口文件中直接导入对应版本的首页组件，注入到通用App容器中，参考示例代码：

// main_home1.dart 代码示例
import 'package:flutter/material.dart';
import 'app.dart';
import 'pages/home/variants/home1.dart' as home_impl;

void main() {
  runApp(
    App(
      homeBuilder: home_impl.HomePage.new,
      appMeta: const AppMeta(
        appName: "首页版本1应用",
      ),
    )
  );
}

• 通用App容器（也就是项目里的根MaterialApp所在组件）不硬编码首页实现，而是接收入口传入的首页构造函数作为参数，实现通用框架和变体UI的解耦。

二、UI变体的目录组织与解耦 #

• 统一所有首页变体的接口约定：不管是home1、home2、home3版本，都继承同一个抽象基类，保证通用App容器可以无差别加载，不需要做特殊适配：

abstract class BaseHomePage extends StatelessWidget {
  const BaseHomePage({super.key});
}

• 每个变体的UI实现放在独立的目录下，例如lib/pages/home/variants/路径下的home1.dart、home2.dart、home3.dart，所有文件内的UI逻辑独立编写，互相之间没有依赖，调整某一个版本的UI不会影响其他版本的编译结果。
• 把所有跨变体通用的业务逻辑（例如接口请求、状态管理、事件处理）下沉到公共代码层，所有变体的UI直接调用公共能力，避免重复编写相同逻辑带来的维护成本。

三、平台端独立打包配置 #

要让不同变体的应用成为可以独立安装、独立上架的独立应用，需要分别在Android、iOS平台配置对应的产品变体：

• Android端：在android/app/build.gradle中配置对应的productFlavors，为每个变体设置独立的applicationId、应用名称、启动图标资源，参考配置片段：

android {
    flavorDimensions "appVariant"
    productFlavors {
        home1 {
            dimension "appVariant"
            applicationId "com.example.app.home1"
            resValue "string", "app_name", "首页版本1应用"
        }
        home2 {
            dimension "appVariant"
            applicationId "com.example.app.home2"
            resValue "string", "app_name", "首页版本2应用"
        }
    }
}

• iOS端：在Xcode项目中配置对应命名的Scheme，每个Scheme关联对应的入口dart文件，设置独立的Bundle Identifier、应用显示名、图标资源，实现和Android端一致的独立安装、独立更新的效果，避免不同变体的应用安装时互相覆盖。

四、日常开发与打包流程 #

• 开发调试阶段：在IDE中配置多个调试启动任务，分别指向不同的入口文件，一键切换启动对应变体的应用，不需要手动修改源码。
• 正式打包阶段：直接执行对应flavor的打包命令即可，例如打包home1版本的release APK，执行命令flutter build apk --flavor home1 -t lib/main_home1.dart，全程不需要调整任何业务代码。

关键注意点：不要用运行时参数判断的方式加载不同首页（例如读全局配置选择加载哪个UI），这种方式会把所有变体的UI代码都打进安装包，导致包体积异常增大。采用编译期绑定的方式，每个打包产物只会包含对应变体的UI代码，最终包体积和单独开发的原生应用没有差异。

内容的提问来源于stack exchange，提问作者Suraj Gupta