NDK 시작하기

네이티브 개발 키트(NDK)란 일련의 도구 모음으로 Android에서 C 및 C++ 코드를 사용할 수 있게 해주고, 플랫폼 라이브러리를 제공하여 네이티브 액티비티를 관리하고 센서 및 터치 입력과 같은 물리적 기기 구성 요소에 액세스하는 데 사용하게 해줍니다. NDK는 대부분의 초심자 Android 프로그래머에게는 적합하지 않을 수 있습니다. 이들은 앱을 개발할 때 자바 코드와 프레임워크 API만 사용하면 되기 때문입니다. 다만 NDK는 다음과 같은 작업을 하나 이상 수행해야 하는 경우 유용할 수 있습니다.

  • 기기에서 최대한의 성능을 도출하여 짧은 지연 시간을 달성해야 하거나 게임 또는 물리학 시뮬레이션과 같은 연산 집약적인 애플리케이션을 실행하고자 하는 경우.
  • 본인 또는 다른 개발자의 C 또는 C++ 라이브러리를 재사용해야 하는 경우.

Android Studio 2.2 이상을 사용하면 C 및 C++ 코드를 네이티브 라이브러리로 컴파일하고 IDE의 내장 빌드 시스템인 Gradle을 사용하여 APK로 패키징할 때 NDK를 이용할 수 있습니다. 그러면 자바 코드가 자바 네이티브 인터페이스(JNI) 프레임워크를 통해 네이티브 라이브러리에 포함된 함수를 호출할 수 있습니다. Gradle 및 Android 빌드 시스템에 관해 자세히 알아보려면 빌드 구성하기를 읽어보세요.

네이티브 라이브러리 컴파일을 위한 Android Studio의 기본 빌드 도구는 CMake입니다. 빌드 툴킷을 사용하는 기존 프로젝트의 수가 워낙 많아 Android Studio는 ndk-build도 지원합니다. 하지만, 새로운 네이티브 라이브러리를 생성하는 경우에는 CMake를 사용해야 합니다.

이 가이드에서는 Android Studio에서 NDK를 시작하고 실행하는 데 필요한 정보를 제공합니다. 최신 버전의 Android Studio가 없다면 지금 다운로드 및 설치하세요.

시험용 Gradle 사용자 주의 사항: 다음 사항 중 하나라도 해당되는 경우 플러그인 버전 2.2.0 이상으로 마이그레이션하고 CMake 또는 ndk-build를 사용하여 네이티브 라이브러리를 빌드하는 것이 좋습니다. 즉, 네이티브 프로젝트에서 이미 CMake 또는 ndk-build를 사용하는 경우, 안정적인 버전의 Gradle 빌드 시스템을 사용하려는 경우, 또는 CCache와 같은 부가기능 도구를 지원하려는 경우가 이에 해당됩니다. 그렇지 않은 경우, Gradle의 시험용 버전과 Android 플러그인을 계속 사용할 수 있습니다.

NDK 및 도구 다운로드

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

  • Android 네이티브 개발 키트(NDK): Android에서 C 및 C++ 코드를 사용할 수 있도록 도와주는 도구 집합입니다.
  • CMake: Gradle과 함께 작동하여 네이티브 라이브러리를 빌드하는 외장 빌드 도구입니다. ndk-build만 사용하려는 경우에는 이 구성 요소가 필요하지 않습니다.
  • LLDB: Android Studio가 네이티브 코드를 디버그하는 데 사용하는 디버거입니다.

SDK Manager를 사용하여 이러한 구성 요소를 설치할 수 있습니다.

  1. 열려 있는 프로젝트의 메뉴 모음에서 Tools > Android > SDK Manager를 선택합니다.
  2. SDK Tools 탭을 클릭합니다.
  3. 그림 1에 나와 있는 것처럼 LLDB, CMakeNDK 옆에 있는 상자를 선택합니다.

    그림 1. SDK Manager에서 LLDB, CMake 및 NDK 설치.

  4. Apply를 클릭한 후 다음 대화상자에서 OK를 클릭합니다.
  5. 설치가 완료되면 FinishOK를 차례로 클릭합니다.

네이티브 프로젝트 생성 또는 가져오기

Android Studio를 설치했으면 C/C++ 지원 기능을 활용하여 새 프로젝트를 생성하면 됩니다. 그러나, 네이티브 코드를 기존 Android Studio 프로젝트로 추가하거나 가져오고 싶은 경우에는 다음의 기본 프로세스가 필요합니다.

  1. 새로운 네이티브 소스 파일을 생성하고 Android Studio 프로젝트에 추가합니다.
    • 네이티브 코드가 이미 있거나 미리 빌드된 네이티브 라이브러리를 가져오려는 경우에는 이 단계를 건너뛸 수 있습니다.
  2. CMake 빌드 스크립트를 생성하여 CMake에 네이티브 소스 코드를 라이브러리로 빌드하는 방법을 전달합니다. 또한 미리 빌드된 라이브러리나 플랫폼 라이브러리를 가져와서 이 라이브러리에 링크하려는 경우에도 이 빌드 스크립트가 필요합니다.
    • 기존 네이티브 라이브러리에 이미 CMakeLists.txt 빌드 스크립트가 있거나 ndk-build를 사용하고 Android.mk 빌드 스크립트를 사용하는 경우, 이 단계는 건너뛰어도 됩니다.
  3. CMake 또는 ndk-build 스크립트 파일의 경로를 제공하여 Gradle을 네이티브 라이브러리에 링크합니다. Gradle은 빌드 스크립트를 사용하여 소스 코드를 Android Studio 프로젝트로 가져오고 네이티브 라이브러리(SO 파일)를 APK로 패키징합니다.

    참고: 기존 프로젝트가 지원이 중단된 ndkCompile 도구를 사용하는 경우, build.properties 파일을 열어 다음 코드 줄을 삭제한 후에 Gradle을 구성해야 CMake 또는 ndk-build를 사용할 수 있습니다.

    // Remove this line
    android.useDeprecatedNdk = true
    
  4. Run 실행 후 기본 메뉴에서 앱 실행을 클릭하여 앱을 빌드하고 실행합니다. 그러면 Gradle이 CMake나 ndk-build 프로세스를 종속성으로 추가하여 네이티브 라이브러리를 컴파일 및 빌드한 후 APK로 패키징합니다.

앱이 실제 기기 또는 에뮬레이터에서 실행되면 Android Studio를 사용하여 앱을 디버그할 수 있습니다. 그 외의 경우, NDK 및 구성 요소에 관해 자세히 알아보려면 개념 페이지를 읽어보세요.