Flutter应用在Android4.4~5.0设备启动报SIGILL错误崩溃如何解决？

Fatal signal 4 (SIGILL)为非法指令执行异常，仅发生在Android 4.4~5.0（API 19~21）设备的场景下，核心触发原因有两类：

• Flutter 3.16及以上版本默认开启的Impeller渲染器对Android 5.0以下老设备兼容不足，会调用老旧ARM芯片不支持的扩展指令
• 应用打包时仅适配了高版本armeabi-v7a指令集，未兼容Android 4.4时代大量低端设备使用的不支持neon扩展的ARMv5/ARMv6架构芯片

• 降级Flutter SDK至3.13.x稳定版重新打包运行，若崩溃消失即可确认是Impeller渲染器兼容问题
• 若降级后仍崩溃，检查android/app/build.gradle下的ndk abiFilters配置，确认是否仅配置了高版本架构

针对Impeller兼容问题 #

• 在AndroidManifest.xml的application节点下添加元数据，全局关闭Android端Impeller：

<meta-data
    android:name="io.flutter.embedding.android.ImpellerEnabled"
    android:value="false" />

• 若仅需要针对5.0以下设备关闭Impeller，可在Dart入口处做动态判断：

import 'package:device_info_plus/device_info_plus.dart';
import 'dart:io';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  if (Platform.isAndroid) {
    final androidInfo = await DeviceInfoPlugin().androidInfo;
    if (androidInfo.version.sdkInt <= 21) {
      ImpellerConfig.enabled = false;
    }
  }
  runApp(const MyApp());
}

针对指令集兼容问题 #

• 若应用需要覆盖Android 4.4及以上设备，在ndk abiFilters中补充老旧架构支持：

defaultConfig {
    ndk {
        abiFilters 'armeabi', 'armeabi-v7a'
    }
}

• 配置NDK编译参数关闭neon指令优化，适配无neon扩展的老旧芯片：

android {
    defaultConfig {
        externalNativeBuild {
            cmake {
                cppFlags "-mfloat-abi=softfp -mfpu=vfp"
                arguments "-DANDROID_ARM_NEON=OFF"
            }
        }
    }
}

内容的提问来源于stack exchange，提问作者Misha Kiva