字
字节笔记本
2026年2月22日
Flutter Google Play 多语言配置指南
Flutter 应用发布到 Google Play 时，多语言配置分为两部分：应用商店页面的多语言和应用内的多语言。
一、商店页面多语言（Store Listing）
在 Play Console 里配置：
- 进入应用 ->
Store presence->Main store listing - 默认语言是英语，点击右上角
Manage translations - 选择要添加的语言，逐一填写：
- 应用名称（App name，最多 30 字）
- 简短描述（Short description，最多 80 字）
- 完整描述（Full description，最多 4000 字）
- 截图（可以为每种语言单独上传）
每种语言都要单独填写，不会自动翻译。
二、应用内多语言（Flutter 实现）
配置 pubspec.yaml
yaml
dependencies:
flutter_localizations:
sdk: flutter
intl: ^0.19.0
flutter:
generate: true添加 l10n.yaml
yaml
arb-dir: lib/l10n
template-arb-file: app_en.arb
output-localization-file: app_localizations.dart创建 arb 文件
lib/l10n/app_en.arb：
json
{
"@@locale": "en",
"appTitle": "My App",
"welcome": "Welcome"
}lib/l10n/app_zh.arb：
json
{
"@@locale": "zh",
"appTitle": "我的应用",
"welcome": "欢迎"
}lib/l10n/app_ja.arb：
json
{
"@@locale": "ja",
"appTitle": "マイアプリ",
"welcome": "ようこそ"
}在 main.dart 配置
dart
import 'package:flutter_localizations/flutter_localizations.dart';
import 'package:flutter_gen/gen_l10n/app_localizations.dart';
MaterialApp(
localizationsDelegates: const [
AppLocalizations.delegate,
GlobalMaterialLocalizations.delegate,
GlobalWidgetsLocalizations.delegate,
GlobalCupertinoLocalizations.delegate,
],
supportedLocales: const [
Locale('en'),
Locale('zh'),
Locale('ja'),
],
home: MyHomePage(),
)使用翻译文本
dart
Text(AppLocalizations.of(context)!.welcome)生成代码
bash
flutter gen-l10n三、Play Console 声明支持的语言
应用上传后，Play Console 会自动检测 APK/AAB 里的语言资源，无需手动配置。
可以在 App content -> App details 里查看检测到的语言列表，确认是否正确。
常用语言 locale 代码
| 语言 | 代码 |
|---|---|
| 简体中文 | zh 或 zh_CN |
| 繁体中文 | zh_TW |
| 英语 | en |
| 日语 | ja |
| 韩语 | ko |
| 西班牙语 | es |
| 法语 | fr |
| 德语 | de |
建议流程
- 先在 Flutter 里用
flutter_localizations+ arb 文件完成应用内多语言 - 打包 AAB 上传到 Play Console
- 在 Store Listing 里为每种语言单独填写商店描述和截图
- 为主要市场语言（中、英、日、韩）各准备一套本地化截图，转化率会更好
总结
| 部分 | 配置位置 | 说明 |
|---|---|---|
| 商店页面 | Play Console | 手动填写每种语言的描述和截图 |
| 应用内 | Flutter 代码 | 使用 arb 文件 + flutter_localizations |
| 语言声明 | 自动检测 | Play Console 自动识别 APK 中的语言资源 |
分享: