Windows에 rtools 설치

Rtools는 Windows에서 일부 R 패키지를 소스 코드로 설치하거나 코드를 컴파일하는 패키지를 개발할 때 필요한 빌드 도구를 제공합니다. 미리 빌드된 바이너리로 제공되는 패키지가 많으므로 R을 사용한다는 이유만으로 Rtools를 설치할 필요는 없습니다. 패키지에 컴파일이 필요하거나 직접 패키지를 빌드하려면 사용 중인 R 버전에 맞는 Rtools 릴리스를 설치하고, 현재 R 세션에서 도구를 찾을 수 있는지 확인하세요.

Windows에서 Rtools 설치하기

Rtools는 패키지 소스 코드를 컴파일할 때 사용하는 컴파일러와 유틸리티 등을 포함한 Windows용 R 빌드 도구 모음입니다. 이러한 도구가 필요한 패키지 설치나 개발 작업에 사용하며, 모든 R 사용자에게 필요한 것은 아닙니다. 이 안내서에서는 호환되는 릴리스를 고르고 설치 프로그램을 실행하는 방법, R에서 도구를 찾을 수 있는지 확인하는 방법, 일반적인 설정 문제를 살펴보는 방법을 설명합니다.

R 설치 버전에 맞는 Rtools 선택하기

먼저 CRAN Rtools 페이지에서 제공되는 Rtools 릴리스의 호환성 정보를 확인하세요. 컴퓨터에 설치된 R 버전에서 지원되는 릴리스를 선택해야 합니다. 버전 번호가 더 높다는 이유만으로 릴리스를 고르지 마세요. 호환성은 R 도구 체인에 따라 달라지며, 관련 안내도 시간이 지나면서 바뀔 수 있습니다.

R이 여러 개 설치되어 있다면 릴리스를 선택하기 전에 R 또는 RStudio가 현재 어느 설치본을 사용하는지 확인하세요. 해당 세션에 표시되는 R 버전에 맞춰야 합니다. 현재 릴리스와 호환성에 관한 최신 정보는 CRAN 페이지에서 확인할 수 있습니다. 이 안내서에서는 특정 Rtools 릴리스가 모든 설치 환경에 항상 최신이라고 가정하지 않습니다.

Rtools 설치하기

CRAN 페이지에서 호환되는 릴리스의 설치 프로그램을 다운로드한 다음, 파일을 열고 안내에 따라 진행하세요. 설치 화면과 문구는 릴리스마다 다를 수 있으므로 선택한 릴리스에 맞는 옵션 안내를 따르세요. 특히 PATH 추가 옵션은 릴리스에 따라 표시 방식이나 필요 여부가 달라질 수 있습니다. 이전 안내서에 나온 체크박스 이름이나 설정이 현재 설치 프로그램에도 적용된다고 가정하지 마세요.

해당 릴리스에서 지원하는 위치와 옵션을 사용하고, 설치가 끝난 뒤 새 R 또는 RStudio 세션을 여세요. 설치 프로그램에서 도구를 찾기 위한 설정을 제공한다면 해당 릴리스의 안내를 따르세요. 설치나 패키지 컴파일에 문제가 생겼을 때 호환성을 확인할 수 있도록 선택한 R 버전과 Rtools 릴리스를 기록해 두세요.

Rtools 설치 확인하기

Sys.which()를 사용해 R 세션에서 make 같은 빌드 도구를 찾을 수 있는지 확인하세요. 패키지 작업에 사용하는 R 또는 RStudio 세션에서 다음 코드를 실행합니다.

Sys.which("make")

반환값은 운영체제, Rtools 릴리스, 해당 세션의 설정에 따라 달라집니다. 경로가 비어 있지 않으면 R이 그 이름의 명령을 찾았다는 뜻이지만, 모든 컴파일러나 패키지 빌드 요구 사항이 올바르게 설정되었다는 증거는 아닙니다. 값이 비어 있으면 현재 세션의 명령 검색 경로에서 make를 찾지 못했다는 뜻입니다. 결과를 선택한 Rtools 릴리스의 설정 안내 및 빌드하려는 패키지의 요구 사항과 비교하세요. 모든 Windows 설치 환경에 공통으로 적용되는 경로나 출력값은 없습니다.

Rtools 설치 및 도구 검색 문제 해결하기

패키지를 빌드할 때 도구를 찾지 못한다면 먼저 해당 세션에서 사용하는 R 버전과 Rtools 릴리스가 호환되는지 확인하세요. 그런 다음 설치 후 R 또는 RStudio를 닫았다가 다시 열고, 도구를 찾을 수 있는지 확인하세요. 설치 전에 열어 둔 세션에는 변경된 환경 설정이 반영되지 않을 수 있습니다.

Sys.which("make")로 명령을 찾지 못하면 사용 중인 Rtools 릴리스의 설정 절차를 다시 살펴보세요. 설치가 완료되었는지, 안내된 PATH 설정이 R 세션에 적용되어 있는지 확인하세요. 설치 위치와 설정 방법은 릴리스나 컴퓨터에 따라 다를 수 있으므로 다른 릴리스나 컴퓨터의 PATH 항목을 그대로 복사하지 마세요.

권한 문제는 설치 대상 폴더와 Windows 계정에 따라 달라집니다. 쓰기 권한이 있는 위치를 사용하고 설치 프로그램의 안내를 따르세요. Windows에서 필요한 위치에 대한 접근을 거부하는 경우 설치 프로그램을 관리자로 실행하면 도움이 될 수 있습니다. 하지만 관리자 권한으로 실행해도 버전 불일치나 도구 검색 설정 문제 자체가 해결되는 것은 아닙니다. 일반적으로 패키지 작업에 컴파일이 필요할 때 Rtools가 필요하며, 미리 빌드된 패키지만 사용한다면 필요하지 않을 수 있습니다.