IDE Android Studio를 사용하는 프로그래머 는 코드를 컴파일하거나 Android 기기 (실제 또는 에뮬레이션)에서 실행할 때 ' Gradle Project Sync Failed ' 라는 오류 메시지가 표시 됩니다. Gradle Sync는 Android 스튜디오 프로젝트와 연결된 build.gradle 파일의 모든 종속성을 확인한 다음 지정된 버전을 다운로드하는 (아직 다운로드하지 않은 경우) 주요 기능인 Gradle 작업입니다 .
이 오류 메시지가 발생할 수있는 다양한 변형이 있습니다. Gradle 컴파일이 작동하지 않는 복잡한 문제에 대한 인터넷 연결과 같은 간단한 문제에 직면 할 수 있습니다. 이 기사에서는이 문제가 발생하는 이유에 대한 모든 원인을 살펴본 다음 해결 방법으로 이동합니다.
Android Studio에서 "Gradle Project Sync Failed"라는 오류 메시지의 원인은 무엇입니까?
앞서 언급했듯이 Gradle 프로젝트가 컴파일 또는 동기화에 실패 할 수있는 몇 가지 이유가 있습니다. 다음은 몇 가지 원인입니다 (각 원인이 적용되지 않을 수 있음).
- 잘못된 인터넷 연결 : Gradle은 프로젝트를 실행하는 데 필요한 누락 된 버전을 모두 다운로드하므로 유효한 인터넷 연결이 없으면 실패 할 수 있습니다.
- Gradle 컴파일러의 문제 : Gradle 컴파일러가 제대로 작동하지 않는 경우가있을 수 있습니다. 여기서 수동으로 Gradle을로드하고 이것이 트릭을 수행하는지 확인할 수 있습니다.
- Android Studio의 잘못된 캐시 : Android Studio는 제대로 작동하기 위해 컴퓨터의 캐시를 사용합니다. 경우에 따라 손상되어 여러 모듈 (Gradle 포함)에서 문제가 발생할 수 있습니다.
- 누락 된 파일 : Gradle을 실행하는 데 필요한 누락 된 파일이있을 수도 있습니다. 설치하면 문제가 즉시 해결됩니다.
- 프록시 서버 : 프록시 서버가 점점 인기를 얻고 있지만 Gradle이 제대로 동기화되지 않는 경우가있었습니다. 프록시 서버를 비활성화하면 문제가 해결됩니다.
솔루션을 시작하기 전에 현재 프로젝트의 백업이 있는지 확인하십시오. 만일을 대비하여 파일을 저장하고 다른 곳에 사본을 만드십시오. 또한 컴퓨터에 관리자로 로그인했는지 확인하십시오.
해결 방법 1 : 인터넷 연결 확인
Gradle을 사용하려면 컴퓨터에 인터넷이 연결되어 있어야합니다. 주요 작업은 컴퓨터에없는 인터넷에서 필요한 모든 버전을 다운로드하는 것이므로 적절한 인터넷 연결이 필수입니다. 또한 다른 장치를 동일한 네트워크에 연결하여 연결을 확인합니다. 이것이 문제가 아니라는 확신이 들면 다른 솔루션으로 이동할 수 있습니다.
해결 방법 2 : 프록시 서버 비활성화
프록시 서버는 조직 및 기타 기관에서 현재 대역폭을 높이고 모든 사용자에게 더 나은 인터넷 액세스를 제공하는 데 사용되는 일상화되고 있습니다. 그러나 프록시 서버에는 한계가 있습니다. 그중 하나는 동기화 모듈이 필요에 따라 작동하지 않는 문제를 포함합니다. 여기에는 Gradle도 포함됩니다. 다음은 프록시 서버를 사용하고 있지 않은지 확인하는 방법입니다.
- Windows + R을 누르고 " inetcpl. cpl ”을 입력하고 Enter를 누릅니다.
- 이제 인터넷 속성 이 열립니다. 연결 탭을 클릭 한 다음 LAN 설정을 클릭합니다 .
- 이제 프록시 서버를 사용하는 경우 내부 세부 정보와 함께 필드가 확인됩니다. 활성화 된 경우 프록시 서버를 선택 취소 합니다. 이제 Android Studio를 다시 시작하고 문제가 해결되었는지 확인하십시오.
해결 방법 3 : 누락 된 구성 요소 설치
더 기술적 인 방법에 빠지기 전에 Gradle 동기화에 필요한 일부 모듈이 누락되었는지 확인해야합니다. Gradle 자체는 독립형이 아니며 제대로 작동하려면 다른 서비스도 필요합니다.
이제 Gradle을 동기화하려고 할 때 오류 메시지가 나타날 때마다 Install missing platform (s) and sync project 제목이있는 문제 아래에 하이퍼 링크 가 있는지 확인합니다 . 링크를 클릭하면 Android Studio가 다운로드 프로세스를 시작하고 누락 된 모든 것을 설치합니다. 지금 프로젝트를 동기화하여 문제가 해결되는지 확인하십시오.
솔루션 4 : 로컬 Gradle 배포 활용
프로젝트를 빌드하고 Gradle이 활성화 될 때마다 최신 온라인 배포에 연결하고 여기에서 필요한 모든 모듈 또는 버전을 다운로드합니다. 온라인 배포가 예상대로 작동하지 않고 Gradle 동기화에 실패한 몇 가지 사례를 발견했습니다. 이 문제에 대한 또 다른 해결 방법은 Gradle 배포를 수동으로 다운로드하여 사용하는 것입니다. 아래 단계를 따르십시오.
- 공식 Gradle 릴리스 웹 사이트에서 최신 버전의 Gradle을 다운로드하십시오.
- 다운로드 후 모든 파일을 액세스 가능한 폴더에 추출하십시오.
- 이제 Android Studio를 시작 하고 File> Settings> Build, Execution, Deployment> Gradle로 이동 합니다.
- 이제 Local Gradle Distribution 옵션을 선택하십시오 . 또한 Gradle 홈에서 방금 파일을 추출한 경로를 가리 킵니다.
참고 : 전역 Gradle 설정에서 오프라인 작업 을 사용하는 경우 해당 옵션을 선택 취소하십시오 .
- 이제 프로젝트를 빌드하고 Gradle이 제대로 동기화되는지 확인하십시오. 새 프로젝트를 만들 때마다이 단계를 반복해야합니다.
해결 방법 5 : GPU 디버거 활성화
GPU 디버거를 사용하면 OpenGL ES 응용 프로그램을 디버깅하고 분석 할 수 있습니다. GPU 상태를 검사하고 렌더링 결과의 원인을 이해할 수있는 여러 기능이 있습니다. 일부 Gradle 빌드 인스턴스에는 이것이 활성화되지 않은 시스템에 버그가 있습니다. 이 솔루션에서는 모듈을 강제로 새로 고치고이 구성 요소를 설치합니다.
- 도구를 클릭 한 다음 Android> SDK 관리자 를 선택 합니다.
- 이제 SDK 도구 탭을 클릭 한 다음 Android SDK Build-Tools 옵션 을 선택 취소 합니다 . 5 초 정도 기다린 후 옵션을 다시 활성화하십시오.
- 이제 목록이 새로 고쳐지고 항목이 채워질 때까지 잠시 기다리십시오.
- 새 항목이 채워지면 목록을보고 GPU 디버깅 도구 옵션을 확인 합니다 . 완료되면 확인을 누릅니다.
이제 이러한 도구가 Android Studio 애플리케이션에 다운로드되고 문제없이 Gradle을 올바르게 동기화 할 수 있습니다.
해결 방법 6 : 캐시 새로 고침
Microsoft Windows를 포함한 모든 응용 프로그램에는 응용 프로그램이 문제없이 원활하게 실행될 수 있도록 모든 곳에 캐시가 있습니다. 애플리케이션이 나중에 선택할 수 있도록 기본 설정 또는 임시 데이터를 저장하는 임시 저장소 역할을합니다. 이 캐시가 손상된 경우 gradle 빌드 프로세스를 중단 할 것으로 확인했습니다. 이 솔루션에서는 전체 캐시를 새로 고치고 기존 Gradle 파일을 삭제 한 후 Android Studio를 다시 시작하고 문제가 해결되는지 확인합니다.
- 파일로 이동하여 캐시 무효화 / 다시 시작을 클릭 합니다 .
- 이제 프로세스가 완료되면 Android Studio를 완전히 종료하십시오.
- Android Studio 설치 디렉터리의 .gradle 폴더로 이동합니다. 이제 다른 위치로 잘라내거나 붙여 넣거나 이름을 바꿀 수 있습니다.
이제 Android 스튜디오가 Gradle 파일에 액세스하려고 할 때 존재하는 파일이 없음을 확인하고 전체 파일을 다시 다운로드하려고 시도합니다.
- Android Studio를 다시 시작 하고 Gradle 동기화를 다시 시도하십시오. 이제 문제가 해결되었는지 확인하십시오.
