Flutter本地化(国际化)之App名称

文章目录

Flutter开发的App,如果名称想要跟随着系统的语言自动改变,则必须同时配置Android和IOS原生。

Android国际化

  1. 打开android\app\src\main\res\values

  2. 创建strings.xml
    在values上右键,选择New>Values Resource File

    在新窗口中输入文件名strings.xml

    strings.xml文件中,输入以下内容

    xml 复制代码
    <?xml version="1.0" encoding="utf-8"?>
    <resources>
    <!--    appName是key,后面的值就是本地化实际的名称-->
        <string name="appName">App name default locale</string>
    </resources>
  3. 创建多个语言的strings.xml
    在res目录上右键,选择New>Android Resource Directory

    左侧Available Qualifiers选择Locale,点击中间的右箭头,然后在右边选择需要国际化的语言和地区,点击OK.

    会自动创建values前缀的文件夹,将之前的strings.xml复制进去.

    然后将值修改成对应语言.
    这里推荐使用Android Studio自带的国际化编辑器Translations Editor,在strings.xml的右上角,点击Open editor打开。

    在国际化编辑器,可以很方便地修改每一种语言定义的值,这样就不需要打开多个string.xml来修改了。

  4. 引用多语言的key
    打开Manifest.xml,将label的值替换为我们定义的资源id,引用方式为@string/id名

xml 复制代码
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  package="com.example.flutter_app">
 <application
    android:label="@string/appName"
    android:name="${applicationName}"
    android:icon="@mipmap/ic_launcher">
      <!-- 其他省略... -->
  </application>
</manifest>

Android官方推荐资源的key命名方式全部小写,单词之间以下划线分开,例如app_name

最后重新运行App,当系统语言切换时,App的名称也会跟着改变。

当然了,如果切换的语言是不被App支持,会以默认的values文件下的资源值为主。

IOS国际化

  1. 首先要添加支持的语言。默认是en(英语)。如果已经设置过了,请看下一步。

    如果要设置其他语言为默认语言,选中语言后点击Set Default

  2. 创建InfoPlist文件。

    选中Runner,右键New File...

    在弹出的窗口中,选择Resouce中的String Catalog,点击Next

    保存名称为InfoPlist,点击Creat创建文件

  3. 定义多语言的key和value。

    打开InfoPlist,可以看到会自动有我们支持的语言。

    点击+号,创建一个字符串资源.

    将key的名称改为CFBundleDisplayName,后面的值就是本地化的app名称。

    对应的源码文件是ios/Runner/InfoPlist.xcstrings,看结构就是一个JSON。

    json 复制代码
    {
      "sourceLanguage" : "en",
      "strings" : {
        "CFBundleDisplayName" : {
          "extractionState" : "manual",
          "localizations" : {
            "en" : {
              "stringUnit" : {
                "state" : "translated",
                "value" : "App Name"
              }
            },
            "zh-Hans" : {
              "stringUnit" : {
                "state" : "translated",
                "value" : "App名称"
              }
            }
          }
        }
      },
      "version" : "1.0"
    }
  4. 最后在Info.plist中引用key。

    CFBundleDisplayNameCFBundleName的value都改为$(PRODUCT_NAME)

重新运行IOS App,只要支持当前系统的语言,就会显示对应的app名称。

相关推荐
杉氧8 小时前
兼容与共生:如何在旧项目中优雅地引入 Compose?
android·架构·android jetpack
Flynt9 小时前
Room 3.0 包名重构 + KMP 迁移:我把项目升级踩了个遍
android·数据库·kotlin
杉氧9 小时前
性能优化实战:如何定位冗余重组并榨干 Compose 的每一帧性能?
android·架构·android jetpack
阿pin10 小时前
Android随笔-ATMS与AMS区别与联系
android·ams·atms
alexhilton20 小时前
将应用迁移到Navigation 3:痛点、加班和紧急修复
android·kotlin·android jetpack
SoaringHeart1 天前
Flutter进阶:基于 EasyRefresh 的下拉刷新封装 n_easy_refresh_mixin.dart
前端·flutter
杉氧1 天前
Navigation Compose 深度实践:如何优雅地串联起你的全栈 App?
android·架构·android jetpack
雨白1 天前
指针与数组的核心机制
android
黄林晴1 天前
Room 3.0 正式发布!包名彻底重构,KMP 成为核心主线
android·android jetpack
三少爷的鞋1 天前
Kotlin 协程环境下的 DCL 懒加载:别把线程时代的经验直接搬过来
android