1023

How can I tell Gradle to redownload dependencies from repositories?

26 Answers 26

1101

Option 1: Use --refresh-dependencies flag

Generally, you can refresh dependencies in your cache with the command line option --refresh-dependencies.

Note that --refresh-dependencies won't always re-download every artifact; it will use existing copies if they match what exists in the repository. From the Gradle User Guide, refreshing dependencies:

The --refresh-dependencies option tells Gradle to ignore all cached entries for resolved modules and artifacts. A fresh resolve will be performed against all configured repositories, with dynamic versions recalculated, modules refreshed, and artifacts downloaded. However, where possible Gradle will check if the previously downloaded artifacts are valid before downloading again. This is done by comparing published SHA1 values in the repository with the SHA1 values for existing downloaded artifacts.

[...]

It’s a common misconception to think that using --refresh-dependencies will force download of dependencies. This is not the case: Gradle will only perform what is strictly required to refresh the dynamic dependencies. This may involve downloading new listing or metadata files, or even artifacts, but if nothing changed, the impact is minimal.

Option 2: Remove ~/.gradle/caches

You can also delete the cached files (artifacts and metadata) under ~/.gradle/caches. With the next build Gradle will attempt to download them again.

On *nix systems (Linux, macOS, ...), you can execute this command:

rm -rf $HOME/.gradle/caches/

After doing this, you might also need to kill the running Gradle Daemon:

./gradlew --stop 
16
  • 45
    I can't speak for the OP, but my specific use case is to test whether my configuration of a non-MavenCentral repository actually works. Commented Jun 24, 2013 at 8:15
  • 9
    You also need to remove ~/.m2 directory (if exists). If you have configured maven repo few of those artifacts get downloaded to ~/.m2 too. Better to remove both ~/.gradle and ~/.m2 to start on clean slate. Commented Jan 14, 2014 at 21:05
  • 19
    Maven Local is only relevant if your build defines it as a repository. Commented Jan 16, 2014 at 21:21
  • 38
    @Gopinath that is dangerous advice, as .m2 can contain a maven setting file. I guess you mean delete .m2/repository
    – Ward
    Commented Nov 5, 2015 at 8:28
  • 25
    find $HOME/.gradle/caches/ -name "*LIBRARY_NAME*" -exec rm -r {} \;
    – fangzhzh
    Commented Jan 8, 2016 at 3:42
1049

If you are using a recent version of Gradle, you can use --refresh-dependencies option.

./gradlew build --refresh-dependencies

you can refer to the Gradle manual.

The --refresh-dependencies option tells Gradle to ignore all cached entries for resolved modules and artifacts. A fresh resolve will be performed against all configured repositories, with dynamic versions recalculated, modules refreshed, and artifacts downloaded.

11
  • 15
    You have to be noted that since gradle will try to download all dependency file, it takes time long.
    – Naga
    Commented Aug 31, 2015 at 7:20
  • 11
    It's also worth noting that this doesn't always work. I just tested running "gradle clear war --refresh-dependencies" with a cached jar that was three days old, when I had deployed a new version late last night. The build broke because of a missing dependency that was added in the new code. I still had the three-day-old jar in the cache afterwards. I ended up just deleting the version folder in my .m2 cache and rebuilding. It then got the newest version because it basically had no choice! Commented Mar 22, 2016 at 16:05
  • 25
    better yet just ./gradlew --refresh-dependencies
    – headsvk
    Commented Mar 2, 2017 at 17:38
  • 2
    This worked great as './gradlew build --refresh-dependencies' from the Android Studio terminal. Thanks! Commented Jul 6, 2017 at 0:34
  • 4
    Is there a way to get Android Studio to do this on a build from inside the IDE?
    – karl
    Commented Jul 12, 2018 at 14:32
366

You can tell Gradle to re-download some dependencies in the build script by flagging the dependency as 'changing'. Gradle will then check for updates every 24 hours, but this can be configured using the resolutionStrategy DSL. I find it useful to use this for for SNAPSHOT or NIGHTLY builds.

configurations.all {
    // Check for updates every build
    resolutionStrategy.cacheChangingModulesFor 0, 'seconds'
}

