Trackr：Android 实时公交追踪应用

项目简介

Trackr（BusOnRoad）是一款面向通勤族的 Android 实时公交追踪应用。它基于 Material Design 3 Expressive 设计规范与 Android 响应式架构构建，提供车辆站序、到站倒计时、沿途车速与停靠区间展示，让日常公交候车更从容。

应用采用 Kotlin、Jetpack Compose 与 Navigation 3 开发，最低支持 Android 8.0（API 26），并遵循 Material 3 动态色彩提供深色模式。

主要功能

• 实时追踪与到站预报：展示目标线路上在途车辆的相对站序、预计到达时间与实时距离。
• 双模式线路走向图：基于 Jetpack Compose 构建，支持横向平滑全景轨道与纵向时间轴两种视图无缝切换。
• 车队雷达看板：全线在途车辆一览，可按距当前站距离排序，查看车牌、实时时速与准点状态。
• 多站台交通枢纽看板：支持大型公交枢纽站多物理站台一键切换、地铁换乘指引与全线综合到站看板。
• 极速线路与站点搜索：支持拼音字母及汉字模糊即时联想，快速定位线路与首末班方向。
• 桌面微件与常驻通知：桌面 Widget 可一键查看关注线路到站，配合系统状态栏常驻进度与到站提醒通知。
• 质感深色模式：遵循 Material 3 动态色彩与深色调优规范，适合夜间候车使用。

界面预览：

首页通勤看板	线路实时走向

车队在途雷达	换乘枢纽看板

安装与使用

环境要求

• Android Studio Ladybug (2024.2) 或更高版本
• JDK 21（兼容 Java 17+）
• Android 8.0 (API 26) 及以上设备或模拟器

编译与安装

git clone https://github.com/5151561/Trackr-.git
cd busonroad
./gradlew assembleDebug
./gradlew installDebug

配置高德 Key

路线规划与地图底图需要自备高德 Key，项目源码中不含任何硬编码 Key。两类 Key 用途不同，不能混用：

Key 类型	用途	是否绑定包名
Android 平台 Key	3D 底图渲染、搜索 SDK、定位 SDK	必须绑定包名 + SHA-1
Web 服务 Key	restapi.amap.com 公交算路 / 输入提示	不绑定

配置方式二选一：

1. 界面配置（推荐）：在 App 内打开路线规划 → 点击「配置 Key」胶囊 →「复制包名 + SHA-1」，前往高德开放平台创建 Android 平台 Key 后回填，立即生效，无需重新编译。
2. 工程注入：在本地 local.properties 中写入，编译时自动注入，也可用同名环境变量：

AMAP_ANDROID_KEY=你的 Android 平台 Key
AMAP_WEB_KEY=你的 Web 服务 Key

执行 ./gradlew amapKeyStatus 可查看当前注入状态。

注意事项

• debug 与 release 共用同一包名 com.github.u5151561.trackr，在高德控制台把发布版与调试版两个 SHA-1 都填上，一把 Key 即可覆盖两种构建产物。
• 从源码自行编译的签名不同（debug keystore），需按 App 内显示的实际 SHA-1 另外注册 Key。
• 高德 3dmap 仅内置 arm64-v8a / armeabi-v7a 原生库，x86/x86_64 模拟器无法渲染底图，请使用真机或 arm 架构模拟器。
• 未配置 Key、ABI 不支持或底图鉴权失败时，界面会自动降级为内置矢量示意图并提示原因，本地实时公交直达与站点匹配引擎仍然可用。
• 请勿提交任何正式 Keystore 及其密码，.gitignore 已做相应配置。
• 项目采用 MIT License。

---

本作品整理自 GitHub 开源项目 5151561/Trackr，原作者 @5151561，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。