SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsandroid-gradle

android-gradle

Coding & development

View repository

Updated 10-16 00:04

About this 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

Command Description Gradle Task
build Build debug APK ./gradlew assembleDebug
build:release Build release APK ./gradlew assembleRelease
install Install to device ./gradlew installDebug
clean Clean build cache ./gradlew clean
rebuild Clean + build ./gradlew clean assembleDebug

Test Commands

Command Description Gradle Task
test Run all unit tests ./gradlew testDebugUnitTest
test:class Run single class ./gradlew test --tests "*.ClassName"
test:method Run single test ./gradlew test --tests "*.Class.method"

Coverage Commands

Command Description Gradle Task
coverage Full coverage report ./gradlew jacocoTestDebugUnitTestReport
coverage:verify Enforce 80% minimum ./gradlew jacocoVerification

Dependency Commands

Command Description Gradle Task
deps Show dependency tree ./gradlew dependencies
deps:app App module only ./gradlew :app:dependencies
outdated Check outdated deps ./gradlew dependencyUpdates

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

Task Type Timeout
assembleDebug 2 min
testDebugUnitTest 3 min
jacocoTestDebugUnitTestReport 2 min
clean 30 sec
dependencies 30 sec

Version Compatibility

Gradle AGP Kotlin JDK
8.10+ 8.8+ 2.1+ 17+
8.5+ 8.5+ 2.0+ 17+
8.0+ 8.0+ 1.9+ 17+

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

Issue Solution
Build hangs Kill daemon: ./gradlew --stop
Cache issues Clean: ./gradlew clean cleanBuildCache
OOM errors Add to gradle.properties: org.gradle.jvmargs=-Xmx4g
Version conflict Force resolution in build.gradle.kts
Slow builds Enable: org.gradle.parallel=true

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