Android Gradle Skill

Android Gradle Skill

Automate Gradle tasks for Android projects: build, test, coverage, clean.

When to Use

• Building debug/​release APK
• Running unit tests
• Generating coverage reports
• Cleaning build cache
• Checking dependencies

Commands

Build Commands

Test Commands

Coverage Commands

Dependency Commands

Usage Examples

# Build and install debug APK
./​gradlew assembleDebug && ./​gradlew installDebug

# Run specific test class
./​gradlew test --tests "*.GameManagerImplTest"

# Generate coverage report
./​gradlew jacocoTestDebugUnitTestReport
# Report at: app/​build/​reports/​jacoco/​jacocoTestDebugUnitTestReport/​html/​index.html

# Clean rebuild
./​gradlew clean assembleDebug

Timeout Configuration

Version Compatibility

Error Handling

// Handle build failures in scripts
fun handleGradleResult(exitCode: Int, output: String) {
    when {
        exitCode != 0 && output.contains("Compilation failed") ->
            println("Fix compilation errors in: ${extractErrorFiles(output)}")
        exitCode != 0 && output.contains("AAPT") ->
            println("Resource error - check XML files")
        exitCode != 0 && output.contains("OutOfMemoryError") ->
            println("Increase heap: org.gradle.jvmargs=-Xmx4g")
    }
}

Common Errors:

• Build failure: Parse error message, check file:line references
• Test failure: Run with --info for stack traces
• Coverage below threshold: Check app/​build/​reports/​jacoco/​*/​html/​index.html
• OOM: Increase heap in gradle.properties

Test Result Validation

# Run tests and validate results
./​gradlew testDebugUnitTest && echo "✓ All tests passed" || echo "✗ Tests failed"

# Check coverage threshold
./​gradlew jacocoTestDebugUnitTestReport
# Verify: app/​build/​reports/​jacoco/​jacocoTestDebugUnitTestReport/​html/​index.html
# Target: 80%+ line coverage

# Parse test results programmatically
cat app/​build/​test-results/​testDebugUnitTest/​*.xml | grep -E "(tests=|failures=)"

Troubleshooting

Command Workflows

# Full CI workflow
./​gradlew clean testDebugUnitTest jacocoTestDebugUnitTestReport assembleDebug

# Quick iteration
./​gradlew assembleDebug -x lint -x test && ./​gradlew installDebug

# Pre-commit check
./​gradlew ktlintCheck testDebugUnitTest

CI/​CD Integration

# GitHub Actions example
- name: Build & Test
  run: |
    ./​gradlew testDebugUnitTest
    ./​gradlew jacocoTestDebugUnitTestReport
    ./​gradlew assembleDebug

- name: Upload Coverage
  uses: codecov/​codecov-action@v4
  with:
    files: app/​build/​reports/​jacoco/​*/​jacoco*.xml

Best Practices

• Always use Gradle wrapper (./​gradlew), never system Gradle
• Use --parallel for multi-module projects
• Enable configuration cache for faster builds
• Skip lint with -x lint if not needed for quick iterations

References

• Gradle User Guide
• Android Gradle Plugin
• JaCoCo Coverage