Google은 흑인 공동체를 위한 인종 간 평등을 진전시키기 위해 노력하고 있습니다. Google에서 어떤 노력을 하고 있는지 확인하세요.

NDK 및 CMake 설치 및 구성

앱의 네이티브 코드를 컴파일하고 디버그하려면 다음 구성요소가 필요합니다.

  • Android 네이티브 개발 키트(NDK): Android에서 C 및 C++ 코드를 사용할 수 있도록 해주는 도구 모음입니다.
  • CMake: Gradle과 함께 작동하여 네이티브 라이브러리를 빌드하는 외부 빌드 도구입니다. ndk-build만 사용하려는 경우에는 이 구성요소가 필요하지 않습니다.
  • LLDB: Android 스튜디오에서 네이티브 코드를 디버깅하는 데 사용하는 디버거입니다. 기본적으로 LLDB는 Android 스튜디오와 함께 설치됩니다.

이 페이지에서는 Android 스튜디오 또는 sdkmanager 도구를 사용하여 이러한 구성요소를 다운로드하고 설치하는 방법을 설명합니다.

NDK 및 CMake 설치

NDK를 설치하면 Android 스튜디오에서 사용 가능한 최신 NDK를 선택합니다. 대부분의 프로젝트는 기본 NDK 버전이면 충분합니다. 하지만 프로젝트에 특정 NDK 버전이 하나 이상 필요한 경우 특정 버전을 다운로드하고 구성할 수 있습니다. 이렇게 하면 여러 프로젝트에서 각각 특정 NDK 버전에 종속된 재현 가능한 빌드를 만들 수 있습니다. Android 스튜디오는 모든 NDK 버전을 android-sdk/ndk/ 디렉터리에 설치합니다.

Android 스튜디오에서 CMake와 기본 NDK를 설치하려면 다음을 따르세요.

  1. 프로젝트를 연 상태에서 Tools > SDK Manager를 클릭합니다.

  2. SDK Tools 탭을 클릭합니다.

  3. NDK (Side by side)CMake 체크박스를 선택합니다.

    SDK Manager의 이미지 그림 1: NDK (Side by side) 옵션을 보여주는 SDK 도구

  4. OK를 클릭합니다.

    대화상자에 NDK 패키지가 디스크에서 차지하는 공간이 표시됩니다.

  5. OK를 클릭합니다.

  6. 설치가 완료되면 Finish를 클릭합니다.

  7. 프로젝트가 자동으로 빌드 파일을 동기화하고 빌드를 실행합니다. 발생하는 모든 오류를 해결하세요.

특정 버전의 CMake 구성

SDK Manager에는 CMake의 포크된 3.6.0 버전과 3.10.2 버전이 포함됩니다. 특정 CMake 버전을 설정하지 않은 프로젝트는 CMake 3.10.2로 빌드됩니다. CMake 버전을 설정하려면 다음을 모듈의 build.gradle 파일에 추가하세요.

android {
    ...
    externalNativeBuild {
        cmake {
            ...
            version "cmake-version"
        }
    }
}

SDK Manager에 포함되지 않는 CMake 버전 3.7 이상을 사용하려면 다음 단계를 따르세요.

  1. 공식 CMake 웹사이트에서 CMake 3.7 이상을 다운로드하여 설치합니다.
  2. Gradle에서 사용할 CMake 버전을 모듈의 build.gradle 파일에 지정합니다.
  3. PATH 환경 변수에 CMake 설치 경로를 추가하거나 아래와 같이 프로젝트의 local.properties 파일에 포함합니다. Gradle에서 build.gradle 파일에 지정된 CMake의 버전을 찾지 못하면 빌드 오류가 발생합니다.

    # If you set this property, Gradle no longer uses PATH to find CMake.
    cmake.dir="path-to-cmake"
    
  4. 아직 워크스테이션에 Ninja 빌드 시스템을 설치하지 않았다면 공식 Ninja 웹사이트로 이동하여 사용 중인 OS에 맞는 최신 버전의 Ninja를 다운로드하여 설치합니다. 또한, PATH 환경 변수에 Ninja 설치 경로를 추가해야 합니다.

특정 NDK 버전 설치

특정 NDK 버전을 설치하려면 다음을 실행합니다.

  1. 프로젝트를 연 상태에서 Tools > SDK Manager를 클릭합니다.

  2. SDK Tools 탭을 클릭합니다.

  3. Show Package Details 체크박스를 선택합니다.

  4. NDK (Side by side) 체크박스 및 그 아래에서 설치하려는 NDK 버전에 상응하는 체크박스를 선택합니다. Android 스튜디오는 모든 NDK 버전을 android-sdk/ndk/ 디렉터리에 설치합니다.

    SDK 도구 창의 이미지 그림 2: NDK (Side by side) 옵션을 보여주는 SDK 도구

  5. OK를 클릭합니다.

    대화상자에 NDK 패키지가 차지하는 공간이 표시됩니다.

  6. OK를 클릭합니다.

  7. 설치가 완료되면 Finish를 클릭합니다.

  8. 프로젝트가 자동으로 빌드 파일을 동기화하고 빌드를 실행합니다. 발생하는 모든 오류를 해결하세요.

  9. 모듈에서 사용할 NDK 버전으로 각 모듈을 구성합니다. Android 스튜디오 3.6 이상을 사용하는 경우 버전을 지정하지 않으면 Android Gradle 플러그인이 호환되는 것으로 알려진 버전을 선택합니다.

프로젝트에서 특정 NDK 버전 구성

다음 중 하나에 해당하면 프로젝트에서 NDK 버전을 구성해야 할 수 있습니다.

  • 프로젝트가 상속된 것이며 특정 버전의 NDK 및 Android Gradle 플러그인(AGP)을 사용해야 하는 경우. 자세한 내용은 Android Gradle 플러그인의 NDK 구성을 참조하세요.
  • 여러 버전의 NDK가 설치되어 있고 특정 NDK를 사용하고자 하는 경우. 이 경우에는 다음 코드 샘플에서와 같이 모듈의 build.gradle 파일에 android.ndkVersion 속성을 사용하여 버전을 지정하세요.
android {
    ndkVersion "major.minor.build" // e.g.,  ndkVersion '21.3.6528147'
}

AGP 버전별 기본 NDK 버전

출시 전에 각 AGP 버전은 해당 시점에 안정적인 것으로 평가된 최신 NDK 출시로 철저하게 테스트됩니다. AGP 버전 3.6 이상에서는 build.gradle 파일에 NDK 버전을 지정하지 않으면 그 NDK 버전이 프로젝트를 빌드하는 데 사용됩니다. 기본 NDK 버전은 AGP 출시 노트에 문서화되어 있습니다. 다음 표에는 현재 기본 NDK 버전이 나와 있습니다.

Android 스튜디오/Gradle 플러그인 버전
4.1 4.0 3.6 3.5 3.4
AGP 버전에 지정된
기본 NDK 버전
21.1.6352462 21.0.6113669 20.0.5594570 기본값이 지정되지 않음