수정 : Gradle 프로젝트 동기화 실패
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. 대화 상자에서 "를 클릭하고 Enter를 누르십시오.
- 이제 인터넷 속성 이 열립니다. 연결 탭을 클릭 한 다음 LAN 설정을 클릭하십시오.
- 이제 프록시 서버를 사용하는 경우 세부 정보가 포함 된 필드가 확인됩니다. 사용 가능한 경우 프록시 서버를 선택 취소 하십시오. 이제 Android Studio를 다시 시작하고 문제가 해결되었는지 확인하십시오.
해결 방법 3 : 누락 된 구성 요소 설치
좀 더 기술적 인 방법에 빠지기 전에 Gradle 동기화에 필요한 일부 모듈이 없는지 확인해야합니다. Gradle은 독립형이 아니며 제대로 수행하려면 다른 서비스가 필요합니다.
이제 Gradle을 동기화하려고 할 때마다 오류 메시지가 표시되면 누락 된 플랫폼 설치 및 프로젝트 동기화 라는 제목 아래에 하이퍼 링크 가 있는지 확인하십시오. 링크를 클릭하면 Android Studio가 다운로드 프로세스를 시작하고 누락 된 모든 것을 설치합니다. 지금 프로젝트를 동기화하고 문제가 해결되는지 확인하십시오.
해결 방법 4 : 로컬 Gradle 배포 활용
프로젝트를 빌드하고 Gradle이 활성화 될 때마다 최신 온라인 배포에 연결되어 필요한 모든 모듈 또는 버전을 다운로드합니다. 우리는 온라인 배포가 예상대로 작동하지 않고 Gradle 동기화에 실패한 몇 가지 사례를 발견했습니다. 이 문제의 또 다른 해결 방법은 Gradle 배포를 수동으로 다운로드하여 사용하는 것입니다. 아래 단계를 따르십시오.
- 공식 Gradle Release Website에서 최신 버전의 Gradle을 다운로드하십시오.
- 다운로드 후 모든 파일을 액세스 가능한 폴더로 추출하십시오.
- 이제 Android Studio를 시작하고 파일> 설정> 빌드, 실행, 배포> Gradle로 이동하십시오 .
- 이제 로컬 Gradle 배포 옵션을 선택하십시오. 또한 Gradle 홈에있을 때 방금 파일을 추출한 경로를 가리 킵니다.
참고 : 전역 Gradle 설정에서 오프라인 작업 을 사용하는 경우 해당 옵션을 선택 취소하십시오 .
- 이제 프로젝트를 빌드하고 Gradle이 올바르게 동기화되는지 확인하십시오. 새 프로젝트를 만들 때마다이 단계를 반복해야합니다.
해결 방법 5 : GPU 디버거 활성화
GPU 디버거를 사용하면 OpenGL ES 응용 프로그램을 디버깅하고 분석 할 수 있습니다. GPU 상태를 검사하고 렌더링 결과의 원인을 이해할 수있는 몇 가지 기능이 있습니다. 일부 Gradle 빌드 인스턴스에서는 이것이 활성화되지 않은 시스템에 몇 가지 버그가 있습니다. 이 솔루션에서는 모듈이이 구성 요소를 새로 고치고 설치하도록합니다.
- 도구를 클릭 한 다음 Android> SDK 관리자 를 선택하십시오.
- 이제 SDK 도구 탭을 클릭 한 다음 Android SDK Build-Tools 옵션을 선택 취소 하십시오. 약 5 초 동안 기다린 후 옵션을 다시 활성화하십시오.
- 이제 목록이 새로 고쳐지고 항목이 채워질 때까지 잠시 기다리십시오.
- 새 항목이 채워지면 목록을보고 GPU 디버깅 도구 옵션을 확인 하십시오. 완료되면 OK를 누릅니다.
이제 이러한 도구가 Android Studio 애플리케이션으로 다운로드되며 문제없이 Gradle을 올바르게 동기화 할 수 있습니다.
해결 방법 6 : 캐시 새로 고침
Microsoft Windows를 포함한 모든 응용 프로그램에는 아무 문제없이 응용 프로그램이 원활하게 실행되도록 캐시가 어디에나 있습니다. 응용 프로그램은 나중에 선택할 수 있도록 기본 설정 또는 임시 데이터를 저장하는 임시 저장소 역할을합니다. 이 캐시가 손상되면 gradle 빌드 프로세스가 중단된다고 판단했습니다. 이 솔루션에서는 전체 캐시를 새로 고치고 기존 Gradle 파일을 삭제 한 후 Android Studio를 다시 시작하여 문제가 해결되는지 확인합니다.
- 파일로 이동하여 캐시 무효화 / 다시 시작을 클릭 하십시오 .
- 이제 프로세스가 완료되면 Android Studio를 완전히 종료하십시오.
- Android Studio 설치 디렉토리의 .gradle 폴더로 이동하십시오. 이제 다른 위치로 잘라내거나 붙여 넣거나 간단히 이름을 바꿀 수 있습니다.
이제 Android Studio가 Gradle 파일에 액세스하려고하면 존재하지 않으며 전체 항목을 다시 다운로드하려고 시도합니다.
- Android Studio를 다시 시작 하고 Gradle 동기화를 다시 시도하십시오. 이제 문제가 해결되었는지 확인하십시오.
