Android.bp

Android.bp

Android.bp 파일에 대해서 파악해보고, APP 빌드시에 사용되는 옵션에 대해서 살펴보자.

안드로이드 7.0 이전 버젼에서는 Android.mk 파일을 빌드로 사용하였는데, 이후 버젼에서는 Soong 빌드 시스템을 이용한 Android.bp 시스템으로 변경되었다.


참고자료

https://source.android.com/docs/setup/build?hl=ko

https://ci.android.com/builds/submitted/10510886/linux/latest/view/soong_build.html


android_app 모듈

android_app은 Android Build System에서 사용되는 Android.bp 파일의 한 유형입니다. 이 모듈은 Android 애플리케이션을 빌드하기 위해 필요한 설정과 지침을 제공합니다.

android_app 모듈을 사용하면 애플리케이션의 리소스, 매니페스트 파일, 네이티브 코드 등을 포함하는 전체 패키지를 빌드할 수 있습니다.

android_app 모듈은 일반적으로 다음과 같은 필드를 포함합니다:

  • name: 애플리케이션 모듈의 이름을 지정합니다.
  • srcs: 애플리케이션에 포함되는 Java 소스 파일을 지정합니다.
  • manifest: 애플리케이션의 Android 매니페스트 파일을 지정합니다.
  • resource_dirs: 애플리케이션의 리소스 디렉토리를 지정합니다.
  • static_libs 또는 shared_libs: 애플리케이션이 종속하는 라이브러리 모듈을 지정합니다.
  • package_name: 애플리케이션의 패키지 이름을 지정합니다.
  • privileged: 시스템 권한이 있는 프라이빌리지드 애플리케이션 여부를 지정합니다.
  • platform_apis: true: 플랫폼 API에 액세스할 수 있는지를 나타내는 플래그입니다.
  • android_app 모듈은 cc_module 모듈과 상호작용할 수도 있습니다.

예를 들어, 애플리케이션에 C/C++ 네이티브 코드가 포함되어 있는 경우, cc_module 모듈을 정의하여 해당 코드를 빌드하고 android_app 모듈에서 종속성으로 지정할 수 있습니다.

Android.bp 파일을 사용하여 애플리케이션의 빌드를 정의하면 Android Build System이 해당 지침에 따라 애플리케이션을 빌드하고 패키징하여 APK(Android Package) 파일을 생성합니다.

android_app AIDL Example

// Copyright (C) 2019 The Android Open Source Project
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package {
    default_applicable_licenses: ["Android-Apache-2.0"],
}

android_app {
    name: "PACKAGE_NAME",

    manifest: "src/main/AndroidManifest.xml",

    srcs: [
        "src/**/*.kt",
        "src/**/I*.aidl",
    ],

    libs: [
        "android.car",
    ],

    static_libs: [
        "androidx.appcompat_appcompat",
    ],

    aidl: {
        local_include_dirs: ["src/main/aidl"],
    },

    platform_apis: true,

    certificate: "platform",
    
    privileged: true,

}

Android.bp 파일 상세 설명

라이선싱 정보

코드는 저작권 정보와 Apache License 2.0에 따라 라이선스가 부여되었음을 나타내는 헤더로 시작합니다. 이 라이선스는 모든 사용자가 해당 코드를 Apache License 2.0에 따라 사용할 수 있다는 것을 의미합니다. 라이선스 전문은 http://www.apache.org/licenses/LICENSE-2.0에서 확인할 수 있습니다.

패키지 정보

이 애플리케이션의 Android 패키지 이름은 "PACKAGENAME"로 지정되어 있습니다. 이는 앱의 고유한 식별자로 사용됩니다.

매니페스트 파일

"src/main/AndroidManifest.xml"에 있는 매니페스트 파일의 경로가 지정되어 있습니다. 매니페스트는 Android 앱의 구성 정보를 포함하고 있습니다.

소스 코드

앱의 소스 코드 파일은 "src//*.kt"와 "src//I*.aidl"로 지정되어 있습니다. 이것은 Kotlin 파일과 "I"로 시작하는 AIDL 파일을 모두 포함합니다.

libs

해당 애플리케이션이 의존하는 네이티브 라이브러리(Native library)를 지정하는 데 사용(Java나 Kotlin으로 작성된 코드뿐만 아니라 C/C++로 작성된 네이티브 코드도 포함할 수 있습니다. "android.car" 라이브러리를 사용합니다.

static_libs

이 속성은 해당 애플리케이션이 의존하는 정적 라이브러리(static library)를 지정하는 데 사용되며, 빌드될 때 함께 컴파일되고 애플리케이션에 포함됩니다.

"androidx.appcompat_appcompat" 라이브러리를 사용합니다. 라이브러리는 앱에서 필요로 하는 기능들을 제공합니다.

"androidx.appcompat_appcompat"는 AndroidX 라이브러리 중 하나로, 앱의 호환성과 일관성을 제공하기 위해 사용되는 지원 라이브러리입니다. 이 라이브러리는 Android 프레임워크의 기능과 레이아웃을 이전 버전의 Android OS와 호환되도록 지원하며, 또한 최신 Android 버전과도 호환성을 유지할 수 있도록 도와줍니다.


AIDL

AIDL (Android Interface Definition Language) 디렉토리의 경로가 "src/main/aidl"로 지정되어 있습니다. AIDL은 Android 앱 간의 인터페이스를 정의하기 위해 사용되는 언어입니다.

해당 부분이 설정되어 있어야, AIDL 파일 간의 통신이 가능하게 됩니다.

플랫폼 API

"platform_apis"가 true로 설정되어 있습니다. 이는 이 앱이 Android 플랫폼 API에 접근할 수 있음을 의미합니다.

안드로이드 플랫폼 API를 사용해야 하는지 여부 설정. false로 설정할 경우 Android API 사용 불가합니다.

인증서:

"certificate"는 "platform"으로 설정되어 있습니다. 이는 앱이 플랫폼 인증서로 서명되었음을 나타냅니다.

특권 앱:

"privileged"가 true로 설정되어 있습니다. 이는 이 앱이 특정 시스템 권한을 갖고 실행되는 특권 앱임을 의미합니다.

애플리케이션을 특권(privileged) 애플리케이션으로 설정하는 데 사용합니다.

특권 애플리케이션은 시스템의 특정 권한과 기능에 액세스할 수 있는 특권을 가지고 있습니다. 

이러한 특권은 일반적으로 안드로이드 플랫폼의 핵심 기능이나 시스템 레벨의 작업을 수행하는 데 필요합니다.

위의 코드 조각은 Android 애플리케이션의 기본 빌드 구성을 정의하는데 사용되며, 빌드 시스템에 의해 이에 따라 앱이 빌드 및 패키징됩니다.

AIDL 옵션 

AIDL(Automation Interface Definition Language)은 Android 앱 간의 인터페이스를 정의하기 위해 사용되는 언어입니다. 주로 서로 다른 앱 또는 프로세스 간에 통신이 필요한 경우에 사용되며, Android 시스템 서비스와 앱 간의 통신, IPC(Inter-Process Communication)를 가능하게 합니다.

해당 AIDL 속성들을 설명하겠습니다:

include_dirs (문자열 리스트): 

aidl 도구에 전달되는 최상위 디렉토리입니다. 이 디렉토리는 aidl 도구가 인터페이스를 컴파일할 때 사용되는 import문의 경로를 설정하는 데 사용됩니다.

local_include_dirs (문자열 리스트): 

Android.bp 파일을 기준으로 하는 디렉토리입니다. 이 디렉토리에 있는 aidl 파일들은 aidl 도구에서 컴파일할 때 사용됩니다.

export_include_dirs (문자열 리스트): 

해당 모듈에 의존하는 모듈의 aidl 소스에 추가할 include 디렉토리입니다. 또한 해당 모듈 자체의 aidl에도 사용됩니다.

generate_traces (부울): 

이 인터페이스에 대해 systrace를 생성할지 여부를 결정합니다. systrace는 Android 시스템의 작업을 추적하고 성능을 분석하는 데 사용되는 도구입니다.

generate_get_transaction_name (부울): 

Binder#GetTransaction 이름 메소드를 생성할지 여부를 나타냅니다. 이 메소드는 Binder 트랜잭션의 이름을 가져오는 데 사용됩니다.

enforce_permissions (부울): 

모든 인터페이스에 필수 권한(annotation)을 추가해야하는지 여부를 지정합니다. 이를 통해 IPC를 통한 통신에 보안을 강화할 수 있습니다.

enforce_permissions_exceptions (문자열 리스트): 

권한(annotation)이 필요하지 않은 인터페이스를 허용하는 인터페이스의 예외 목록입니다. 일시적으로 권한이 필요하지 않은 인터페이스를 설정할 때 사용됩니다.

flags (문자열 리스트):

 AIDL 컴파일러에 전달되는 플래그 리스트입니다. 이 플래그들은 AIDL 컴파일 시 동작을 수정하거나 커스터마이징하는 데 사용됩니다.

댓글

댓글 쓰기

이 블로그의 인기 게시물

Intel® HAXM installation failed 해결하기

이미지
HAXM installation failed  안드로이드 스튜디오 설치 후 AVD를 이용한 에뮬레이터 설치에서 Intel® HAXM installation failed 에러가 발생해서 해당 에러를 해결 할 수 있는 방법에 대해서 기술하기로 한다. HAXM  Hardware accelerated execution manager 으로 인텔의 하드웨어 가속 기능인 해당 툴을 설치해야지 AVD 수행이 가능하며, AVD를 빠르게 사용 가능하다. 에러 메세지 Running Intel® HAXM installer Intel HAXM installation failed! For more details, please check the installation log: C:\Users\~\AppData\Local\Temp\haxm_install-20230403_1445.log C:\Users\~\AppData\Local\Android\Sdk\extras\intel\Hardware_Accelerated_Execution_Manager\haxm_install-20230403_1445.log을(를) 찾을 수 없습니다. Intel® HAXM installation failed. To install Intel® HAXM follow the instructions found at: https://github.com/intel/haxm/wiki/Installation-Instructions-on-Windows Done 공식 가이드 https://github.com/intel/haxm/blob/master/docs/manual-windows.md 해당 PC에 가상화 지원 여부 확인 작업관리자에서 CPU 가상화 지원 여부를 확인할 수 있다. 현재 가상화가 사용 안 함으로 되어 있으며, 사용 함으로 변경할 수 있다. CPU 가상화 사용함으로 변경 하기 1) BIOS 진입  Security -> System Security 바이오스 가상화 설정 2) Virtu...
Read more »

Kotlin Interface

Kotlin Interface  Kotlin은 다중 상속을 지원하지 않는다.  특정 클래스를 동시에 두개 이상의 클래스를 상속 받는것을 의미한다.  이 때문에 자기 타입의 변수나 부모형 타입 변수에만 담을 수 있다.  만약, 생성된 객체의 주소 값을 다양한 타입에 변수에 담을 수 있도록 한다면 인터페이스를 활용하면 된다. Interface 여러 부모 클래스를 상속을 받아서 하나의 클래스에 모으고 싶을 때 사용한다. 인터페이스는 클래스가 아니므로 객체를 생성할 떄 사용할 수 없다. 단, 클래스는 한개 이상의 인터페이스를 구현할 수 있으며, 생성된 객체는 구현한 인터페이스형 참조 변수에 담을 수 있다. 인터페이스에는 추상 메서드와 일반 메서드 모두를 구현해서 사용할 수 있다. 인터페이스는 추상 클래스의 목적이 비슷하지만, 하나의 클래스에 여러 인터페이스를 구현할 수 있는 장점을 가지고 있다. fun main () { val obj1 = Inter1() // Error } interface Inter1 { fun inter1Method1 () { println ( "Inter1 의 interMethod1 입니다 ." ) } fun inter1Method2 () } 인터페이스는 객체를 생성 할 수 없으므로, 에러가 발생한다. Kotlin: Interface Inter1 does not have constructors interface Inter1 { fun inter1Method1 () { println ( "Inter1 의 interMethod1 입니다 ." ) } fun inter1Method2 () } class TestClass3: Inter1() { // Error } 인터페이스는 클래스가 아니므로 상속 받는것처럼 () 를 붙이면 안된다. Kotlin: Class 'TestClass3' is not abstract and doe...
Read more »

Kotlin this, super

Kotlin this, super this 객체 자기 자신을 지칭한다. 멤버 변수와 메서드 내부의 변수를 구분할 때 사용한다. 멤버 메서드와 메서드 내부의 메서드를 구분할 떄 사용한다. 생성자에서 다른 생성자를 호출할 때 사용한다. fun main () { val obj1 = TestClass1() obj1.testMethod1() } class TestClass1 { var a1 = 100 fun testMethod1 () { var a1 = 200 println ( "a1 : $ a1 " ) println ( "this.a1 : $this .a1" ) } } this는 객체 자신을 의미하기때문에, 클래스 자체의 멤버변수 100 을 출력한다. 코틀린에서는 메서드 안에 메서드를 만드는게 가능하다. fun main () { val obj1 = TestClass1() obj1.testMethod1() } class TestClass1 { var a1 = 100 fun testMethod1 () { fun testMethod2 () { println ( "testMethod1 내부의 testMothod1" ) } testMethod2() // 내부 함수 호출 this .testMethod2() // 클래스 멤버의 메서드 호출 } fun testMethod2 () { println ( "testMethod2" ) } }  근데, 누가 이렇게 쓸까, 동일클래스에서 클래스 멤버변수랑 메서드 내부 멤버변수의 이름을 동일하게 하거나, 클래스 멤버 메서드랑 내부 멤버 메서드 이름을 동일하게 할 경우는 없을 것으로 생각된다.  아마 정적검사툴이나 보안체크툴에서...
Read more »