Agent Capabilities

Each build agent reports its capabilities based on detected software. This determines which builds the agent can execute.

Capability Detection

During registration, the agent detects:

Capability	How It’s Detected
iOS	macOS + `xcodebuild -version`
Android	`ANDROID_HOME` or Flutter’s Android SDK
Web	Always enabled (Flutter can build web)

iOS Builds

Requirements

macOS (any recent version)
Xcode (14.0+, latest recommended)
CocoaPods (for dependencies)

Setup

# Install Xcode from App Store, then:
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -license accept

# Install command line tools
xcode-select --install

# Install CocoaPods
sudo gem install cocoapods

# Verify
xcodebuild -version
flutter doctor

What’s Detected

Xcode: 15.1
  Build version: 15C65

Code Signing

For deploying to TestFlight/App Store, you’ll need:

Apple Developer account
Distribution certificate
Provisioning profiles

See Code Signing Guide for setup instructions.

Android Builds

Requirements

Android SDK (command-line tools or Android Studio)
Java JDK (17+ recommended)
Gradle (usually bundled with Flutter)

Setup

Option 1: Android Studio

# Install Android Studio
# Download from: https://developer.android.com/studio

# Accept licenses
flutter doctor --android-licenses

Option 2: Command-line tools only

# Download command-line tools from:
# https://developer.android.com/studio#command-tools

# Extract to ~/Android/cmdline-tools/latest/

# Set environment variables
export ANDROID_HOME=$HOME/Android
export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin
export PATH=$PATH:$ANDROID_HOME/platform-tools

# Install required components
sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"

# Accept licenses
flutter doctor --android-licenses

What’s Detected

The agent checks for ANDROID_HOME environment variable or uses Flutter’s detection:

Android SDK: /Users/you/Library/Android/sdk
  Platform: android-34
  Build-tools: 34.0.0

Signing Android Builds

For Google Play deployment, you’ll need:

Upload key (keystore file)
Key password
Google Play Console service account

See Android Deployment Guide for setup.

Web Builds

Requirements

Flutter (any version with web support)
Chrome (for testing, optional)

Setup

Web builds work out of the box with Flutter:

# Verify Flutter supports web
flutter devices

# Should show:
# Chrome • chrome • web-javascript • Google Chrome

What’s Detected

Web capability is always enabled if Flutter is installed.

Viewing Agent Capabilities

In the CLI

flightstack agent list

Output:

My-MacBook-Pro
  ID: a1b2c3d4-...
  Status: 🟢 Online
  Capabilities: iOS, Android, Web

In the FlightStack App

Go to Build Agents
Click on an agent
View the Capabilities section

Updating Capabilities

If you install new software (e.g., add Xcode to a Linux machine via VM), re-register to update capabilities:

# Re-register to detect new capabilities
flightstack agent register

Platform Matrix

Agent Platform	iOS	Android	Web
macOS + Xcode	✅	✅	✅
macOS (no Xcode)	❌	✅	✅
Linux	❌	✅	✅
Windows	❌	✅	✅

Multi-Agent Setup

For full platform coverage, consider:

Agent	Platform	Use For
mac-builder	macOS	iOS builds
linux-ci	Linux	Android, Web, tests

FlightStack automatically routes builds to agents with matching capabilities.

Troubleshooting

iOS Not Detected

# Check Xcode installation
xcode-select -p
# If not, set it:
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer

# Re-register agent
flightstack agent register

Android Not Detected

# Check ANDROID_HOME
echo $ANDROID_HOME

# Set if missing
export ANDROID_HOME=$HOME/Library/Android/sdk  # macOS
export ANDROID_HOME=$HOME/Android/Sdk          # Linux

# Add to your shell profile (.zshrc, .bashrc)
echo 'export ANDROID_HOME=$HOME/Library/Android/sdk' >> ~/.zshrc

# Re-register agent
flightstack agent register

Flutter Not Found

# Check Flutter is in PATH
which flutter

# Add to PATH if needed
export PATH="$PATH:/path/to/flutter/bin"

# Verify
flutter doctor