# flutter_intl_example

**Repository Path**: sunhacker/flutter_intl_example

## Basic Information

- **Project Name**: flutter_intl_example
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-03-31
- **Last Updated**: 2021-03-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 准备工作

## 搜索插件并安装 : Flutter Intl

![插件](http://pictures-upyun.test.upcdn.net/img/20200413204441591.png)

## 项目配置

添加依赖:

```
dev_dependencies:
...
  //add this
  flutter_localizations:
    sdk: flutter

```

在菜单栏的Tool下找到Flutter Intl 并选择Initalize for the project， 配置结束后效果如下：

![image-20200819233727693](http://pictures-upyun.test.upcdn.net/img/image-20200819233727693.png)

1. **会在 pubspec.yaml中增加以下字段**

```
flutter_intl:  
    enabled: true
```

2. **会在lib目录下增加 generated 和 l10n两个包**

![image-20200819234311852](http://pictures-upyun.test.upcdn.net/img/image-20200819234311852.png)

- generated包下的intl包默认存在一个**messages_all.dart**和**messages_en.dart**文件，messages开头的文件会在添加语言后自动生成
- l10n包下存在一个intl_en.arb文件

3. **使用`Add Locale`生成其他语言的arb文件**

   ![image-20200819234431082](http://pictures-upyun.test.upcdn.net/img/image-20200819234431082.png)

例如:zh_CN , 会在l10n包下生成Intl_zh_CN.arb文件 , 可在其中填入对应的文案.

4. **设置国际化语言**

```dart
return MaterialApp(
  ...
    localizationsDelegates: const [
      S.delegate,
      GlobalMaterialLocalizations.delegate,
      GlobalCupertinoLocalizations.delegate,
      GlobalWidgetsLocalizations.delegate
    ],
    supportedLocales: S.delegate.supportedLocales,
    localeListResolutionCallback: (locales, supportedLocales) {
      print(locales);
      return;
    },
  ...
);

```

5. 使用

在需要配置国际化的地方调用`S.of(context).key`即可.

没有`context` 时可以使用`S.current.key`

具体使用方式请参考[本项目](https://github.com/lizhuoyuan/flutter_intl_example)的代码

*注意 :*

1. 支持语言的顺序为字符串排序 (如zh_A会在zh_B之前) , 并非添加语言的顺序.
2. 假设系统语言为`zh_TW` , 项目并不支持,会优先寻找`zh`的其他语言 , 以`supportedLocales`顺序从上向下寻找.
3. 旧版本i18n插件生成的为`i18n`文件夹 , 而`flutter intl`生成的为`l10n` , 首字母不同 , 需要注意.
4. 此方式无需依赖`intl`包 , 但不提供`intl`相关功能. 需要额外功能才需要依赖`intl`.
5. 如不想弃用旧版intl的AS插件,但AS版本又不支持,可使用该插件生成的dart代码替代`i18n`中的代码,但可能需要修改类名.

### 从flutter i18n过渡
 1. 成功初始化之后，复制原有的arb文件到`l10n`文件夹下， 并修改名字 ，例如：intl_en.arb , intl_zh_CN.arb
 2. 将之前使用导入i18n.dart的地方替换成l10n.dart，一般只修改导入的头文件即可。
 3. flutter i18n中的带变量的写法为`${param}`,而flutter intl插件为`{param}`,要注意去掉$.


![language code](https://github.com/lizhuoyuan/flutter_intl_example/blob/master/intl.png)