Flutterのバージョン変更時にタイムアウトエラーが発生した

Flutterでバージョンを変更して、初回実行（ビルド）時にタイムアウトエラーが発生しました。

Gradle threw an error while downloading artifacts from the network.

解決までの手順を記録します。

そもそものバージョン変更に至った経緯としては、以下ページの事象が発生したため、その対応のためです。

エラー内容と要因

まず、今回発生したエラーの内容は以下のとおり

Launching lib/main.dart on Android SDK built for arm64 in debug mode…

Exception in thread “main” java.lang.RuntimeException: Timeout of 120000 reached waiting for exclusive access to file: /path/to/.gradle/wrapper/dists/gradle-8.8-all/6gdy1pgp427xkqcjbxw3ylt6h/gradle-8.8-all.zip

at org.gradle.wrapper.ExclusiveFileAccessManager.access(ExclusiveFileAccessManager.java:61)

at org.gradle.wrapper.Install.createDist(Install.java:48)

at org.gradle.wrapper.WrapperExecutor.execute(WrapperExecutor.java:128)

at org.gradle.wrapper.GradleWrapperMain.main(GradleWrapperMain.java:61)

[!] Gradle threw an error while downloading artifacts from the network.

Retrying Gradle Build: #1, wait time: 100ms

読めばわかりますが、タイムアウトが発生していて、その原因として濃厚なのがネットワークが弱いことです。

エラー発生時私は外出先でモバイルルーターを使っていました。
電波がなさそうな表示になっていたので、多分それが原因です。

対処手順

ネットワークのちゃんとしたところで再実施しましょう（）
それでDone. と言えれば良いのですが、私の場合そうはいきませんでした。

再実施でダメな人は、gradleファイルの削除が必要。

タイムアウトして中途半端な状態でファイルが残っていると、以降も同様の事象が発生してしまうことがあるようです。

Exception in thread “main” java.lang.RuntimeException: Timeout of 120000 reached waiting for exclusive access to file: /path/to/.gradle/wrapper/dists/gradle-8.8-all/6gdy1pgp427xkqcjbxw3ylt6h/gradle-8.8-all.zip

エラーから抜粋しましたが、私の環境ではこの場所に削除対象のファイルがあります。

私の環境において今回削除するのは/path/to/.gradle/wrapper/dists/にあるgradle-8.8-allフォルダです。

もし.gradle/caches/に8.8のように、対象と同じバージョンのキャッシュファイルがある場合は、それも削除しておくと良いかも。

そのうえで再度実行。$flutter cleanとか$flutter pub getとか必要に応じてやってください。

これで完了です。遅いネットワークのままだったら同じ事象が発生するのであしからず。