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).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.4 KB |
SKILL.md
View on GitHub---
name: dependency-update
description: 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:
```toml
[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 }`:
```toml
[workspace.dependencies]
tokio = { version = "1.45", features = ["full"] }
serde = { version = "1", features = ["derive"] }
```
Update a specific crate:
```bash
cd native/rust
cargo update -p tokio
```
Update all:
```bash
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
```bash
# 1. Edit version in libs.versions.toml
# 2. Verify
./gradlew assembleDebug && ./gradlew testDebugUnitTest
```
### AGP / Gradle Upgrade
```bash
# 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)
```bash
./gradlew assembleDebug testDebugUnitTest staticAnalysis
```
### Rust Dependency Update
```bash
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:
```bash
./gradlew :core:engine:buildRustNativeLibs
```
3. Full test suite:
```bash
./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
| 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:
```bash
./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-system` skill -- convention plugins and dependency management patterns.
- `ci-workflow-authoring` skill -- 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | 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: 322k | 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: 322k | Updated | Claude CodeCodex | Verified | Install |