Android Dev Summit, October 23-24: two days of technical content, directly from the Android team. Sign-up for livestream updates.

C 및 C++ 코드를 프로젝트에 추가

Android 프로젝트에 C 및 C++ 코드를 삽입하려면 프로젝트 모듈의 cpp 디렉터리에 해당 코드를 추가하면 됩니다. 프로젝트를 빌드할 때 이 코드는 Gradle이 APK와 패키징할 수 있는 네이티브 라이브러리에 컴파일됩니다. 그러면 자바 코드 또는 Kotlin 코드에서 JNI(Java Native Interface)를 통해 네이티브 라이브러리에서 함수를 호출할 수 있습니다. JNI 프레임워크를 사용하는 방법을 자세히 알아보려면 Android를 위한 JNI 팁을 확인하세요.

Android 스튜디오는 크로스 플랫폼 프로젝트에 적합한 CMake와 CMake보다 빠르지만 Android만 지원하는 ndk-build를 지원합니다. CMake와 ndk-build 모두를 같은 모듈에서 사용하는 것은 현재 지원되지 않습니다.

기존 ndk-build 라이브러리를 Android 스튜디오 프로젝트로 가져오려면 Gradle을 네이티브 라이브러리 프로젝트에 링크하는 방법을 알아보세요.

이 페이지는 필수 빌드 도구로 Android 스튜디오를 설정하고, C/C++ 지원 기능으로 새 프로젝트를 만들고, 프로젝트에 새 C/C++ 파일을 추가하는 방법을 보여줍니다.

대신 네이티브 코드를 기존 프로젝트에 추가하려면 다음 단계를 따라야 합니다.

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

프로젝트를 구성한 후에는 JNI 프레임워크를 사용하여 자바 또는 Kotlin 코드에서 네이티브 함수에 액세스할 수 있습니다. 앱을 빌드하고 실행하려면 간단히 Run 메뉴 모음에서 앱을 실행을 클릭하면 됩니다.

참고: 기존 프로젝트에서 지원이 중단된 ndkCompile 도구를 사용하는 경우 이전하여 CMake나 ndk-build를 사용해야 합니다. 자세한 내용은 ndkCompile에서 이전하는 방법 관련 섹션을 참조하세요.

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

NDK 및 빌드 도구 다운로드

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

  • Android NDK(Native Development Kit): Android에서 C 및 C++ 코드를 사용할 수 있도록 지원하고 네이티브 활동을 관리하며 물리적 기기 구성요소(예: 센서 및 터치 입력)에 액세스할 수 있는 플랫폼 라이브러리를 제공하는 도구 모음입니다.
  • CMake: Gradle과 함께 작동하여 네이티브 라이브러리를 빌드하는 외부 빌드 도구입니다. ndk-build만 사용하려는 경우에는 이 구성요소가 필요하지 않습니다.
  • LLDB: Android 스튜디오에서 네이티브 코드를 디버깅하는 데 사용하는 디버거입니다.

다음과 같이 SDK 관리자를 사용하여 이러한 구성요소를 설치할 수 있습니다.

  1. 열려 있는 프로젝트의 메뉴 바에서 Tools > SDK Manager를 선택합니다.
  2. SDK Tools 탭을 클릭합니다.
  3. 그림 1에서와 같이 LLDB, CMake, NDK 옆에 있는 체크박스를 선택합니다.

    그림 1. SDK 관리자에서 LLDB, CMake, NDK 설치

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

CMake 3.6.0 또는 3.10.2 사용

SDK 관리자에는 CMake의 분기된 3.6.0 버전과 3.10.2 버전이 포함됩니다. build.gradle에 특정 CMake 버전을 설정하지 않는 프로젝트는 CMake 3.6.0으로 빌드됩니다. 최근에 포함된 버전을 사용하려면 모듈의 build.gradle 파일에 CMake 버전 3.10.2를 지정합니다.

    android {
        ...
        externalNativeBuild {
            cmake {
                ...
                version "3.10.2"
            }
        }
    }
    
권장사항은 아니지만 3.10+ 또는 3+와 같이 build.gradle 항목 끝에 +를 추가하여 CMake 버전을 최소 버전으로 지정할 수 있습니다.

맞춤 CMake 버전 사용

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

  1. 공식 CMake 웹사이트에서 CMake 3.7 이상을 다운로드하여 설치합니다.
  2. Gradle에서 사용하려는 CMake 버전을 모듈의 build.gradle 파일에 지정합니다.
        android {
            ...
            externalNativeBuild {
                cmake {
                    ...
                    version "cmake-version"
                }
            }
        }
        
  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 설치 프로그램 경로를 추가해야 합니다.

C/C++ 지원 기능을 활용하여 새 프로젝트 생성

네이티브 코드 지원 기능을 활용하여 새 프로젝트를 생성하는 작업은 다른 Android 스튜디오 프로젝트를 생성하는 작업과 유사하지만 추가 단계가 있습니다.

  1. 마법사의 Choose your project 섹션에서 Native C++ 프로젝트 유형을 선택합니다.
  2. Next를 클릭합니다.
  3. 마법사의 다음 섹션에서 다른 모든 필드를 완료합니다.
  4. Next를 클릭합니다.
  5. 마법사의 Customize C++ Support 섹션에서 C++ Standard 필드로 프로젝트를 맞춤설정할 수 있습니다. 드롭다운 목록을 사용하여 사용하려는 표준 C++을 선택합니다. Toolchain Default를 선택하면 기본 CMake 설정이 사용됩니다.
  6. Finish를 클릭합니다.

Android 스튜디오에서 새 프로젝트가 만들어지면 IDE 왼쪽에서 Project 창을 열고 Android 뷰를 선택합니다. 그림 2와 같이 Android 스튜디오는 cpp 그룹을 추가합니다.

