Migration

Migration

Full guide: docs/MIGRATION.md. Summary below.

If your app depends on the now-broken upstream artifact:

implementation("com.arthenica:ffmpeg-kit-full:6.0")  // no longer resolves

It's a one-line fix — change the group ID, keep the artifact name:

- implementation("com.arthenica:ffmpeg-kit-full:6.0")
+ implementation("dev.ffmpegkit-maintained:ffmpeg-kit-full:8.1.7")

Whatever variant you had (full, https, min, audio, video, or a -gpl one), the artifact name is unchanged here — only the group ID and version change. No .aar download, no flatDir, no local file management.

1. Change the group ID

As above. Pick the exact version for the line you want: 8.1.7 (8.1 LTS), 7.1.6 (7.1 LTS), or 6.0.3 (6.0 LTS) — see Compatibility.

2. Rebuild clean

./gradlew --refresh-dependencies assembleDebug

--refresh-dependencies avoids duplicate-class errors if Gradle's cache still has a resolved copy of the old upstream artifact.

No call-site changes needed — same package (com.arthenica.ffmpegkit), same API surface, same com.arthenica:smart-exception-java runtime dependency (pulled in transitively). See Compatibility for what differs (ABI coverage, SDK levels) and docs/MIGRATION.md, Troubleshooting section, for common errors like duplicate-class issues from stale Gradle caches.