Flutter Gallery

Flutter Gallery 是一个帮助开发者评估和使用 Flutter 的资源。它收集了用 Flutter 实现的 Material Design 和 Cupertino 小部件、行为和示例。我们经常被问到如何能看到 Flutter 的实际运行效果，而这个画廊展示了 Flutter 的功能以及它在实际应用中的表现。

在 Flutter 的 master 分支上运行 Flutter Gallery

Flutter Gallery 的目标是针对 Flutter 的 master 分支。因此，它可以利用
尚未发布到稳定分支的新 SDK 功能。

如果您想运行 Flutter Gallery，请确保首先切换到 master 分支。
首先

flutter channel master
flutter upgrade

完成后，使用此命令返回到稳定
分支

flutter channel stable
flutter upgrade

支持的平台

Flutter Gallery 已构建为支持多平台。
这包括

  • Android
  • iOS
  • Web
  • macOS
  • Linux
  • Windows

即便如此，也必须采取额外步骤来启用桌面支持。例如，要运行 macOS 应用
应用

cd gallery/
flutter config --enable-macos-desktop
flutter create .
flutter run -d macos

此外，UI 会在移动和桌面布局之间自适应，而不管
它在哪种平台上运行。这根据窗口大小确定，如adaptive.dart中所述。
adaptive.dart.

添加新的启动动画

  1. 将您的动画转换为 `.gif` 文件。
    理想情况下，使用背景色 `0xFF030303` 以确保动画
    与应用背景融合。

  2. 将您的新 `.gif` 文件添加到 `assets` 目录下的
    `assets/splash_effects`。确保文件名遵循格式
    `splash_effect_$num.gif`。数字应为存储库中当前最大数字之后的一个数字。
    存储库。

  3. 更新 `_effectDurations` 映射，位于
    splash.dart 中，以包含新
    `.gif` 的编号及其预估时长。时长用于确定
    在启动时显示启动动画的时长。

生成本地化字符串和高亮代码段

要生成本地化字符串或高亮代码段，请确保您
已安装 grinder。您可以通过在 `samples/gallery/` 中获取包来安装它。
包

flutter pub get

要生成本地化字符串（请参阅单独的 README）
README

flutter pub run grinder l10n

要生成代码段（请参阅单独的 README 以
获取更多详细信息）

flutter pub run grinder update-code-segments

创建新版本（仅限 Flutter 组织成员）

  1. 在 `pubspec.yaml` 中增加版本号。使用语义化版本控制来确定
    要递增哪个数字。例如 `2.2.0+020200` 应变为 `2.3.0+020300`。

  2. 在此存储库的 `master` 分支上创建一个标签，形式为 `v2.3`。

    • git tag v2.3
    • git push --tags

  3. 发布 Web 版本（使用 peanut 包）。

    • flutter pub global activate peanut
    • flutter pub global run peanut:peanut
    • git push upstream gh-pages:gh-pages
      • `git update-ref refs/heads/gh-pages upstream/gh-pages` 如果您需要与上游对齐。

  4. 发布 Android 版本（使用正确的签名证书）。

    • 使用 `flutter build appbundle` 创建应用捆绑包。
    • 上传到 Play 商店控制台。
    • 发布 Play 商店版本。
    • 使用 `flutter build apk` 创建 APK（用于 Github 版本）。

  5. 在 Github 上从您创建的标签草拟一个版本，将该版本命名为 `Flutter Gallery 2.x`。

    • 上传上面的 Android APK。
    • 通过运行 `flutter build macos` 并将应用压缩在 `build/macos/Build/Products/Release` 中来创建并上传 macOS 构建。
      发布
    • 可选：创建并上传 Linux/Windows 构建。
    • 发布该版本。

GitHub

https://github.com/flutter/gallery