011 how-to: get started on Windows¶

Put the robot’s code on a Windows laptop and build it. After this, every lesson starts in Android Studio with the project open.

the steps¶

H011S010: install Android Studio¶

The robot’s code is written in Android Studio. The team uses one version of it, Quail 4, so everyone sees the same screens. It is not the newest, so it comes from the page of older versions.

Download.

Open https://developer.android.com/studio/archive and click I agree under the terms.
Click Android Studio Quail 4 | 2026.1.4 Patch 1 to open it.
Click android-studio-quail4-patch1-windows.exe. It is about 1.5 GB.

Install.

Open the downloaded file. Click Yes when Windows asks to let it change your device.
In Android Studio Setup, click Next on each page, then Install.
When it is done, click Next, then Finish.

Check.

Android Studio starts and asks to Help improve Android Studio. Click Don’t send.

H011S020: let Android Studio fetch what it needs¶

The first time it starts, Android Studio’s setup wizard downloads the Android tools the code is built with.

Setup.

Click Next on Welcome.
Pick Standard and click Next.
Click Next on Verify Settings.
Click each license on the left, pick Accept, and click Next.
Wait while it downloads, then click Finish.

Check.

The last page of the wizard reads Android SDK is up to date. A red line may be under it: SDK emulator directory is missing. That is fine.
Welcome to Android Studio opens, with New Project, Open and Clone Repository.

If a note says Rabbit 1 available, leave it. The team stays on Quail 4.

H011S030: install AdvantageScope¶

AdvantageScope draws what the robot is doing: where it is on the field, and graphs of its numbers.

Download. Open https://github.com/Mechanical-Advantage/AdvantageScope/releases/tag/v26.0.2. Under Assets, click advantagescope-win-x64-v26.0.2.exe.

Install.

Edge may say the file isn’t commonly downloaded. Click the three dots by it, then Keep, then Keep anyway.
Open the file from your Downloads folder.
If you see Windows protected your PC, click More info, then Run anyway. It sets itself up and starts.

Check.

AdvantageScope opens on its Line Graph tab, with No data available on the left.

H011S040: get the project¶

The robot’s code lives on GitHub. Android Studio copies it to the laptop with a tool called git.

Clone.

On Welcome to Android Studio, click Clone Repository.
Into URL, type https://github.com/msb-stitt/ftc31459-26-27-biobuzz. Leave Directory as it is.
The first time, it says Git is not installed. Click Download and Install beside it. Click Yes when Windows asks.
When it says Git has been installed, click Clone.

Trust. Android Studio asks if you trust the project. A box about Microsoft Defender is ticked. Leave it ticked, and click Trust Project.

Check.

The project opens, and the Project window lists FtcRobotController and TeamCode.

H011S050: answer what Android Studio offers¶

While the project loads, Android Studio reads it with Gradle, the tool that builds the code. This is called a sync. The first sync downloads Java 17 and more, and takes a few minutes.

Answer. Notes pop up in the bottom right while it works. Answer each one like this:

Agent Mode now available: click Do not show again. The lessons do not use an AI helper.
Project update recommended, Android Gradle plugin version 8.13.2 has an upgrade available: click More, then Don’t ask for this project. The project needs version 8.13.2, so do not upgrade it.
Microsoft Defender may affect IDE: click Exclude folders.
If Windows asks whether adb can use the network, click Allow.

Check.

The Build window’s Sync tab has a green tick beside the project.
Open File → Settings. Type Gradle in its search box and click Gradle under Build Tools. Under Gradle JVM criteria, Version reads 17.

H011S060: build the code¶

Build. Click Build → Assemble Project. The first build takes a few minutes.

Check.

The Build window’s Build Output tab ends with BUILD SUCCESSFUL and 63 actionable tasks: 63 executed.