개발을 하다 보면 종종 익숙하지 않은 에러 메시지를 마주하게 됩니다. 이번 포스트에서는 Gradle Wrapper(gradlew)를 실행할 때 발생할 수 있는 문제와 그 해결 방법에 대해 다뤄보겠습니다. 특히 zsh: command not found: gradlew라는 에러 메시지를 해결하는 방법에 대해 자세히 알아보겠습니다.
문제 상황
MacBook Pro에서 프로젝트를 설정한 후, Gradle Wrapper를 실행하려고 시도했지만 zsh: command not found: gradlew라는 에러 메시지를 보았습니다. 이는 터미널에서 gradlew 명령어를 찾을 수 없다는 것을 의미합니다.
$ gradlew
zsh: command not found: gradlew해결 방법
이 문제는 두 가지 간단한 단계로 해결할 수 있습니다: gradlew 파일에 실행 권한을 부여하고 다시 시도하는 것입니다.
실행 권한 부여하기
먼저, 프로젝트 디렉토리에서 gradlew 파일에 실행 권한을 부여해야 합니다. 이는 chmod +x gradlew 명령어를 사용하여 쉽게 할 수 있습니다. 이 명령어는 gradlew 파일에 실행 권한을 추가합니다.
$ chmod +x gradlew명령어 재시도하기
실행 권한을 부여한 후, 다시 gradlew 명령어를 실행해봅니다. 이제는 정상적으로 작동해야 합니다.
$ ./gradlew추가 팁
파일 위치 확인하기: gradlew 파일이 프로젝트의 루트 디렉토리에 있는지 확인하세요. 다른 위치에 있다면 해당 디렉토리로 이동한 후 명령어를 실행해야 합니다.
절대 경로 사용하기: ./gradlew와 같이 상대 경로 대신 절대 경로를 사용할 수도 있습니다.
터미널 환경 확인하기: zsh 대신 다른 셸을 사용하는 경우에도 동일한 문제가 발생할 수 있습니다. 이때는 같은 방법으로 해결 가능합니다.
결론
Gradle Wrapper는 프로젝트의 일관된 빌드 환경을 보장하는 중요한 도구입니다. 따라서 올바르게 설정하고 사용하는 것이 중요합니다. zsh: command not found: gradlew 에러는 실행 권한 부여를 통해 쉽게 해결할 수 있으며, 이 과정을 통해 프로젝트 설정과 빌드 과정에 대한 이해도를 높일 수 있습니다. 앞으로 이와 같은 문제가 발생했을 때, 당황하지 말고 차근차근 해결해보세요!