Expanded:

dependencies {
    implementation group: "group", name: "projectA", version: "1.1-SNAPSHOT", changing: true
}

Condensed:

implementation('group:projectA:1.1-SNAPSHOT') { changing = true }

I found this solution at this forum thread.

17
  • 5
    Do you happen to know how this works for sources for the same library? Currently, the compiled library is downloaded every time it changes, but the source is not.
    – Markus
    Commented Feb 19, 2014 at 15:35
  • 4
    A snapshot version is "changing" by definition. Gradle knows that so you don't actually need to define this in your dependency declaration. Commented May 16, 2014 at 13:40
  • 4
    Thanks for this. FWIW, our dependency was on a snapshot version and until we did this it wasn't checking for updates on every build.
    – sfitts
    Commented Jul 9, 2014 at 0:54
  • 18
    cacheChangingModulesFor is the key, changing: true is optional because it's implied by -SNAPSHOT, it's possible to use the shorthand here: compile 'group:projectA:1.1-SNAPSHOT' because of the above implication. One can also restrict the resolutionStrategy to one config: configurations.compile.resolutionS....
    – TWiStErRob
    Commented Nov 10, 2014 at 13:15
  • 2
    @Umi Is there a condensed version of this? Such as compile 'com.burrowsapps:ads:1.0:true'? Commented Feb 29, 2016 at 6:44
78

For MAC

./gradlew build --refresh-dependencies

For Windows

gradlew build --refresh-dependencies

Can also try gradlew assembleDevelopmentDebug --refresh-dependencies

2
  • 3
    Android uses regular gradle. It's just a plugin.
    – Dragas
    Commented Feb 1, 2018 at 19:55
  • 1
    The Gradle wrapper is not an Android exclusive. You can generate one using gradle wrapper task; you can even generate a wrapper using another Gradle wrapper: gradlew wrapper
    – Salvioner
    Commented Nov 29, 2019 at 15:38
56

For Windows...in order to make gradle re-download specific dependencies:

  1. delete the dependencies you want to re-download from the directory below:

    C:\Users\%USERNAME%\.gradle\caches\modules-2\files-2.1
    
  2. delete all metadata directories at the path:

    C:\Users\%USERNAME%\.gradle\caches\modules-2\metadata-*
    
  3. run gradle build (or gradlew build if using gradle wrapper) in the project's root directory.

note: the numbers in the file paths above might be different for you.

2
  • 1
    Thank you, I was looking for a 1-time deletion of a specific dependency to re-download. This is also the same on the mac: ~/.gradle/caches/modules-2/files-2.1
    – slycrel
    Commented Jun 15, 2020 at 23:33
  • I didn't find any metadata folder but deleting specific dependency in modules-2\files-2.1 was enough. Thanks! Commented Mar 17, 2022 at 20:19
30

None of the solutions above worked for me.

If you use IntelliJ, what resolved it for me was simply refreshing all Gradle projects:

enter image description here

2
  • 2
    You can also refresh dependencies in IntelliJ from the same view stackoverflow.com/a/69584756/1261166 Commented Oct 15, 2021 at 12:29
  • What's the equivalent command of that button? I've disabled the gradle plugin for performance problems and would like to be able to run that from the terminal
    – AlexPera
    Commented Jan 16 at 16:19
28

For those who are wondering where to run gradle commands:

  1. Open Android Studio
  2. Click on Terminal(You will find it in the base of Android Studio)
  3. The command tool will open
  4. Type your command ./gradlew build --refresh-dependencies
0
25

One can remove folder with cached jars.

In my case, on Mac the library was cached at path:

/Users/MY_NAME/.gradle/caches/modules-2/files-2.1/cached-library-to-remove

I removed the cached library folder ("cached-library-to-remove" in above example), deleted the build folder of my project and compiled again. Fresh library was downloaded then.

23

To refresh cached 'release' version the only option is to clear local cache.

rm -rf $HOME/.gradle/caches/

To refresh cached 'snapshot' version you can:

./gradlew build --refresh-dependencies
18

