po4yka/RIPDPI / .agents/skills/gradle-build-system
gradle-build-system
VerifiedAdd 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).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.4 KB |
SKILL.md
View on GitHub---
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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |