Skip to content

po4yka/RIPDPI / .agents/skills/dependency-update

dependency-update

Verified

Bump 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

GroupVersions to Update Together
Kotlin / Compose pluginkotlin-compose and its compatible KSP entry
Composecompose-bom (single BOM controls Compose libraries)
AndroidXIndividually, but Renovate groups them
AGPagp (may require Gradle wrapper update)
Testingjunit, 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:

  1. Update ripdpi.nativeNdkVersion in gradle.properties
  2. Verify Rust cross-compilation targets still work:
    ./gradlew :core:engine:buildRustNativeLibs
    
  3. Full test suite:
    ./gradlew assembleDebug testDebugUnitTest
    cd native/rust && cargo test --locked
    

Rust Toolchain Update

  1. Update channel in native/rust/rust-toolchain.toml
  2. Verify CI workflow uses the same version (reads from rust-toolchain.toml)
  3. Run: cd native/rust && cargo test --locked && cargo clippy --locked --workspace

Cross-Ecosystem Dependencies

ChangeAffects
NDK versiongradle.properties + Rust cross-compilation targets
Rust toolchainrust-toolchain.toml + CI workflow setup
JNI API changesKotlin 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

MistakeFix
Inline version in [libraries] instead of [versions]Always use version.ref pointing to [versions] entry
Updating Kotlin without KSPKSP version must match Kotlin major.minor. Update together.
Forgetting Cargo.lockCargo.lock is committed for reproducible builds. Run cargo update and commit the lock file.
NDK update without rebuilding native libsNDK changes require ./gradlew :core:engine:buildRustNativeLibs to verify.
Updating Compose libs individuallyUse composeBom version -- single BOM controls all Compose library versions.
Rust toolchain update without CI checkCI reads rust-toolchain.toml -- verify the version exists and targets are available.

See Also

  • gradle-build-system skill -- convention plugins and dependency management patterns.
  • ci-workflow-authoring skill -- CI environment setup that depends on these versions.
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 implementationStars: 319kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 319kUpdated Claude CodeCodexVerifiedInstall
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 fallbackStars: 319kUpdated Claude CodeCodexVerifiedInstall
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 alwaysStars: 319kUpdated Claude CodeCodexVerifiedInstall