Flutter 2中MaterialApp不支持GetX的translations参数问题排查

你遇到的问题和Flutter版本无关，不需要升级到Flutter3。核心原因是：Flutter原生的MaterialApp本身就没有translations这个参数，这个参数是GetX框架封装的GetMaterialApp特有的配置项，直接给MaterialApp加这个参数自然会报错。

下面给你两种可行的解决方式：

方案一：使用GetMaterialApp替代MaterialApp（推荐，GetX官方用法） #

GetX提供了GetMaterialApp来替代原生MaterialApp，它内置了对GetX本地化、状态管理等功能的支持，直接就能使用translations参数：

@override
Widget build(BuildContext context) {
  SystemChrome.setPreferredOrientations([
    DeviceOrientation.portraitUp,
    DeviceOrientation.portraitDown,
  ]);
  return ScreenUtilInit(
    designSize: Size(411.429, 835.8095238095239),
    minTextAdapt: true,
    builder: (context, child) {
      return GetMaterialApp( // 替换为GetMaterialApp
        debugShowCheckedModeBanner: false,
        theme: ThemeData(
          textTheme: GoogleFonts.josefinSansTextTheme(Theme.of(context).textTheme),
          primaryColor: Colors.pinkAccent,
          primarySwatch: Colors.pink,
          visualDensity: VisualDensity.adaptivePlatformDensity,
        ),
        home: WillPopScope(
          onWillPop: () async => false,
          child: AppConfigPage(),
        ),
        locale: Get.deviceLocale,
        translations: MyLocale(), // 现在该参数合法
        fallbackLocale: const Locale('en', 'US'), // 建议添加：当设备语言无对应翻译时的 fallback
      );
    },
  );
}

方案二：继续使用原生MaterialApp，手动配置GetX本地化代理 #

如果不想替换MaterialApp，可以通过注册GetX本地化代理来实现功能：

1. 先在main函数中注册你的翻译类：

void main() {
  Get.put(MyLocale()); // 注册翻译类到GetX依赖管理
  runApp(const MyApp());
}

2. 修改MaterialApp的本地化配置：

return MaterialApp(
  debugShowCheckedModeBanner: false,
  theme: ThemeData(
    textTheme: GoogleFonts.josefinSansTextTheme(Theme.of(context).textTheme),
    primaryColor: Colors.pinkAccent,
    primarySwatch: Colors.pink,
    visualDensity: VisualDensity.adaptivePlatformDensity,
  ),
  home: WillPopScope(
    onWillPop: () async => false,
    child: AppConfigPage(),
  ),
  locale: Get.deviceLocale,
  localizationsDelegates: const [
    GetLocalizationsDelegate(), // GetX本地化代理
    GlobalMaterialLocalizations.delegate,
    GlobalWidgetsLocalizations.delegate,
    GlobalCupertinoLocalizations.delegate,
  ],
  supportedLocales: MyLocale().keys.keys.map((key) => Locale.fromSubtags(languageCode: key.split('_')[0], countryCode: key.split('_')[1])).toList(), // 映射翻译类中的支持语言
  fallbackLocale: const Locale('en', 'US'),
);

额外注意：确保MyLocale类结构正确 #

你的MyLocale类必须继承GetX的Translations接口，示例结构如下：

class MyLocale extends Translations {
  @override
  Map<String, Map<String, String>> get keys => {
        'en_US': {
          'welcome': 'Welcome',
          'setting': 'Settings',
        },
        'zh_CN': {
          'welcome': '欢迎',
          'setting': '设置',
        },
      };
}

内容的提问来源于stack exchange，提问作者Mark Nugromentry