Flutter本地化支持插件stream_chat_localizations的使用

官方本地化支持

官方本地化插件为Stream Chat Flutter库提供多语言支持。它允许开发者根据应用程序的语言环境自动或编程设置聊天组件显示的语言。

快速链接

• 注册获取Stream Chat API密钥
• Flutter Chat教程
• Chat UI Kit
• UI 文档

变更日志

查看pub.dev上的变更日志以了解该包的最新更改。

什么是本地化？

如果你的应用程序需要面向不同语言的用户，那么你需要对应用程序进行国际化（本地化）。这意味着你需要编写应用程序的方式使得它可以适应不同的语言或地区，例如文本和布局。更多关于本地化的信息，请参阅Flutter文档。

此插件允许你为Stream聊天组件提供本地化字符串。例如，根据应用的语言环境，Stream聊天组件将显示适当的语言。你可以基于系统偏好自动设置语言环境，也可以在应用程序中编程设置。插件支持多种语言，并且可以添加新的语言。

支持的语言

目前支持以下语言：

• 英语
• 印地语
• 意大利语
• 法语
• 西班牙语
• 加泰罗尼亚语
• 日语
• 韩语
• 葡萄牙语
• 德语
• 挪威语

更多语言将在未来添加。欢迎贡献以添加更多语言。

添加依赖项

在pubspec.yaml文件中添加以下内容，使用最新版本：

dependencies:
  stream_chat_localizations: ^latest_version

然后运行flutter packages get

使用示例

示例代码

以下是完整的示例代码，展示了如何使用stream_chat_localizations插件：

import 'package:flutter/material.dart';
import 'package:stream_chat_flutter/stream_chat_flutter.dart';
import 'package:stream_chat_localizations/stream_chat_localizations.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // 创建StreamChatClient实例
  final client = StreamChatClient(
    'your_api_key', // 替换为你的API密钥
    logLevel: Level.INFO,
  );

  // 设置当前用户并连接WebSocket
  await client.connectUser(
    User(id: 'super-band-9'),
    '''eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoic3VwZXItYmFuZC05In0.0L6lGoeLwkz0aZRUcpZKsvaXtNEDHBcezVTZ0oPq40A''',
  );

  // 创建频道
  final channel = client.channel('messaging', id: 'godevs');
  await channel.watch();

  runApp(
    MyApp(
      client: client,
      channel: channel,
    ),
  );
}

class MyApp extends StatelessWidget {
  const MyApp({
    super.key,
    required this.client,
    required this.channel,
  });

  final StreamChatClient client;
  final Channel channel;

  @override
  Widget build(BuildContext context) => MaterialApp(
        theme: ThemeData.light(),
        darkTheme: ThemeData.dark(),
        // 添加所有支持的语言环境
        supportedLocales: const [
          Locale('en'),
          Locale('hi'),
          Locale('fr'),
          Locale('it'),
          Locale('es'),
          Locale('ja'),
          Locale('ko'),
          Locale('pt'),
        ],
        // 添加GlobalStreamChatLocalizations.delegates
        localizationsDelegates: GlobalStreamChatLocalizations.delegates,
        // 程序化设置语言环境（这是一个全局更改）
        locale: const Locale('fr'),
        builder: (context, widget) => StreamChat(
          client: client,
          child: widget,
        ),
        home: StreamChannel(
          channel: channel,
          child: const ChannelPage(),
        ),
      );
}

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

  @override
  Widget build(BuildContext context) {
    return const Scaffold(
      appBar: StreamChannelHeader(),
      body: Column(
        children: <Widget>[
          Expanded(
            child: StreamMessageListView(),
          ),
          StreamMessageInput(),
        ],
      ),
    );
  }
}

添加新语言

要添加新语言，创建一个继承自GlobalStreamChatLocalizations的新类，并为其创建一个代理，将其添加到delegates数组中。参考这个示例。

覆盖现有语言

要覆盖现有语言，创建一个继承自特定语言类的新类，并为其创建一个代理，将其添加到delegates数组中。参考这个示例。

iOS注意事项

对于iOS，翻译功能需要在ios/Runner/Info.plist中添加支持的语言环境。具体步骤请参阅这里。

<key>CFBundleLocalizations</key>
<array>
  <string>en</string>
  <string>hi</string>
  <string>fr</string>
  <string>it</string>
  <string>es</string>
  <string>ca</string>
  <string>ja</string>
  <string>ko</string>
  <string>pt</string>
  <string>de</string>
  <string>no</string>
</array>

贡献

我们欢迎代码改进或修复问题的提交。请确保遵循最佳实践并在适用时添加测试。提交Pull Request之前，请先签署我们的贡献者许可协议（CLA）。

希望这些信息能帮助你更好地理解和使用stream_chat_localizations插件！如果有任何问题，欢迎随时提问。