VNDK 사용 설정

VNDK는 공급업체와 시스템 간의 문제를 분리하기 위해 코드베이스에 여러 변경사항을 적용합니다. 다음 가이드를 사용하여 VNDK를 공급업체/OEM 코드베이스에 사용 설정하세요.

빌드 시스템 라이브러리

빌드 시스템에는 라이브러리(공유, 정적 또는 헤더) 및 바이너리를 비롯한 여러 유형의 객체가 포함됩니다.

그림 1. 빌드 시스템 라이브러리
  • core. 시스템 이미지에서 사용하고 시스템 이미지에 있습니다. 이러한 라이브러리는 vendor, vendor_available, vndk 또는 vndk-sp 라이브러리에서 사용할 수 없습니다.
        cc_library {
            name: "libThatIsCore",
            ...
        }
        
  • vendor-only(또는 proprietary). 공급업체 이미지에서 사용하고 공급업체 이미지에 있습니다.
        cc_library {
            name: "libThatIsVendorOnly",
            proprietary: true,
            # or: vendor: true, # (for things in AOSP)
            ...
        }
    
        
  • vendor_available. 공급업체 이미지에서 사용하고 공급업체 이미지에 있습니다(core의 중복이 포함될 수 있음).
        cc_library {
            name: "libThatIsVendorAvailable",
            vendor_available: true,
            ...
        }
        
  • vndk. 공급업체 이미지에서 사용하고 시스템 이미지에 있습니다(vendor_available의 하위집합).
        cc_library {
            name: "libThatIsVndk",
            vendor_available: true,
            vndk: {
                enabled: true,
            }
            ...
        }
        
  • vndk-sp. 시스템 이미지에서 간접적으로 사용하고 시스템 이미지에 있습니다(core의 하위집합).
        cc_library {
            name: "libThatIsVndkSp",
            vendor_available: true,
            vndk: {
                enabled: true,
                support_system_process: true,
            }
            ...
        }
        
  • llndk. 시스템 및 공급업체 이미지에서 모두 사용합니다.
        llndk_library {
            name: "libThasIsLlndk",
        }
        

lib가 vendor_available:true로 표시되면 다음과 같이 두 번 빌드됩니다.

  • 플랫폼에 1회(/system/lib에 설치됨)
  • 공급업체에 1회(/vendor/lib, /system/lib/vndk 또는 /system/lib/vndk-sp에 설치됨).

lib의 공급업체 버전은 -D__ANDROID_VNDK__로 빌드됩니다. Android의 향후 버전에서 크게 변경될 수 있는 비공개 시스템 구성요소는 이 플래그로 사용 중지됩니다. 또한, 다른 라이브러리는 다른 헤더 집합(예: liblog)을 내보냅니다. 타겟의 공급업체 변형과 관련된 옵션은 다음 위치의 Android.bp 파일에 지정할 수 있습니다.

target: { vendor: { … } }

코드베이스에 VNDK 사용 설정

코드베이스에 VNDK를 사용 설정하는 방법은 다음과 같습니다.

  1. vendor.imgsystem.img 파티션에서 필요한 크기를 계산하여 자격 요건을 확인합니다.
  2. BOARD_VNDK_VERSION=current를 사용합니다. BoardConfig.mk에 추가하거나 이 구문으로 구성요소를 직접 빌드할 수 있습니다(즉, m -j BOARD_VNDK_VERSION=current MY-LIB).

BOARD_VNDK_VERSION=current를 사용한 후에는 빌드 시스템에서 다음 종속 항목과 헤더 요구사항을 적용합니다.

종속 항목 관리

vndk에 없거나 vendor 객체로 존재하지 않는 core 구성요소에 종속되는 vendor 객체는 다음 옵션 중 하나를 사용하여 해결해야 합니다.

  • 종속 항목을 제거할 수 있습니다.
  • vendor에서 core 구성요소를 소유한 경우 vendor_available 또는 vendor로 표시될 수 있습니다.
  • vndk의 핵심 객체 부분을 이루는 변경사항을 Google로 업스트림할 수 있습니다.

또한, core 구성요소가 vendor 구성요소에 종속되어 있다면 vendor 구성요소를 core 구성요소로 만들거나 또는 종속 항목이 다른 방법으로 삭제되어야 합니다(예: 종속 항목을 삭제하거나 vendor 구성요소로 이동).

헤더 관리

빌드 시스템에서 헤더 빌드 시 -D__ANDROID_VNDK__의 사용 여부를 알 수 있도록 전역 헤더의 종속 항목은 삭제되어야 합니다. 예를 들어, utils/StrongPointer.h와 같은 libutils 헤더에 계속 헤더 라이브러리 libutils_headers를 사용하여 액세스할 수 있습니다.

일부 헤더(예: unistd.h)는 더 이상 전이하여 포함될 수 없지만, 로컬로 포함될 수 있습니다.

마지막으로, private/android_filesystem_config.h의 공개 부분은 cutils/android_filesystem_config.h로 이동했습니다. 이러한 헤더를 관리하려면 다음 중 하나를 실행해야 합니다.

  • 가능하다면 getgrnam/getpwnam 호출로 모든 AID_* 매크로를 대체하여 private/android_filesystem_config.h에 연결된 종속 항목을 삭제합니다. 예:
    • (uid_t)AID_WIFIgetpwnam("wifi")->pw_uid가 됩니다.
    • (gid_t)AID_SDCARD_Rgetgrnam("sdcard_r")->gr_gid가 됩니다.
    자세한 내용은 private/android_filesystem_config.h를 참조하세요.
  • 하드 코딩된 AIS의 경우 cutils/android_filesystem_config.h를 포함합니다.