Trufi Core 开源项目最佳实践教程

Trufi Core 开源项目最佳实践教程

trufi-core Trufi - A Flutter app for Public Transportation 项目地址: https://gitcode.com/gh_mirrors/tr/trufi-core

1. 项目介绍

Trufi Core 是一个基于开源数据构建的跨平台多模式公共交通应用程序。该应用由 Trufi Association 开发，这是一个致力于通过技术改善交通状况的社会创业公司。Trufi Core 使用 Flutter 框架开发，可以轻松地为不同城市定制公共交通应用程序。

2. 项目快速启动

以下是如何快速启动 Trufi Core 项目的步骤：

首先，确保你已经安装了 Flutter 开发环境。

git clone https://github.com/trufi-association/trufi-core.git
cd trufi-core

复制 example 文件夹的内容到新的仓库中。

cp -r example/* .

修改 pubspec.yaml 文件，将以下内容：

trufi_core:
  path: ../

替换为：

trufi_core:
  git:
    url: https://github.com/trufi-association/trufi-core.git
    ref: main

配置你的开发环境，以便成功编译项目。

编辑 main.dart 文件，并根据需要修改内容。

对于离线搜索 POI 功能，移除 photonUrl 并使用 osm-search-data-export 生成自己的 assets/data/search.json。

对于在线搜索 POI 功能，移除 searchAssetPath。

更换 drawer-bg.jpg 为你自己的背景图片。

3. 应用案例和最佳实践

离线数据准备

为了使用离线搜索数据，你需要使用 osm-search-data-export 工具生成 search.json 文件。

osm-search-data-export --input "path/to/your.osm.pbf" --output "path/to/your/search.json"

在线数据接口

如果你打算使用在线数据，你需要设置一个有效的 API 密钥，并在代码中相应地配置。

国际化和本地化

Trufi Core 使用 Lokalise 进行国际化管理。不要直接修改 /translations 文件夹中的内容，而是通过 Lokalise 平台进行更新。

4. 典型生态项目

Trufi Core 的生态系统包括以下项目：

• osm-search-data-export：生成包含 POI、街道和街道交叉点的离线搜索数据。
• osm-public-transport-export：获取 OSM 数据并生成 GeoJSON 和其他附加文件。
• geojson-to-gtfs：将生成的 GeoJSON 和附加数据转换为 GTFS 格式。
• gtfs-bolivia-cochabamba：配置包，内部使用 osm-public-transport-export 和 geojson-to-gtfs 生成用于 OTP 的 GTFS 文件。

这些项目共同构成了 Trufi Core 的强大功能，使其能够为不同城市提供定制化的公共交通应用程序。

trufi-core Trufi - A Flutter app for Public Transportation 项目地址: https://gitcode.com/gh_mirrors/tr/trufi-core