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).
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
- Add version to
[versions]ingradle/libs.versions.toml - Add library to
[libraries]withversion.ref - Use in module:
implementation(libs.your.library)
# 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
- Create module directory under appropriate parent (
core/,feature/, etc.) - Create
build.gradle.ktsapplying convention plugin:plugins { id("ripdpi.android.library") } android { namespace = "com.poyka.ripdpi.your.module" } - Add
include(":your:module")tosettings.gradle.kts - 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:buildRustNativeLibsruns beforepreBuild. If native build fails, check NDK installation path, Rust target availability, and theripdpi.android.rust-nativeconvention plugin underbuild-logic/convention/. - Local ABI fast path: local non-release builds follow
ripdpi.localNativeAbisDefault; when it ishost, Apple Silicon resolves toarm64-v8aand Intel hosts resolve tox86_64. Use-Pripdpi.localNativeAbis=x86_64for 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-developmentskill -- full plugin inventory, plugin internals, and how to author a new convention plugin.dependency-updateskill -- 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: 197k | 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 |