IDE Android Studio를 사용하는 프로그래머는 "Gradle 프로젝트 동기화 실패 오류 메시지가 나타납니다. " 코드를 컴파일하거나 Android 기기(실제 또는 에뮬레이트)에서 실행할 때. Gradle 동기화는 build.gradle 의 모든 종속성을 확인하는 것이 주요 기능인 Gradle 작업입니다. Android 스튜디오 프로젝트와 연결된 파일을 만든 다음 지정된 버전을 다운로드합니다(아직 다운로드하지 않은 경우).
이 오류 메시지가 발생할 수 있는 다양한 변형이 있습니다. Gradle 컴파일이 작동하지 않는 복잡한 문제에 대한 인터넷 연결과 같은 간단한 문제에 직면할 수 있습니다. 이 기사에서는 이 문제가 발생하는 모든 원인을 살펴보고 해결 방법으로 넘어갈 것입니다.
Android Studio에서 'Gradle 프로젝트 동기화 실패' 오류 메시지의 원인은 무엇입니까?
앞에서 언급했듯이 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을 동기화하려고 할 때 오류 메시지가 나타날 때마다 하이퍼링크 가 있는지 확인하십시오. 누락된 플랫폼 설치 및 프로젝트 동기화라는 제목의 문제 아래 . 링크를 클릭하면 Android Studio가 다운로드 프로세스를 시작하고 누락된 모든 것을 설치합니다. 지금 프로젝트를 동기화하고 문제가 해결되는지 확인하십시오.
해결책 4:로컬 Gradle 배포 활용
프로젝트를 빌드하고 Gradle이 활성화될 때마다 최신 온라인 배포에 연결하여 필요한 모든 모듈 또는 버전을 다운로드합니다. 온라인 배포가 예상대로 작동하지 않고 Gradle 동기화에 실패한 여러 사례를 접했습니다. 이 문제에 대한 또 다른 해결 방법은 Gradle 배포를 수동으로 다운로드하여 사용하는 것입니다. 아래 단계를 따르십시오:
- 공식 Gradle 릴리스 웹사이트에서 최신 버전의 Gradle을 다운로드하세요.
- 다운로드 후 액세스 가능한 폴더에 모든 파일의 압축을 풉니다.
- 이제 Android 스튜디오 실행 파일> 설정> 빌드, 실행, 배포> Gradle로 이동합니다. .
- 이제 로컬 Gradle 배포 옵션을 선택합니다. . 또한 Gradle 홈에 있을 때 방금 파일을 추출한 경로를 가리킵니다.
참고: 오프라인 작업을 사용하는 경우 전역 Gradle 설정에서 선택 취소 그 옵션.
- 이제 프로젝트를 빌드하고 Gradle이 제대로 동기화되는지 확인하십시오. 새 프로젝트를 만들 때마다 이 단계를 반복해야 합니다.
해결 방법 5:GPU 디버거 활성화
GPU 디버거를 사용하면 OpenGL ES 응용 프로그램을 디버그하고 분석할 수 있습니다. GPU 상태를 검사하고 렌더링 결과의 원인을 이해할 수 있는 몇 가지 기능이 있습니다. 일부 Gradle 빌드 인스턴스에는 이것이 활성화되지 않은 시스템 버그가 있습니다. 이 솔루션에서는 모듈을 강제로 새로 고치고 이 구성 요소를 설치합니다.
- 도구 를 클릭하십시오. 그런 다음 Android> SDK 관리자를 선택합니다. .
- 이제 SDK 도구 탭을 클릭하십시오. 그런 다음 선택을 취소 하십시오. Android SDK 빌드 도구 옵션 . 약 5초 동안 기다린 후 옵션을 다시 활성화합니다.
- 이제 목록이 새로 고쳐지고 항목이 채워질 때까지 잠시 기다리세요.
- 새 항목이 채워지면 목록을 보고 확인 GPU 디버깅 도구 옵션 . 완료되면 확인을 누르세요.
이제 이러한 도구가 Android Studio 애플리케이션에 다운로드되며 문제 없이 Gradle을 올바르게 동기화할 수 있습니다.
해결 방법 6:캐시 새로 고침
Microsoft Windows를 포함한 모든 응용 프로그램에는 모든 곳에 캐시가 있어 응용 프로그램이 문제 없이 원활하게 실행될 수 있습니다. 응용 프로그램이 나중에 선택하기 위해 기본 설정이나 임시 데이터를 저장하는 임시 저장소 역할을 합니다. 이 캐시가 손상되면 gradle 빌드 프로세스가 중지될 것이라고 결정했습니다. 이 솔루션에서는 전체 캐시를 새로 고치고 기존 Gradle 파일을 삭제한 후 Android Studio를 다시 시작하여 문제가 해결되는지 확인합니다.
- 파일로 이동 캐시 무효화/다시 시작을 클릭합니다. .
- 이제 프로세스가 완료되면 Android Studio를 완전히 종료합니다.
- Android Studio 설치 디렉토리의 .gradle 폴더로 이동합니다. 이제 잘라내기/붙여넣기를 다른 위치로 하거나 단순히 이름을 바꿀 수 있습니다.
이제 Android 스튜디오가 Gradle 파일에 액세스하려고 하면 파일이 없는 것을 확인하고 전체 파일을 다시 다운로드하려고 시도합니다. . - 다시 시작 Android Studio에서 Gradle 동기화를 다시 시도하세요. 이제 문제가 해결되었는지 확인하세요.