po4yka/RIPDPI / .agents/skills/dependency-update
dependency-update
VerifiedBump a Gradle or Rust dependency version. Use when editing libs.versions.toml, native/rust/Cargo.toml, or reviewing a Renovate PR. Not for adding a module or plugin (gradle-build-system, convention-plugin-development).
Dependency Update
Two dependency ecosystems (Gradle + Cargo) with Renovate automating PR creation.
Gradle Version Catalog
File: gradle/libs.versions.toml
Values below are illustrative placeholders only -- always read the live pins from gradle/libs.versions.toml before reporting or bumping a version; they change independently of this skill.
Structure:
[versions]
agp = "X.Y.Z"
kotlin-compose = "X.Y.Z"
compose-bom = "YYYY.MM.NN"
[libraries]
androidx-core = { group = "androidx.core", name = "core-ktx", version.ref = "androidxCore" }
[plugins]
android-application = { id = "com.android.application", version.ref = "agp" }
[bundles]
lifecycle = ["lifecycle-runtime", "lifecycle-viewmodel"]
Rule: Always update the version in the [versions] section. Never inline a version in [libraries] or [plugins].
Key Version Groups
| Group | Versions to Update Together |
|---|---|
| Kotlin / Compose plugin | kotlin-compose and its compatible KSP entry |
| Compose | compose-bom (single BOM controls Compose libraries) |
| AndroidX | Individually, but Renovate groups them |
| AGP | agp (may require Gradle wrapper update) |
| Testing | junit, robolectric, roborazzi independently |
Rust Dependencies
File: native/rust/Cargo.toml (workspace root)
Dependencies declared in [workspace.dependencies] are inherited by crates via { workspace = true }:
[workspace.dependencies]
tokio = { version = "1.45", features = ["full"] }
serde = { version = "1", features = ["derive"] }
Update a specific crate:
cd native/rust
cargo update -p tokio
Update all:
cd native/rust
cargo update
Renovate Configuration
File: renovate.json
Grouping rules:
- AndroidX packages grouped into a single PR
- Kotlin + Compose Compiler grouped together
- Static analysis (detekt, ktlint) grouped together
- All dependency PRs labeled
dependencies - Git submodules enabled
Update Workflows
Single Gradle Dependency
# 1. Edit version in libs.versions.toml
# 2. Verify
./gradlew assembleDebug && ./gradlew testDebugUnitTest
AGP / Gradle Upgrade
# 1. Update agp version in libs.versions.toml
# 2. May need Gradle wrapper update:
./gradlew wrapper --gradle-version=X.Y.Z
# 3. Full verification:
./gradlew assembleDebug testDebugUnitTest staticAnalysis
Kotlin Version Update
Update all three together in libs.versions.toml:
kotlin(Kotlin compiler)ksp(must match Kotlin major.minor)kotlinComposeCompiler(Compose compiler plugin)
./gradlew assembleDebug testDebugUnitTest staticAnalysis
Rust Dependency Update
cd native/rust
cargo update -p <crate-name>
cargo test --locked
cargo clippy --locked --workspace --all-targets -- -D warnings
# Rebuild Android libs to verify cross-compilation:
cd ../.. && ./gradlew :core:engine:buildRustNativeLibs
NDK Version Update
NDK changes affect both ecosystems:
- Update
ripdpi.nativeNdkVersioningradle.properties - Verify Rust cross-compilation targets still work:
./gradlew :core:engine:buildRustNativeLibs - Full test suite:
./gradlew assembleDebug testDebugUnitTest cd native/rust && cargo test --locked
Rust Toolchain Update
- Update
channelinnative/rust/rust-toolchain.toml - Verify CI workflow uses the same version (reads from
rust-toolchain.toml) - Run:
cd native/rust && cargo test --locked && cargo clippy --locked --workspace
Cross-Ecosystem Dependencies
| Change | Affects |
|---|---|
| NDK version | gradle.properties + Rust cross-compilation targets |
| Rust toolchain | rust-toolchain.toml + CI workflow setup |
| JNI API changes | Kotlin bindings in core/engine + Rust crates ripdpi-android, ripdpi-tunnel-android |
Verification Checklist
After any update, run in order:
./gradlew assembleDebug # Kotlin compilation
./gradlew testDebugUnitTest # Unit tests
./gradlew staticAnalysis # detekt + ktlint + lint
cd native/rust && cargo test --locked # Rust tests
cd ../.. && ./gradlew :core:engine:buildRustNativeLibs # Cross-compilation
Common Mistakes
| Mistake | Fix |
|---|---|
Inline version in [libraries] instead of [versions] | Always use version.ref pointing to [versions] entry |
| Updating Kotlin without KSP | KSP version must match Kotlin major.minor. Update together. |
Forgetting Cargo.lock | Cargo.lock is committed for reproducible builds. Run cargo update and commit the lock file. |
| NDK update without rebuilding native libs | NDK changes require ./gradlew :core:engine:buildRustNativeLibs to verify. |
| Updating Compose libs individually | Use composeBom version -- single BOM controls all Compose library versions. |
| Rust toolchain update without CI check | CI reads rust-toolchain.toml -- verify the version exists and targets are available. |
See Also
gradle-build-systemskill -- convention plugins and dependency management patterns.ci-workflow-authoringskill -- CI environment setup that depends on these versions.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |