FIRST-Tech-Challenge/FtcRobotController

项目介绍

这个仓库托管 FIRST Tech Challenge（FTC）BIOBUZZ（2026-2027）赛季的公开 SDK，是构建控制 FTC 竞赛机器人 Android 应用的源码，同时附带大量 Sample OpModes，队伍可以复制到 /teamcode 目录直接使用或按需修改（NOTICE 与 Welcome）。

它面向 FTC 参赛队和教练：用 Java 的团队在 Android Studio 中开发，不想装桌面 IDE 的团队也可以用 Blocks 或 OnBot Java 编程。

快速使用

需要 Android Studio Narwhal 3 Feature Drop 或更新版本才能打开和构建这个 Android Studio 工程（Requirements）。Blocks 和 OnBot Java 不需要 Android Studio，新手可以先不装桌面工具链。

1. 将整个仓库下载或克隆到本地；SDK 以完整工程的形式使用，不是单个文件（Welcome、Downloading the Project）。
2. 用兼容的 Android Studio 打开工程，等待 Gradle 同步完成后构建 Robot Controller 应用。
3. 从自带的 Sample OpModes 入手，把示例复制进 /teamcode 再按机器人硬件修改。

如果是第一次接触 FTC，建议先看 FTC Blocks Tutorial 熟悉控制系统，再进入 Java 开发（Getting Started）。SDK 还提供在线 Javadoc 和 FIRST Tech Challenge 文档（Javadoc Reference）。

版本与兼容性约束

• 当前版本线为 Version 12.0，README 按大版本记录了破坏性变更，升级前应先读对应版本的发布说明（Release Information）。
• Version 11.2 将 Gradle 升级到 9.1、Android Gradle Plugin 升级到 8.13.2，要求 Android Studio Narwhal 3 Feature Drop 或更新版本，旧版 Android Studio 会同步失败（Version 11.2 破坏性变更）。
• OnBotJava 只支持 Java 1.8，新版 Android Studio 自带 JDK 会给出弃用警告；桌面开发与 OnBot Java 混用时需要注意（Version 10.1.1 已知问题）。
• 部分版本会移除或重构 API，例如 Version 10.0 移除了 TensorFlow Object Detection 相关类，Version 12.0 的 AprilTag Cluster 能力会让旧版 AprilTag OpMode 编译报错（Version 10.0 变更、Version 12.0 破坏性变更）。

求助与社区

控制系统或 SDK 的技术问题可以到 FIRST Tech Challenge Community 论坛提问。README 也说明在线文档是持续更新的长期参考（User Documentation）。

HotRepo 点评

该仓库在 2026-11-04 的 HotRepo Java 日榜上出现过一次，最好名次为第 8，当天 Star 净增为 0。单条快照只能说明当日受到关注，不足以判断增长趋势；fork 数远高于 Star，更多反映各队把 SDK 当作起点整体克隆，而不是常规的流行度指标。这是一个按赛季更新的官方 SDK，价值与当年赛题绑定，也需要让 Android Studio、Gradle 与 Driver Station 版本保持匹配。