英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

inKino - 一个在 Flutter 和 Web 之间共享代码的多平台 Dart 项目

inKino是什么？

inKino 是一个用于浏览 Finnkino 影院电影和场次的多平台 Dart 应用。

InKino 展示了 Redux，拥有大量自动化测试，并且 40% 的代码在 Flutter 和 Web 之间共享。Android 和 iOS 应用是用单一的 Flutter 代码库制作的。渐进式网页应用则是使用 AngularDart 制作的。这个项目通常被认为是一个多平台 Dart 项目的良好示例。

我计划撰写一整系列关于多平台 Dart 的文章，所以你或许想要 查看我的博客 并订阅它。

文件夹结构

有三个不同的文件夹。它们每个都是一个 Dart 项目。

• core：包含纯 Dart 的业务逻辑，例如 API 通信、Redux、XML 解析、数据清理、i18n、本地化、多语言、模型和工具。它还有很好的测试覆盖率。
• mobile：这是 Flutter 项目。它导入 core，并且是针对在应用商店发布的原生 Android 和 iOS 应用的 100% 共享代码库。
• web：AngularDart 渐进式 web 应用。也导入 core，这是在 https://inkino.app 上上线的应用。

要在这些项目上工作，请在你选择的编辑器中打开每一个项目。

例如，如果你想做一个新功能，并且你先在 Flutter 项目中实现它，你会在不同的编辑器窗口中打开 core 和 mobile。为了说明，你会先为 core 执行 File -> Open...，然后再为 mobile 执行 File -> Open...。

开发环境设置

• 安装适用于网页的 Dart。Flutter 自带的定制 Dart 版本不适合网页开发。
• 通过运行 pub global activate webdev 安装 webdev。这要求你正确安装了 Dart，并且 Dart 已经加入了你的 PATH。
• 安装一个 IDE。选择 WebStorm 不会错。如果这不符合你的喜好，还有其他选项。
• 为你的 IDE 安装 Dart 插件。

最后，如果你还没有安装，安装 Flutter。同时为你的 IDE 安装 Flutter 插件。目前，inKino 是基于 Flutter 1.0 构建的。

如果你不喜欢 IDE，显然你也可以使用 Emacs 或 Vim。

构建项目

重命名 TMDB 配置文件

你不需要 TMDB API 密钥，但没有它演员图片无法加载。

如果你尝试直接构建项目，会出现一个错误，提示缺少 tmdb_config.dart 文件。为了解决这个问题，在项目根目录的终端中运行以下命令：

cd core/lib/src && mv tmdb_config.dart.sample tmdb_config.dart && cd ../../..

或者

如果你不相信从互联网上复制的随机 bash 脚本，你可以手动将 tmdb_config.dart.sample 重命名为 tmdb_config.dart。

从源码构建

首先，确保你已经按照上面的“开发环境设置”部分进行操作。

• 要运行 web 项目，首先在根目录下执行 pub get，然后执行 webdev serve。
• 要运行 Flutter 项目，在编辑器中打开它并点击播放按钮，或者在终端运行 flutter run。

贡献

欢迎贡献！但是，如果这将是一个重大更改，请先创建一个问题。在开始处理某件事之前，请在具体的问题上发表评论，并说明您希望参与处理它。

致谢

特别感谢 Olli Haataja 的设计。

此外，对于初始版本发布，还要感谢 Thibaud Colas、Brian Egan、Alessandro Aime 和 Juho Rautioaho 在审查源代码时提供的额外帮助。