Funnybones

一个遵循清洁架构原则、结构良好且经过测试的笑话应用。

状态管理 – BLoC + Flutter Bloc

数据持久化 – Shared Preference

单元测试用例和控件测试用例

入门？

此项目包含 3 种风味

  • 开发
  • 测试
  • 生产

要运行所需的风味，可以使用 VSCode/Android Studio 中的启动配置，或使用以下命令

# Development
$ flutter run --flavor development --target lib/main_development.dart

# Staging
$ flutter run --flavor staging --target lib/main_staging.dart

# Production
$ flutter run --flavor production --target lib/main_production.dart

*Funnybone 支持 iOS、Android、Web、macOS 和 Windows。

正在运行测试？

要运行所有单元和 widget 测试，请使用以下命令

$ flutter test --coverage --test-randomize-ordering-seed random

要查看生成的覆盖率报告，您可以使用 lcov。

# Generate Coverage Report
$ genhtml coverage/lcov.info -o coverage/

# Open Coverage Report
$ open coverage/index.html

正在处理翻译？

该项目依赖于 flutter_localizations，并遵循 Flutter 官方国际化指南。

添加字符串

  1. 要添加新的本地化字符串，请打开位于 lib/l10n/arb/app_en.arb 的 app_en.arb 文件。

{
    "@@locale": "en",
    "appBarTitle": "Funny Bones",
    "@appBarTitle": {
        "description": "Some Description"
    }
}
  1. 然后添加新的键/值和描述

{
    "@@locale": "en",
    "appBarTitle": "Funny Bones",
    "@appBarTitle": {
        "description": "Some Description"
    }
    "helloWorld": "Hello World",
    "@helloWorld": {
        "description": "Hello World Text"
    }
}
  1. 使用新字符串

import 'package:funnybone/l10n/l10n.dart';

@override
Widget build(BuildContext context) {
  final l10n = context.l10n;
  return Text(l10n.helloWorld);
}

添加支持的区域设置

更新位于 ios/Runner/Info.plist 的 Info.plist 中的 CFBundleLocalizations 数组，以包含新的区域设置。

    ...

    <key>CFBundleLocalizations</key>
	<array>
		<string>en</string>
		<string>es</string>
	</array>

    ...

添加翻译

  1. 对于每个支持的区域设置，请在 lib/l10n/arb 中添加一个新的 ARB 文件。

├── l10n
│   ├── arb
│   │   ├── app_en.arb
│   │   └── app_es.arb
  1. 将翻译后的字符串添加到每个 .arb 文件中

app_en.arb

{
    "@@locale": "en",
    "counterAppBarTitle": "Counter",
    "@counterAppBarTitle": {
        "description": "Text shown in the AppBar of the Counter Page"
    }
}

app_es.arb

{
    "@@locale": "es",
    "counterAppBarTitle": "Contador",
    "@counterAppBarTitle": {
        "description": "Texto mostrado en la AppBar de la página del contador"
    }
}

生成翻译

要使用最新的翻译更改，您需要生成它们

  1. 为当前项目生成本地化文件
flutter gen-l10n --arb-dir="lib/l10n/arb"

或者，运行 flutter run，代码生成将自动进行。

GitHub

查看 Github