Instead of removing your entire gradle cache, like some answers here are suggesting, you can delete the cache for a specific group or artifact id. I added the following function to my .bash_profile:

deleteGradleCache() {
  local id=$1
  if [ -z "$id" ]; then
    echo "Please provide an group or artifact id to delete"
    return 1
  fi
  find ~/.gradle/caches/ -type d -name "$id" -prune -exec rm -rf "{}" \; -print
}

Usage:

$ deleteGradleCache com.android.support

Then, on the next build or if you resync, gradle will re-download dependencies.

16

If you are using Intellij, you can right click the root project and then select refresh gradle dependencies.

enter image description here

1
  • 4
    To get to the above menu, at the top click: View -> Tool Windows -> Gradle. Then right click on the root project from that Gradle window and you will see the above dialog box.
    – Freddie
    Commented Feb 28, 2023 at 12:56
15

There is 2 ways to do that:

  1. Using command line option to refresh dependenices cashe.
  2. You can delete local cache where artefasts are caches by Gradle and trigger build

Using --refresh-dependencies option:

./gradlew build --refresh-dependencies

Short explanation --refresh-dependencies option tells Gradle to ignore all cached entries for resolved modules and artifacts.

Long explanantion

  • WIth –refresh-dependencies’ Gradle will always hit the remote server to check for updated artifacts: however, Gradle will avoid downloading a file where the same file already exists in the cache.
    • First Gradle will make a HEAD request and check if the server reports the file as unchanged since last time (if the ‘content-length’ and ‘last-modified’ are unchanged). In this case you’ll get the message: "Cached resource is up-to-date (lastModified: {})."
    • Next Gradle will determine the remote checksum if possible (either from the HEAD request or by downloading a ‘.sha1’ file).. If this checksum matches another file already downloaded (from any repository), then Gradle will simply copy the file in the cache, rather than re-downloading. In this case you’ll get the message: "“Found locally available resource with matching checksum: [{}, {}]”.

Using delete: When you delete caches

rm -rf $HOME/.gradle/caches/

You just clean all the cached jars and sha1 sums and Gradle is in situation where there is no artifacts on your machine and has to download everything. Yes it will work 100% for the first time, but when another SNAPSHOT is released and it is part of your dependency tree you will be faced again in front of the choice to refresh or to purge the caches.

15

Seems change is changed to isChange for gradle version 6.3, kotlin version 1.3.70, Groovy 2.5.10

The working configuration is

implementation("com.sample:commons:1.0.0-SNAPSHOT") {
        isChanging = true
    }

Also, run this command to fetch the latest

./gradlew assemble  --refresh-dependencies
1
  • 2
    Very usefull, thanks. Furthermore, if anyone else is using IntelliJ like me, sometimes I have to close and reopen after this refresh.
    – heringer
    Commented Jul 28, 2021 at 13:13
13

For Android Studio 3.4.1

Simply open the gradle tab (can be located on the right) and right-click on the parent in the list (should be called "Android"), then select "Refresh dependencies".

This should resolve your issue.

1
  • didnt work for me. could be case to case
    – chitgoks
    Commented Feb 16, 2022 at 2:02
10

This worked for me. Make sure Gradle is not set to offline by unchecking button at File>Settings>Gradle>Offline Work.

Add this to the top level of your build.gradle, nice to have above dependencies

configurations.all {
    resolutionStrategy.cacheChangingModulesFor 0, 'seconds'
}

I made sure my dependencies are written like this:

implementation('com.github.juanmendez:ThatDependency:ThatBranch-SNAPSHOT') {
    changing = true
}

Thereafter, I open the Gradle panel in Android Studio and click the blue circle arrows button. I can always see my updates getting a new fresh copy.

6

In my case none of the above worked, what I did was:

  • In build.gradle, commenting the dependencies related to the unresolved imports I had
  • Clicking "Sync Now"
  • Uncommenting what I just commented
  • Clicking "Sync Now" again

Then my imports were properly resolved again.

1
  • 2
    This was the only thing here worked for me. Thank you!
    – David G
    Commented Jun 24, 2020 at 7:51
5

