Flutter本地化翻译管理插件lokalise_cmd的使用

Flutter本地化翻译管理插件lokalise_cmd的使用

lokalise_cmd

一个从Lokalise下载翻译包并将其转换为.arb文件的工具。

目前，它支持以下命令：

下载命令

使用方法

在lokalise.yaml中添加配置：

lokalise_cmd:
  project_id: YOUR_LOKALISE_PROJECT_ID
  api_token: YOUR_LOKALISE_API_TOKEN
  include_tags:
    - tag1
    - tag2
    
flutter_intl:
  enabled: true

运行 lokalise_cmd：

flutter pub run lokalise_cmd \
  [--working-directory <path>] \
  [--api-token <token>] \
  [--project-id <project_id>] \
  <command>

你也可以按照Dart文档中关于设置全局命令的说明来配置，使其作为一个常规shell命令可用，通过追加PATH实现：

lokalise_cmd <command>>

或者创建一个别名：

alias lokalise_cmd="flutter pub run lokalise_cmd"

lokalise_cmd <command>>

下载命令

下载.arb翻译文件。

lokalise_cmd download \
  [--output <path>] \
  [--include-tags <tag1,tag2,...>]

例如：

lokalise_cmd download

更多关于Flutter本地化翻译管理插件lokalise_cmd的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter本地化翻译管理插件lokalise_cmd的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


lokalise_cmd 是一个用于管理 Flutter 应用本地化翻译的命令行工具，它与 Lokalise 平台集成，帮助开发者轻松地从 Lokalise 平台导入和导出翻译文件。以下是如何使用 lokalise_cmd 插件的基本步骤：

1. 安装 lokalise_cmd

首先，你需要在你的开发环境中安装 lokalise_cmd。你可以通过以下命令安装它：

dart pub global activate lokalise_cmd

2. 配置 Lokalise API 密钥

在使用 lokalise_cmd 之前，你需要配置你的 Lokalise API 密钥。你可以通过以下命令设置它：

lokalise_cmd config --api-key YOUR_API_KEY

将 YOUR_API_KEY 替换为你在 Lokalise 平台上生成的 API 密钥。

3. 初始化项目

在你的 Flutter 项目根目录下，运行以下命令来初始化 lokalise_cmd 配置：

lokalise_cmd init

这将会生成一个 lokalise.yaml 配置文件，你可以在其中指定项目的相关设置。

4. 配置 lokalise.yaml

打开生成的 lokalise.yaml 文件，并根据你的项目需求进行配置。以下是一个示例配置：

project_id: YOUR_PROJECT_ID
output_dir: lib/l10n
lang_iso:
  - en
  - es
  - fr
  • project_id: 你的 Lokalise 项目 ID。
  • output_dir: 翻译文件输出的目录。
  • lang_iso: 你希望支持的语言代码列表。

5. 下载翻译文件

配置完成后，你可以通过以下命令从 Lokalise 平台下载翻译文件：

lokalise_cmd download

这将会根据 lokalise.yaml 中的配置，将翻译文件下载到指定的 output_dir 目录中。

6. 上传翻译文件

如果你在本地修改了翻译文件，并希望将这些更改上传到 Lokalise 平台，可以使用以下命令：

lokalise_cmd upload

7. 使用翻译文件

下载的翻译文件通常是 .arb 文件，你可以使用 Flutter 的 flutter_localizations 包来加载和使用这些翻译。确保在你的 pubspec.yaml 中添加以下依赖：

dependencies:
  flutter:
    sdk: flutter
  flutter_localizations:
    sdk: flutter

然后在你的 MaterialApp 中配置本地化支持：

import 'package:flutter_localizations/flutter_localizations.dart';

MaterialApp(
  localizationsDelegates: [
    GlobalMaterialLocalizations.delegate,
    GlobalWidgetsLocalizations.delegate,
    GlobalCupertinoLocalizations.delegate,
  ],
  supportedLocales: [
    const Locale('en', ''),
    const Locale('es', ''),
    const Locale('fr', ''),
  ],
  // 其他配置
);
回到顶部