Skip to content

po4yka/RIPDPI / .agents/skills/gradle-build-system

gradle-build-system

Verified

Add a Gradle dependency or module, or triage a build failure. Use when editing gradle.properties or a build.gradle.kts. Not for plugin internals (convention-plugin-development) or version bumps (dependency-update).

FileKindSize
SKILL.mdskill md4.4 KB
---
name: gradle-build-system
description: Add a Gradle dependency or module, or triage a build failure. Use when editing gradle.properties or a build.gradle.kts. Not for plugin internals (convention-plugin-development) or version bumps (dependency-update).
---

# Gradle Build System

## Overview

RIPDPI uses the Gradle version pinned by `gradle/wrapper/gradle-wrapper.properties`, convention plugins in `build-logic/convention/`, and the version catalog at `gradle/libs.versions.toml`. Read those source files before reporting versions; all module build configuration flows through convention plugins.

## Convention Plugins

| Plugin | Purpose |
|--------|---------|
| `ripdpi.android.application` | App module: compileSdk, minSdk, targetSdk, Java 17 bytecode |
| `ripdpi.android.library` | Library modules: compileSdk, minSdk, Java 17 bytecode |
| `ripdpi.android.compose` | Compose compiler configuration |
| `ripdpi.android.native` | NDK version, ABI filters, legacy packaging |
| `ripdpi.android.quality` | Shared detekt + ktlint + Android lint verification wiring |
| `ripdpi.android.coverage` | Shared JaCoCo coverage wiring |
| `ripdpi.android.protobuf` | Protobuf code generation setup |
| `ripdpi.android.test` | `com.android.test` modules (`:baselineprofile`): wires the shared Gradle Managed Device registry |

This table is a working subset for everyday lookups, not the full inventory. Plugin sources: `build-logic/convention/src/main/kotlin/ripdpi.android.*.gradle.kts` -- for the complete plugin list, helper classes, and how to add a new plugin, read the `convention-plugin-development` skill.

## Adding a Dependency

1. Add version to `[versions]` in `gradle/libs.versions.toml`
2. Add library to `[libraries]` with `version.ref`
3. Use in module: `implementation(libs.your.library)`

```toml
# gradle/libs.versions.toml
[versions]
your-lib = "1.0.0"

[libraries]
your-library = { module = "com.example:library", version.ref = "your-lib" }
```

Never hardcode versions in `build.gradle.kts` files.

## Adding a New Module

1. Create module directory under appropriate parent (`core/`, `feature/`, etc.)
2. Create `build.gradle.kts` applying convention plugin:
   ```kotlin
   plugins {
       id("ripdpi.android.library")
   }
   android { namespace = "com.poyka.ripdpi.your.module" }
   ```
3. Add `include(":your:module")` to `settings.gradle.kts`
4. Add Compose plugin if needed: `id("ripdpi.android.compose")`

## Properties (Single Source of Truth)

All in `gradle.properties`:

| Property | Meaning |
|----------|---------|
| `ripdpi.compileSdk` | Android compile SDK; read the live value before selecting SDK packages or APIs |
| `ripdpi.minSdk` | Minimum supported Android API |
| `ripdpi.targetSdk` | Runtime-behavior target; changes require separate compatibility testing |
| `ripdpi.nativeNdkVersion` | Pinned Android NDK version |
| `ripdpi.nativeAbis` | Full CI/release ABI set |
| `ripdpi.localNativeAbisDefault` | Local ABI policy; `host` derives the ABI from the workstation architecture |

## Gotchas

- **build-logic is an included build** (`includeBuild("build-logic")` in settings). Changes to convention plugins require re-sync.
- **Static analysis**: Run `./gradlew staticAnalysis` -- it aggregates detekt, ktlint, and Android lint for the quality-enabled Android modules.
- **Native build order**: `:core:engine:buildRustNativeLibs` runs before `preBuild`. If native build fails, check NDK installation path, Rust target availability, and the `ripdpi.android.rust-native` convention plugin under `build-logic/convention/`.
- **Local ABI fast path**: local non-release builds follow `ripdpi.localNativeAbisDefault`; when it is `host`, Apple Silicon resolves to `arm64-v8a` and Intel hosts resolve to `x86_64`. Use `-Pripdpi.localNativeAbis=x86_64` for emulator-focused iteration.

## Common Mistakes

| Mistake | Fix |
|---------|-----|
| Adding plugin directly to module | Use convention plugin from `build-logic/` |
| Hardcoding version in build.gradle.kts | Add to version catalog `libs.versions.toml` |
| Changing SDK versions in module | Change in `gradle.properties`, convention plugins read it |
| Missing namespace in new library module | Required: `android { namespace = "com.poyka.ripdpi..." }` |

## See Also

- `convention-plugin-development` skill -- full plugin inventory, plugin internals, and how to author a new convention plugin.
- `dependency-update` skill -- version-catalog update workflows and cross-ecosystem (Gradle + Cargo) coordination.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall