Skip to content

Most visited

Recently visited

navigation

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

Gradle용 Android 플러그인 버전 2.2.0 이상과 함께 Android Studio 2.2 이상 버전을 사용하면 Gradle이 APK로 패키징할 수 있는 네이티브 라이브러리로 C 및 C++ 코드를 컴파일하여 앱에 추가할 수 있습니다. 그러면 Java 코드가 JNI(Java Native Interface)를 통해 네이티브 라이브러리에 포함된 함수를 호출할 수 있습니다. JNI 프레임워크를 사용하는 방법에 대한 자세한 내용은 Android를 위한 JNI 팁을 검토하세요.

네이티브 라이브러리용 Android Studio의 기본 빌드 도구는 CMake입니다. 다수의 기존 프로젝트가 빌드 도구 키트를 사용하여 네이티브 코드를 컴파일하므로 Android Studio에서는 ndk-build도 지원합니다. 기존의 ndk-build 라이브러리를 Android Studio 프로젝트로 가져오려면 Gradle을 구성하여 네이티브 라이브러리에 링크하는 방법을 설명하는 섹션을 참조하십시오. 하지만, 새로운 네이티브 라이브러리를 생성하는 경우에는 CMake를 사용해야 합니다.

이 페이지에는 필요한 빌드 도구를 사용하여 Android Studio를 설정하고, Android에서 네이티브 코드를 지원하도록 프로젝트를 생성하거나 구성하고, 앱을 빌드하고 실행하는 데 필요한 정보가 나와 있습니다.

참고: 기존 프로젝트에서 지원 중단된 ndkCompile 도구를 사용하는 경우 Gradle을 네이티브 라이브러리에 링크하기 전에 build.properties 파일을 열고 다음 코드 줄을 제거해야 합니다.

// Remove this line
android.useDeprecatedNdk = true

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

NDK 및 빌드 도구 다운로드

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

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를 차례로 클릭합니다.

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

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

  1. 마법사의 Configure your new project 섹션에서 Include C++ Support 체크박스를 선택합니다.
  2. Next를 클릭합니다.
  3. 평상시와 같이 기타 모든 필드와 마법사의 다음 몇 개 섹션을 완료합니다.
  4. 마법사의 Customize C++ Support 섹션에서 다음 옵션을 사용하여 프로젝트를 사용자 지정할 수 있습니다.
    • C++ Standard: 드롭다운 목록에서 사용할 C++의 표준화를 선택합니다. Toolchain Default를 선택하면 기본 CMake 설정이 사용됩니다.
    • Exceptions Support: C++ 예외 처리 지원 기능을 활성화하려면 이 상자를 선택합니다. 활성화된 경우, Android Studio는 Gradle이 CMake로 전달하는 모듈 수준의 build.gradle 파일에 있는 cppFlags-fexceptions 플래그를 추가합니다.
    • Runtime Type Information Support: RTTI 지원 기능을 사용하려면 이 상자를 선택합니다. 활성화된 경우, Android Studio는 Gradle이 CMake로 전달하는 모듈 수준의 build.gradle 파일에 있는 cppFlags-frtti 플래그를 추가합니다.
  5. Finish를 클릭합니다.

Android Studio가 새 프로젝트 생성 작업을 완료한 후에는 IDE의 왼쪽에서 Project 창을 열고 Android 뷰를 선택합니다. 그림 2에 표시된 대로 Android Studio가 cppExternal Build Files 그룹을 추가합니다.

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

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

  1. cpp 그룹에서는 프로젝트에 포함되어 있는 모든 네이티브 소스 파일, 헤더 및 미리 빌드된 라이브러리를 찾을 수 있습니다. 새 프로젝트의 경우, Android Studio는 샘플 C++ 소스 파일 native-lib.cpp를 생성하여 앱 모듈의 src/main/cpp/ 디렉토리에 배치합니다. 이 샘플 코드에서는 "Hello from C++" 문자열을 반환하는 단순한 C++ 함수인 stringFromJNI()를 제공합니다. 새로운 네이티브 소스 파일을 생성하는 방법을 설명하는 섹션에서 프로젝트에 소스 파일을 추가하는 방법을 확인할 수 있습니다.
  2. External Build Files 그룹에서는 CMake 또는 ndk-build용 빌드 스크립트를 확인할 수 있습니다. build.gradle 파일이 Gradle에 앱을 빌드하는 방법을 알리는 방법과 유사하게 CMake 및 ndk-build에서 네이티브 라이브러리를 빌드하는 방법을 파악하려면 빌드 스크립트가 필요합니다. 새 프로젝트의 경우, Android Studio는 CMake 빌드 스크립트 CMakeLists.txt를 생성하여 모듈의 루트 디렉토리에 배치합니다. Cmake 빌드 스크립트를 생성하는 방법을 설명하는 섹션에서 이 빌드 스크립트의 콘텐츠에 대한 자세한 내용을 확인할 수 있습니다.

샘플 앱 빌드 및 실행

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

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

참고: Instant Run은 네이티브 코드를 사용하는 프로젝트와 호환되지 않습니다. Android Studio는 자동으로 이 기능을 비활성화합니다.

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

  1. Build > Analyze APK를 선택합니다.
  2. app/build/outputs/apk/ 디렉토리에서 APK를 선택하고 OK를 클릭합니다.
  3. 그림 3에 표시된 것처럼 APK Analyzer 창의 lib/<ABI>/ 아래에서 libnative-lib.so를 볼 수 있습니다.

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

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

C/C++ 코드를 기존 프로젝트에 추가

네이티브 코드를 기존 프로젝트에 추가하려면 다음 단계를 수행합니다.

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

프로젝트를 구성한 후에는 JNI 프레임워크를 사용하여 Java 코드에서 네이티브 함수에 액세스할 수 있습니다. 앱을 빌드하고 실행하려면 간단히 Run 메뉴 모음에서 앱을 실행을 클릭하면 됩니다. 그러면 Gradle이 외부 네이티브 빌드 프로세스를 종속성으로 추가하여 네이티브 라이브러리를 컴파일 및 빌드한 후 APK로 패키징합니다.

새로운 네이티브 소스 파일 생성

앱 모듈의 기본 소스 세트에 새로운 네이티브 소스 파일을 포함하는 cpp/ 디렉토리를 생성하려면 다음 단계를 진행하세요.

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

CMake 빌드 스크립트 생성

네이티브 소스에 CMake 빌드 스크립트가 아직 없는 경우 빌드 스크립트를 직접 생성하고 적절한 CMake 명령에 포함해야 합니다. CMake 빌드 스크립트는 일반 텍스트 파일이며, CMakeLists.txt로 이름을 지정해야 합니다. 이 섹션에는 네이티브 라이브러리를 생성할 때 사용할 소스를 CMake에 알리기 위해 빌드 스크립트에 포함해야 하는 몇 가지 기본 명령에 대한 설명이 나와 있습니다.

참고: 프로젝트에서 ndk-build를 사용하는 경우에는 CMake 빌드 스크립트를 생성할 필요가 없습니다. Android.mk 파일의 경로를 제공하여 Gradle을 네이티브 라이브러리에 링크할 수 있습니다.

CMake 빌드 스크립트로 사용할 수 있는 일반 텍스트 파일을 생성하려면 다음 단계를 진행하세요.

  1. IDE의 왼쪽에서 Project 창을 열고 드롭다운 메뉴에서 Project 뷰를 선택합니다.
  2. your-module의 루트 디렉토리를 마우스 오른쪽 버튼으로 클릭하고 New > File을 선택합니다.

    참고: 원하는 위치 어디에든 빌드 스크립트를 생성할 수 있습니다. 단, 빌드 스크립트를 구성할 때 네이티브 소스 파일 및 라이브러리 경로를 빌드 스크립트의 위치에 상대적인 경로로 지정해야 합니다.

  3. 파일 이름으로 "CMakeLists.txt"를 입력하고 OK를 클릭합니다.

이제 CMake 명령을 추가하여 빌드 스크립트를 구성할 수 있습니다. CMake에 네이티브 소스 코드에서 네이티브 라이브러리를 생성하도록 지시하려면 cmake_minimum_required()add_library() 명령을 빌드 스크립트에 추가합니다.

# Sets the minimum version of CMake required to build your native library.
# This ensures that a certain set of CMake features is available to
# your build.

cmake_minimum_required(VERSION 3.4.1)

# Specifies a library name, specifies whether the library is STATIC or
# SHARED, and provides relative paths to the source code. You can
# define multiple libraries by adding multiple add.library() commands,
# and CMake builds them for you. When you build your app, Gradle
# automatically packages shared libraries with your APK.

add_library( # Specifies the name of the library.
             native-lib

             # Sets the library as a shared library.
             SHARED

             # Provides a relative path to your source file(s).
             src/main/cpp/native-lib.cpp )

add_library()를 사용하여 소스 파일 또는 라이브러리를 CMake 빌드 스크립트에 추가하는 경우 프로젝트를 동기화하고 나면 Android Studio의 Project 뷰에 관련된 헤더 파일이 표시됩니다. 하지만, CMake가 컴파일 시 헤더 파일을 찾을 수 있으려면 include_directories() 명령을 CMake 빌드 스크립트에 추가하고 헤더 경로를 지정해야 합니다.

add_library(...)

# Specifies a path to native header files.
include_directories(src/main/cpp/include/)

CMake에서 라이브러리 파일의 이름을 지정하는 데 사용하는 규칙은 다음과 같습니다.

liblibrary-name.so

예를 들어, 빌드 스크립트에서 공유 라이브러리의 이름으로 "native-lib"를 지정하면 CMake가 libnative-lib.so라는 파일을 생성합니다. 하지만, Java 코드에서 이 라이브러리를 로드할 때는 CMake 빌드 스크립트에 지정한 이름을 사용합니다.

static {
    System.loadLibrary(“native-lib”);
}

참고: CMake 빌드 스크립트에 포함된 라이브러리의 이름을 변경하거나 제거하는 경우 Gradle이 변경 내용을 적용하거나 이전 버전의 라이브러리를 APK에서 제거하기 전에 프로젝트를 정리해야 합니다. 프로젝트를 정리하려면 메뉴 모음에서 Build > Clean Project를 선택합니다.

Android Studio는 소스 파일과 헤더를 Project 창의 cpp 그룹에 자동으로 추가합니다. 여러 add_library() 명령을 사용하여 CMake가 다른 여러 소스 파일에서 빌드할 추가 라이브러리를 정의할 수 있습니다.

NDK API 추가

Android NDK에서는 유용할 수 있는 일련의 네이티브 API 및 라이브러리를 제공합니다. 프로젝트의 CMakeLists.txt 스크립트 파일에 NDK 라이브러리를 포함하여 이러한 API를 사용할 수 있습니다.

미리 빌드된 NDK 라이브러리는 이미 Android 플랫폼에 존재하므로 이를 빌드하거나 APK로 패키징할 필요가 없습니다. NDK 라이브러리는 이미 CMake의 검색 경로에 포함되어 있기 때문에 로컬 NDK 설치에서 라이브러리 위치를 지정할 필요가 없습니다. 즉, 사용하려는 라이브러리 이름을 CMake에 제공하고 이를 자체 네이티브 라이브러리에 링크하기만 하면 됩니다.

NDK 라이브러리를 찾은 후 해당 경로를 변수로 저장하는 find_library() 명령을 CMake 빌드 스크립트에 추가합니다. 이 변수를 사용하여 빌드 스크립트의 다른 부분에서 NDK 라이브러리를 참조할 수 있습니다. 다음 샘플에서는 Android 관련 로그 지원 라이브러리를 찾은 후 해당 경로를 log-lib에 저장합니다.

find_library( # Defines the name of the path variable that stores the
              # location of the NDK library.
              log-lib

              # Specifies the name of the NDK library that
              # CMake needs to locate.
              log )

네이티브 라이브러리가 log 라이브러리의 함수를 호출할 수 있으려면 CMake 빌드 스크립트에서 target_link_libraries() 명령을 사용하여 라이브러리를 링크해야 합니다.

find_library(...)

# Links your native library against one or more other native libraries.
target_link_libraries( # Specifies the target library.
                       native-lib

                       # Links the log library to the target library.
                       ${log-lib} )

NDK에는 소스 코드로 몇 가지 라이브러리도 포함되어 있습니다. 이러한 라이브러리는 빌드하여 네이티브 라이브러리에 링크해야 합니다. CMake 빌드 스크립트에서 add_library() 명령을 사용하여 소스 코드를 네이티브 라이브러리로 컴파일할 수 있습니다. 로컬 NDK 라이브러리 경로를 제공하려면 ANDROID_NDK 경로 변수를 사용하면 됩니다. 이 경로 변수는 Android Studio가 자동으로 정의합니다.

다음 명령은 NativeActivity 수명 주기 이벤트 및 터치 입력을 관리하는 android_native_app_glue.c를 정적 라이브러리로 빌드한 후 이를 native-lib에 링크하도록 CMake에 지시합니다.

add_library( app-glue
             STATIC
             ${ANDROID_NDK}/sources/android/native_app_glue/android_native_app_glue.c )

# You need to link static libraries against your shared native library.
target_link_libraries( native-lib app-glue ${log-lib} )

기타 미리 빌드된 라이브러리 추가

미리 빌드된 라이브러리를 추가하는 작업은 CMake에서 빌드할 다른 네이티브 라이브러리를 지정하는 작업과 유사합니다. 하지만, 라이브러리가 이미 빌드되어 있으므로 IMPORTED 플래그를 사용하여 라이브러리를 프로젝트로 가져오는 것만 원한다는 사실을 CMake에 알려야 합니다.

add_library( imported-lib
             SHARED
             IMPORTED )

그런 다음, 아래에 표시된 대로 set_target_properties() 명령을 사용하여 라이브러리 경로를 지정해야 합니다.

일부 라이브러리에서는 특정 CPU 구조를 위한 별도의 패키지, 즉 ABI(Application Binary Interface)를 제공하고 이를 별도의 디렉토리로 구성합니다. 이 접근 방식은 개발자가 원하는 라이브러리 버전만 사용하도록 허용하는 동시에 라이브러리가 특정 CPU 구조를 활용하는 데 도움이 됩니다. 각 라이브러리 버전별로 여러 명령을 작성할 필요 없이 여러 ABI 버전의 라이브러리를 CMake 빌드 스크립트에 추가하려면 ANDROID_ABI 경로 변수를 사용하면 됩니다. 이 변수는 NDK에서 지원하는 기본 ABI 목록을 사용하거나 Gradle에서 사용하도록 수동으로 구성하는 ABI의 필터링된 목록을 사용합니다. 예:

add_library(...)
set_target_properties( # Specifies the target library.
                       imported-lib

                       # Specifies the parameter you want to define.
                       PROPERTIES IMPORTED_LOCATION

                       # Provides the path to the library you want to import.
                       imported-lib/src/${ANDROID_ABI}/libimported-lib.so )

CMake가 컴파일 시 헤더 파일을 찾을 수 있도록 하려면 include_directories() 명령을 사용하여 헤더 파일 경로를 포함해야 합니다.

include_directories( imported-lib/include/ )

참고: 빌드 시간 종속 항목이 아닌 미리 빌드된 라이브러리를 패키징하려는 경우, 예를 들어 imported-lib의 종속 항목인 미리 빌드된 라이브러리를 추가하는 경우 다음 지침을 따라 라이브러리를 링크할 필요가 없습니다.

자체 네이티브 라이브러리에 미리 빌드된 라이브러리를 링크하려면 이 라이브러리를 CMake 빌드 스크립트의 target_link_libraries() 명령에 추가합니다.

target_link_libraries( native-lib imported-lib app-glue ${log-lib} )

앱을 빌드할 때 Gradle이 가져온 라이브러리를 APK로 자동으로 패키징합니다. APK Analyzer를 사용하여 Gradle이 APK로 패키징하는 라이브러리가 무엇인지 확인할 수 있습니다. CMake 명령에 대한 자세한 내용은 CMake 문서를 참조하세요.

Gradle을 네이티브 라이브러리에 링크하려면 CMake 또는 ndk-build 스크립트 파일 경로를 제공해야 합니다. 앱을 빌드할 때 Gradle은 CMake 또는 ndk-build를 종속성으로 실행하고 공유 라이브러리를 APK로 패키징합니다. Gradle은 또한 빌드 스크립트를 사용하여 Android Studio 프로젝트로 가져올 파일을 파악합니다. 따라서 Project 창에서 이러한 파일에 액세스할 수 있습니다. 네이티브 소스에 대한 빌드 스크립트가 없는 경우 계속 진행하기 전에 CMake 빌드 스크립트를 생성해야 합니다.

Gradle을 네이티브 프로젝트에 링크하고 나면 Android Studio에서 cpp 그룹에 소스 파일 및 네이티브 라이브러리를 표시하고 External Build Files 그룹에 외부 빌드 스크립트를 표시하도록 Project 창이 업데이트됩니다.

참고: Gradle 구성을 변경할 때에는 툴바에서 Sync Project 를 클릭하여 변경 내용을 적용해야 합니다. 또한, CMake 또는 ndk-build 스크립트 파일을 이미 Gradle에 링크한 후 이러한 스크립트 파일을 변경할 때에는 메뉴 모음에서 Build > Refresh Linked C++ Projects를 선택하여 Android Studio를 변경 내용과 동기화해야 합니다.

Android Studio UI를 사용하여 Gradle을 외부 CMake 또는 ndk-build 프로젝트에 링크할 수 있습니다.

  1. IDE의 왼쪽에서 Project 창을 열고 Android 뷰를 선택합니다.
  2. 네이티브 라이브러리에 링크하려는 모듈(예: 모듈)을 마우스 오른쪽 버튼으로 클릭한 후 메뉴에서 Link C++ Project with Gradle을 선택합니다. 그럼 4에 표시된 것과 비슷한 대화상자가 표시됩니다.
  3. 드롭다운 메뉴에서 CMake 또는 ndk-build를 선택합니다.
    1. CMake를 선택하는 경우 Project Path 옆에 있는 필드를 사용하여 외부 CMake 프로젝트에 사용할 CMakeLists.txt 스크립트 파일을 지정합니다.
    2. ndk-build를 선택하는 경우 Project Path 옆에 있는 필드를 사용하여 외부 ndk-build 프로젝트에 사용할 Android.mk 스크립트 파일을 지정합니다. Android Studio는 Application.mk 파일이 Android.mk 파일과 같은 디렉토리에 있는 경우 이 파일도 포함합니다.

    그림 4. Android Studio 대화상자를 사용하여 외부 C++ 프로젝트 링크.

  4. OK를 클릭합니다.

Gradle을 수동으로 구성

네이티브 라이브러리에 링크되도록 Gradle을 수동으로 구성하려면 externalNativeBuild {} 블록을 모듈 수준의 build.gradle 파일에 추가하고 cmake {} 또는 ndkBuild {}를 사용하여 이를 구성해야 합니다.

android {
  ...
  defaultConfig {...}
  buildTypes {...}

  // Encapsulates your external native build configurations.
  externalNativeBuild {

    // Encapsulates your CMake build configurations.
    cmake {

      // Provides a relative path to your CMake build script.
      path "CMakeLists.txt"
    }
  }
}

참고: Gradle을 기존 ndk-build 프로젝트에 링크하려면 cmake {} 대신 ndkBuild {} 블록을 사용하고 Android.mk 파일의 상대 경로를 제공합니다. Gradle은 Application.mk 파일이 Android.mk 파일과 같은 디렉토리에 있는 경우 이 파일도 포함합니다.

선택적인 구성 지정

모듈 수준 build.gradle 파일의 defaultConfig {} 블록 내에서 또 다른 externalNativeBuild {} 블록을 구성하여 CMake 또는 ndk-build에 대한 선택적인 인수와 플래그를 지정할 수 있습니다. defaultConfig {} 블록의 다른 속성과 마찬가지로, 빌드 구성에서 각 제품 버전에 대해 이러한 속성을 재정의할 수 있습니다.

예를 들어, CMake 또는 ndk-build 프로젝트가 여러 네이티브 라이브러리를 정의하는 경우 targets 속성을 사용하여 지정된 제품 버전에 대해 이러한 라이브러리의 일부만 빌드하고 패키징할 수 있습니다. 다음 코드 샘플에서는 구성할 수 있는 속성 일부에 대해 설명합니다.

android {
  ...
  defaultConfig {
    ...
    // This block is different from the one you use to link Gradle
    // to your CMake or ndk-build script.
    externalNativeBuild {

      // For ndk-build, instead use ndkBuild {}
      cmake {

        // Passes optional arguments to CMake.
        arguments "-DANDROID_ARM_NEON=TRUE", "-DANDROID_TOOLCHAIN=clang"

        // Sets optional flags for the C compiler.
        cFlags "-D_EXAMPLE_C_FLAG1", "-D_EXAMPLE_C_FLAG2"

        // Sets a flag to enable format macro constants for the C++ compiler.
        cppFlags "-D__STDC_FORMAT_MACROS"
      }
    }
  }

  buildTypes {...}

  productFlavors {
    ...
    demo {
      ...
      externalNativeBuild {
        cmake {
          ...
          // Specifies which native libraries to build and package for this
          // product flavor. If you don't configure this property, Gradle
          // builds and packages all shared object libraries that you define
          // in your CMake or ndk-build project.
          targets "native-lib-demo"
        }
      }
    }

    paid {
      ...
      externalNativeBuild {
        cmake {
          ...
          targets "native-lib-paid"
        }
      }
    }
  }

  // Use this block to link Gradle to your CMake or ndk-build script.
  externalNativeBuild {
    cmake {...}
    // or ndkBuild {...}
  }
}

제품 버전 및 빌드 변형을 구성하는 방법에 대한 자세한 내용은 빌드 변형 구성을 참조하세요. arguments 속성을 사용하여 CMake에 대해 구성할 수 있는 변수 목록은 CMake 변수 사용을 참조하세요.

ABI 지정

기본적으로, Gradle은 네이티브 라이브러리를 NDK에서 지원하는 ABI에 대한 별도의 .so 파일로 빌드하고 이를 모두 APK로 패키징합니다. Gradle이 네이티브 라이브러리의 특정 ABI 구성만 빌드하고 패키징하도록 하려는 경우 아래에 표시된 대로 모듈 수준의 build.gradle 파일에서 ndk.abiFilters 플래그를 사용하여 이를 지정할 수 있습니다.

android {
  ...
  defaultConfig {
    ...
    externalNativeBuild {
      cmake {...}
      // or ndkBuild {...}
    }

    ndk {
      // Specifies the ABI configurations of your native
      // libraries Gradle should build and package with your APK.
      abiFilters 'x86', 'x86_64', 'armeabi', 'armeabi-v7a',
                   'arm64-v8a'
    }
  }
  buildTypes {...}
  externalNativeBuild {...}
}

대부분의 경우, 위에 표시된 대로 ndk {} 블록에 abiFilters만 지정하면 됩니다. 이는 Gradle에 이러한 버전의 네이티브 라이브러리를 빌드하고 패키징하도록 지시합니다. 하지만, APK로 패키징하려는 항목과 별개로 Gradle에서 빌드해야 하는 항목을 제어하려는 경우에는 defaultConfig.externalNativeBuild.cmake {} 블록(또는 defaultConfig.externalNativeBuild.ndkBuild {} 블록)에 또 다른 abiFilters 플래그를 구성합니다. 그러면 Gradle이 이러한 API 구성을 빌드하되, defaultConfig.ndk{} 블록에 지정하는 항목만 패키징합니다.

APK 크기를 추가로 줄이려면 모든 버전의 네이티브 라이브러리가 포함된 하나의 대형 APK를 생성하는 대신 ABI APK 분할을 구성하는 것이 좋습니다. Gradle은 지원하려는 각 ABI에 대해 별도의 APK를 생성하고 각 ABI에 필요한 파일만 패키징합니다. 위의 코드 샘플에 표시된 것처럼 abiFilters 플래그를 지정하지 않고 ABI 분할을 구성하면 Gradle이 지원되는 모든 ABI 버전의 네이티브 라이브러리를 빌드하되, ABI 분할 구성에서 지정하는 항목만 패키징합니다. 원치 않는 네이티브 라이브러리 버전을 빌드하지 않으려면 abiFilters 플래그와 ABI 분할 구성 모두에 동일한 ABI 목록을 제공해야 합니다.

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.