그림 2. 네이티브 소스 및 외부 빌드 스크립트를 포함하는 Android 뷰 그룹

참고: 이 뷰는 디스크에 있는 실제 파일 계층 구조를 반영하지 않지만, 유사한 파일을 그룹화하여 프로젝트 탐색을 간소화합니다.

cpp 그룹에서는 프로젝트에 포함된 모든 네이티브 소스 파일, 헤더, CMake 또는 ndk-build의 빌드 스크립트, 미리 빌드된 라이브러리를 찾을 수 있습니다. 새 프로젝트의 경우, Android 스튜디오는 샘플 C++ 소스 파일 native-lib.cpp를 생성하여 앱 모듈의 src/main/cpp/ 디렉터리에 배치합니다. 이 샘플 코드에서는 'Hello from C++' 문자열을 반환하는 단순한 C++ 함수인 stringFromJNI()를 제공합니다. 새로운 네이티브 소스 파일을 생성하는 방법을 설명하는 섹션에서 프로젝트에 소스 파일을 추가하는 방법을 확인할 수 있습니다.

build.gradle 파일이 Gradle에 앱을 빌드하는 방법을 알리는 방법과 유사하게 CMake 및 ndk-build에서 네이티브 라이브러리를 빌드하는 방법을 파악하려면 빌드 스크립트가 필요합니다. 새 프로젝트의 경우, Android 스튜디오는 CMake 빌드 스크립트 CMakeLists.txt를 생성하여 모듈의 루트 디렉터리에 배치합니다. 이 빌드 스크립트의 콘텐츠를 자세히 알아보려면 CMake 구성을 참조하세요.

샘플 앱 빌드 및 실행

Run 메뉴 모음에서 앱을 실행을 클릭하면 Android 스튜디오에서 Android 기기 또는 에뮬레이터에 'Hello from C++'라는 텍스트를 표시하는 앱을 빌드하고 실행합니다. 다음 개요에서는 샘플 앱을 빌드하고 실행하기 위해 발생하는 이벤트를 설명합니다.

  1. Gradle이 외부 빌드 스크립트 CMakeLists.txt를 호출합니다.
  2. CMake가 이 빌드 스크립트에 포함된 명령어를 따라 C++ 소스 파일 native-lib.cpp를 공유 객체 라이브러리로 컴파일하고 이 파일을 libnative-lib.so로 명명합니다. 그런 다음 Gradle이 명명된 파일을 APK로 패키징합니다.
  3. 런타임 중에 앱의 MainActivitySystem.loadLibrary()를 사용하여 네이티브 라이브러리를 로드합니다. 이제 앱에서 라이브러리의 네이티브 함수 stringFromJNI()를 사용할 수 있습니다.
  4. MainActivity.onCreate()가 'Hello from C++'를 반환하는 stringFromJNI()를 호출하여 TextView를 업데이트하는 데 사용합니다.

참고: Instant Run은 네이티브 코드로 작성된 프로젝트 구성요소와 호환되지 않습니다.

Gradle이 네이티브 라이브러리를 APK로 패키징하는지 확인하려는 경우 APK Analyzer를 사용할 수 있습니다.

  1. Build > Build Bundles(s) / APK(s) > Build APK(s)를 선택합니다.
  2. Build > Analyze APK를 선택합니다.
  3. app/build/outputs/apk/ 디렉터리에서 APK를 선택하고 OK를 클릭합니다.
  4. 그림 3과 같이 APK Analyzer 창의 lib/<ABI>/ 아래에서 libnative-lib.so를 볼 수 있습니다.

    그림 3. APK Analyzer를 사용하여 네이티브 라이브러리 찾기

도움말: 네이티브 코드를 사용하는 다른 Android 앱으로 시험해 보려는 경우 File > New > Import Sample을 클릭하고 Ndk 목록에서 샘플 프로젝트를 선택하세요.

새 C/C++ 소스 파일 생성

기존 프로젝트에 새 C/C++ 소스 파일을 추가하려면 다음 단계를 따르세요.

  1. 아직 앱의 기본 소스 세트에 cpp/ 디렉터리가 없는 경우 다음과 같이 디렉터리를 생성합니다.
    1. IDE 왼쪽에서 Project 창을 열고 드롭다운 메뉴에서 Project 뷰를 선택합니다.
    2. your-module > src로 이동한 다음 main 디렉터리를 마우스 오른쪽 버튼으로 클릭하여 New > Directory를 선택합니다.
    3. cpp를 디렉터리 이름으로 입력하고 OK를 클릭합니다.

  2. cpp/ 디렉터리를 마우스 오른쪽 버튼으로 클릭하여 New > C/C++ Source File을 선택합니다.
  3. 소스 파일의 이름(예: native-lib)을 입력합니다.
  4. Type 드롭다운 메뉴에서 소스 파일의 파일 확장자(예: .cpp)를 선택합니다.
    • Edit File Types 를 클릭하여 다른 파일 형식(예: .cxx 또는 .hxx)을 드롭다운 메뉴에 추가할 수 있습니다. 팝업되는 C/C++ 대화상자의 Source ExtensionHeader Extension 드롭다운 메뉴에서 다른 파일 확장자를 선택하고 OK를 클릭합니다.
  5. 헤더 파일도 생성하려면 Create an associated header 체크박스를 선택합니다.
  6. OK를 클릭합니다.

새 C/C++ 파일을 프로젝트에 추가한 후에도 CMake를 구성하여 네이티브 라이브러리에 포함해야 합니다.

참고 자료

앱에서 C/C++ 코드를 지원하는 내용을 자세히 알아보려면 다음 리소스를 참조하세요.

Codelab