如何确保Flutter中屏幕专属代码的摇树优化生效？

场景背景 #

开发嵌入式Linux Flutter应用，嵌入式环境对二进制体积要求极高，尤其是计量网络下的OTA更新场景。硬件采用固定尺寸屏幕（无旋转/尺寸变化），希望避免屏幕尺寸相关的条件判断，为每种尺寸单独编写页面代码，确保未使用的屏幕专属代码被摇树优化移除。当前方案是使用不同构建入口点：

构建命令：

flutter-elinux build elinux -t lib/main_7inch.dart --release
flutter-elinux build elinux -t lib/main_15inch.dart --release

每个入口文件main_XXinch.dart中定义：

typedef HomePage = XXInchDisplayHomePage;

void main() {
  runApp(const MyApp());
}

应用全局仅使用HomePage()实例化页面，现有三个疑问：

1. 该方案是否有助于摇树移除未使用的类？ #

是的，这个方案完全可以触发摇树优化移除未使用的类。

Flutter在Release模式下的摇树优化会遍历从入口点出发的所有代码引用链，未被任何引用链触及的代码会被标记为无用代码并从最终二进制中剔除。你的每个入口文件仅typedef对应尺寸的HomePage，其他尺寸的页面类（如15InchDisplayHomePage在7寸构建中）没有被入口或任何依赖代码引用，因此会被摇树优化彻底移除。

2. 是否有更优的方法确保构建仅包含必要的屏幕专属代码？ #

有几种更简洁的替代方案，适合不同复杂度的项目：

• 编译时常量+条件导入：
  无需维护多个入口文件，在单一入口中通过编译常量切换导入的页面：

  import 'home_pages/7inch_home.dart' 
      if (dart.library.define('SCREEN_SIZE', '7inch')) 'home_pages/15inch_home.dart';
  
  void main() {
    runApp(MyApp(homePage: HomePage()));
  }
  

  构建时通过--dart-define指定屏幕尺寸：

  flutter-elinux build elinux --release --dart-define=SCREEN_SIZE=7inch
  

  这种方式更集中，无需管理多个main文件。

• Flutter Flavor配置：
  在pubspec.yaml或构建配置中定义不同flavor（如7inch、15inch），每个flavor绑定对应的页面类。构建时指定flavor即可，适合需要多维度配置（除了屏幕尺寸还有其他差异）的项目。

对比你的多入口方案：多入口更简单直接，适合场景单一的项目；条件导入/flavors则更易于维护复杂项目的配置。

3. 如何验证未使用的代码确实被摇树优化移除？ #

可以通过以下几种方式验证：

• 对比构建产物大小：分别构建不同尺寸的版本，对比生成的ELF二进制文件大小。如果不同页面的代码量差异明显，产物大小会有对应差距，间接说明未使用代码被移除。
• 使用尺寸分析工具：
  运行带尺寸分析的构建命令：

  flutter-elinux build elinux --release --analyze-size
  

  命令会生成详细的尺寸分析报告（包含HTML格式），可以在报告中搜索未预期存在的类名，确认未使用的页面类是否被排除。
• 反编译二进制文件：
  使用objdump等工具反编译生成的ELF文件，搜索被认为应该被移除的类名（如15InchDisplayHomePage）：

  objdump -d build/elinux/release/bundle/my_app | grep "15InchDisplayHomePage"
  

  如果没有输出结果，说明该类的代码已被彻底移除。
• 查看构建日志：
  在Release构建时，Flutter会输出摇树优化相关的日志，可通过添加-v参数查看详细日志，确认未使用代码被标记为可移除。

内容的提问来源于stack exchange，提问作者Guilherme Ferreira