안드로이드 스튜디오 - gradle project sync failed. basic functionality (e.g. editing debugging) will not work properly 에러 해결방법
안드로이드 스튜디오를 update하거나 잘못 만지면 gradle project sync failed. 오류가 뜰 때가 있습니다.
얼마전 안드로이드 스튜디오 update를 한 뒤에 위와 같은 에러가 발생했는데 이때 해결한 방법을 공유하고자 합니다.
프로그램 작성중에 안드로이드 스튜디오 4.0 업데이트를 하라는 팝업창이 떠서 할까말까 고민하다가 업데이트를 진행했는데 이때 업데이트를 하는 도중에 안드로이드 스튜디오 종료 버튼을 눌러서인지 다시 안드로이트 스튜디오를 실행시켰더니 gradle project sync failed. basic functionality (e.g.editing debuggin) will not work properly 에러가 나면서 프로그램 작성을 더이상 진행 할 수가 없었습니다.
구글링해서 이것저것 해봤는데 대부분 소용이 없었고 안드로이드 스튜디오를 삭제하고 다시 설치해야하나 잠시 고민하다가 제가 해결한 방법은 사용자 폴더에 있는 .gradle 폴더를 삭제하고 안드로이드 스튜디오를 재시작하는것입니다.
그러면 사용자 폴더에 있던 .gradle 폴더가 다시 생기고 이후에 gradle을 update하게 되면 대부분의 문제가 해결 되는것 같습니다.
[안드로이드 스튜디오 gradle project sync failed. 에러 해결 방법 요약]
1. 안드로이드 스튜디오를 종료한다.
2. 자신의 사용자 폴더에서 .gradle 폴더를 찾는다.
- [C:\] 드라이브의 [사용자] 폴더 안에 [본인의 사용자이름] 폴더안에 .gradle 폴더가 있음
(ex, C:/Uses/user/.gradle)
3. .gradle 폴더를 삭제한다.
- 만약을 대비해서 .gradle폴더 이름을 .backup_gradle로 변경하여 백업해 놓으면 좋을것 같네요
4. 안드로이드 스튜디오를 재시작한다.
- 이때 gradle 관련 정보를 다시 다운로드 받으면서 .gradle 폴더가 다시 생성됩니다.
- 정상적으로 .gradle 폴더가 생성되었으면 gradle project sync failed. 에러는 사라집니다.
5. 안드로이드 스튜디오 팝업창의 gradle update를 실행한다.
- 오른쪽 하단 팝업창에 gradle관련 update를 하라는 메시지가 나오면 클릭하면 update를 진행합니다.
Help -> Check for Updates... 를 클릭하여 최신버전으로 설치되었는지 확인하여 최신버전으로 사용하시면 되겠습니다.
Good luck~