Mb I'm too late however my solution is for single repository. I think deleting ~/.gradle/* is overkill. The problmem I've bumped into was that I was deleting directory where sources were and gradle was getting another version not from nexus. To avoid that I run the next:

~/.gradle$ find . -type d -name 'group.plugins.awssdk'
./caches/modules-2/files-2.1/group.plugins.awssdk
./caches/modules-2/metadata-2.23/descriptors/group.plugins.awssdk

~/.gradle$ rm -r ./caches/modules-2/files-2.1/group.plugins.awssdk   ./caches/modules-2/metadata-2.23/descriptors/group.plugins.awssdk

After that gradle is dragging files from nexus.

3

Deleting all the caches makes download all the dependacies again. so it take so long time and it is boring thing wait again again to re download all the dependancies.

How ever i could be able to resolve this below way.

Just delete groups which need to be refreshed.

Ex : if we want to refresh com.user.test group

rm -fr ~/.gradle/caches/modules-2/files-2.1/com.user.test/

then remove dependency from build.gradle and re add it. then it will refresh dependencies what we want.

2

This is for Kotlin DSL (build.gradle.kts):

configurations.all {
    resolutionStrategy.cacheChangingModulesFor(0, TimeUnit.SECONDS)
}
dependencies {
    // ...
    implementation("ir.mahozad.multiplatform:wavy-slider:1.0.0") {
        isChanging = true
    }
}
0

I think gradle 2.14.1 fixes the issue. The accepted answer is correct, but there is a bug in gradle with –refresh-dependencies. 2.14.1 fixes that.

See https://discuss.gradle.org/t/refresh-dependencies-should-use-cachechangingmodulesfor-0s/556

0

For the majority of cases, just simply re-building the project should do the trick. Sometimes you have to run ./gradlew build --refresh-dependencies as several answers have already mentioned (takes a long time, depending on how much dependencies you have). How ever, sometimes none of those will work: the dependency just won't get updated. Then, you can do this:

  1. Remove dependency from your gradle file
  2. Run / debug your project and wait for it to fail (with NonExistingClass reason)
  3. Hit "build project" and wait for it to finish successfully
  4. Run / debug once again

This is ridiculous and seems like madness, but I actually do use this procedure daily, simply because the dependency I need can be updated dozens of times and none of adequate solutions would have any effect.

0

If you are using eclipse and if you want force eclipse to re load dependencies you could try below command

gradlew clean cleaneclipse build eclipse --refresh-dependencies
0
0

Only a manual deletion of the specific dependency in the cache folder works... an artifactory built by a colleague in enterprise repo.

-1

You can do it like this

https://marschall.github.io/2017/04/17/disabling-gradle-cache.html

To quote from Disabling the Gradle Build Cache

The Gradle build cache may be a great thing when you’re regularly building >large projects with Gradle. However when only occasionally building open source >projects it can quickly become large.

To disable the Gradle build cache add the following line to ~/.gradle/gradle.properties

org.gradle.caching=false

You can clean the existing cache with

rm -rf $HOME/.gradle/caches/
rm -rf $HOME/.gradle/wrapper/
2
  • 1
    That's not really the cache we were looking for here ...
    – SamB
    Commented Jul 15, 2022 at 19:27
  • FYI, youtu.be/nHb0kIcTrFE nicely explains the different types of caches present in Gradle.
    – Leponzo
    Commented Jun 12, 2023 at 17:13
-3

delete this directory:

C:\Users\[username]\.gradle
1
  • 3
    Given that there are potentially local configurations, deleting, (or renaming/relocating) the caches directory as mentioned in other answers is a better solution. Commented Oct 16, 2017 at 17:30
-8

You need to redownload it, so you can either manually download and replace the corrupted file and again sync your project . Go to this location C:\users[username].gradle\wrapper\dist\gradle3.3-all\55gk2rcmfc6p2dg9u9ohc3hw9\gradle-3.3-all.zip Here delete gradle3.3allzip and replace it by downloading again from this site https://services.gradle.org/distributions/ Find the same file and download and paste it to that location Then sync your project. Hope it works for you too.

0

Not the answer you're looking for? Browse other questions tagged or ask your own question.