CupertinoTabBar 需要 Localizations 父级

CupertinoTabBar 的实例在实例化时必须有一个 Localizations 父级，以便提供本地化的 Semantics 提示。尝试在没有 localizations 的情况下实例化 CupertinoTabBar 会导致断言，如下所示：

CupertinoTabBar requires a Localizations parent in order to provide an appropriate Semantics hint
for tab indexing. A CupertinoApp provides the DefaultCupertinoLocalizations, or you can
instantiate your own Localizations.
'package:flutter/src/cupertino/bottom_tab_bar.dart':
Failed assertion: line 213 pos 7: 'localizations != null'

为了支持本地化的语义信息，CupertinoTabBar 需要 localizations。

在此更改之前，提供给 CupertinoTabBar 的 Semantics 提示是一个硬编码的字符串“tab, $index of $total”。语义提示的内容也从最初的字符串更新为英语中的“Tab $index of $total”。

如果您的 CupertinoTabBar 位于 CupertinoApp 的作用域内，则 DefaultCupertinoLocalizations 已经被实例化，并且可能满足您的需求，而无需更改现有代码。

如果您的 CupertinoTabBar 不在 CupertinoApp 内，您可以使用 Localizations widget 提供您选择的 localizations。

如果您看到 'localizations != null' 断言错误，请确保正在为您的 CupertinoTabBar 提供 locale 信息。

迁移前的代码

dartimport 'package:flutter/cupertino.dart';

void main() => runApp(Foo());

class Foo extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MediaQuery(
      data: const MediaQueryData(),
      child: CupertinoTabBar(
        items: const <BottomNavigationBarItem>[
          BottomNavigationBarItem(
            icon: Icon(CupertinoIcons.add_circled),
            label: 'Tab 1',
          ),
          BottomNavigationBarItem(
            icon: Icon(CupertinoIcons.add_circled_solid),
            label: 'Tab 2',
          ),
        ],
        currentIndex: 1,
      ),
    );
  }
}

迁移后的代码（通过 CupertinoApp 提供 localizations）

dartimport 'package:flutter/cupertino.dart';

void main() => runApp(Foo());

class Foo extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return CupertinoApp(
      home: CupertinoTabBar(
        items: const <BottomNavigationBarItem>[
          BottomNavigationBarItem(
            icon: Icon(CupertinoIcons.add_circled),
            label: 'Tab 1',
          ),
          BottomNavigationBarItem(
            icon: Icon(CupertinoIcons.add_circled_solid),
            label: 'Tab 2',
          ),
        ],
        currentIndex: 1,
      ),
    );
  }
}

迁移后的代码（通过使用 Localizations widget 提供 localizations）

dartimport 'package:flutter/cupertino.dart';

void main() => runApp(Foo());

class Foo extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Localizations(
      locale: const Locale('en', 'US'),
      delegates: <LocalizationsDelegate<dynamic>>[
        DefaultWidgetsLocalizations.delegate,
        DefaultCupertinoLocalizations.delegate,
      ],
      child: MediaQuery(
        data: const MediaQueryData(),
        child: CupertinoTabBar(
          items: const <BottomNavigationBarItem>[
            BottomNavigationBarItem(
              icon: Icon(CupertinoIcons.add_circled),
              label: 'Tab 1',
            ),
            BottomNavigationBarItem(
              icon: Icon(CupertinoIcons.add_circled_solid),
              label: 'Tab 2',
            ),
          ],
          currentIndex: 1,
        ),
      ),
    );
  }
}

已发布版本：1.18.0-9.0.pre
稳定发布版本：1.20.0

API 文档

CupertinoTabBar 需要 Localizations 父级

概述

背景

迁移指南

时间线

参考资料