build

Build Command

Compiles your FTC robot code using Gradle.

Usage

/build           # Standard build (auto-syncs if needed)
/build --clean   # Clean build (fixes stale cache issues)
/build --sync    # Force dependency sync before building
/build --release # Build release variant (rarely needed)

Arguments

Argument	Description
--clean	Run clean before building (fixes stale cache issues)
--sync	Force refresh dependencies before building
--release	Build release variant instead of debug

Process

When this command runs:

1. Find project root:

   • Look for build.gradle with FTC SDK dependency
   • Look for TeamCode/ directory

2. Check Gradle wrapper:

   ls gradlew  # or gradlew.bat on Windows
   

   If not executable (Unix):

   chmod +x gradlew
   

3. Run build:

   Standard build (auto-syncs missing dependencies):

   ./gradlew assembleDebug
   

   With --clean:

   ./gradlew clean assembleDebug
   

   With --sync (force dependency refresh):

   ./gradlew --refresh-dependencies assembleDebug
   

   Combined --clean --sync:

   ./gradlew clean --refresh-dependencies assembleDebug
   

4. Auto-detect sync needed:

   • If build fails with dependency errors, suggest --sync
   • If build.gradle was recently modified, offer to sync

5. Parse output:

   • Look for errors and warnings
   • Extract file:line information
   • Provide helpful suggestions

Expected Output (Success)

Building robot code...

  Compiling TeamCode...
  ✓ Build successful (14.2s)

  Output: TeamCode/build/outputs/apk/debug/TeamCode-debug.apk

  Next: /deploy to upload to robot

Error Handling

Compilation Error

Building robot code...

  ✗ Build failed

  Error in TeleOpMode.java:45
  ┌─────────────────────────────────────────────
  │ 43:     public void init() {
  │ 44:         motor = hardwareMap.get(DcMotor.class, "motor");
  │ 45:         motor.setPower(speed);
  │                           ^^^^^
  │ 46:     }
  └─────────────────────────────────────────────
  Cannot find symbol: variable 'speed'

  Suggestions:
  - Did you mean to define 'speed' as a variable?
  - Or use a literal value like motor.setPower(0.5)?