Включить ВНДК

Vendor Native Development Kit (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 используются образом поставщика в системном образе. 
    cc_library {
    name: "libThatIsVndk",
    vendor_available: true,
    vndk: {
        enabled: true,
    }
    ...
}
  • Библиотеки vndk-sp используются образом поставщика, а также косвенно образом системы. 
    cc_library {
    name: "libThatIsVndkSp",
    vendor_available: true,
    vndk: {
        enabled: true,
        support_system_process: true,
    }
    ...
}
  • Библиотеки llndk используются как системными, так и вендорными образами. 
    cc_library {
    name: "libThatIsLlndk",
    llndk: {
        symbol_file: "libthatisllndk.map.txt"
    }
    ...
}

Если библиотека помечена как vendor_available:true , она собирается дважды:

  • Один раз для платформы (и, таким образом, устанавливается в /system/lib )
  • Один раз для поставщика (и, таким образом, устанавливается в /vendor/lib или VNDK APEX)

Версии libs от поставщика собираются с -D__ANDROID_VNDK__ . Частные системные компоненты, которые могут значительно измениться в будущих версиях Android, отключаются с этим флагом. Кроме того, разные библиотеки экспортируют разные наборы заголовков (например, liblog ). Параметры, специфичные для варианта поставщика цели, можно указать в файле Android.bp в:

target: { vendor: { … } }

Включить VNDK для кодовой базы

Чтобы включить VNDK для кодовой базы:

  1. Определите соответствие требованиям, рассчитав требуемые размеры разделов vendor.img и system.img .
  2. Включите BOARD_VNDK_VERSION=current . Вы можете добавить в BoardConfig.mk или построить компоненты с его помощью напрямую (например, m -j BOARD_VNDK_VERSION=current MY-LIB ).

После включения BOARD_VNDK_VERSION=current система сборки применяет следующие требования к зависимостям и заголовкам.

Управлять зависимостями

Объект vendor , зависящий от core компонента, который не существует в vndk или как объект vendor должен быть разрешен с помощью одного из следующих вариантов:

  • Зависимость может быть устранена.
  • Если core компонентом владеет vendor , его можно пометить как vendor_available или vendor .
  • Изменение, делающее основной объект частью vndk , может быть передано в Google.

Кроме того, если core компонент имеет зависимости от компонента vendor , компонент vendor должен быть преобразован в core компонент или зависимость должна быть удалена иным способом (например, путем удаления зависимости или перемещения зависимости в компонент vendor ).

Управление заголовками

Глобальные зависимости заголовков должны быть удалены, чтобы система сборки знала, следует ли собирать заголовки с -D__ANDROID_VNDK__ или без него. Например, заголовки libutils, такие как utils/StrongPointer.h по-прежнему могут быть доступны с помощью библиотеки заголовков libutils_headers .

Некоторые заголовки (например, unistd.h ) больше не могут быть включены транзитивно, но могут быть включены локально.

Наконец, публичная часть private/android_filesystem_config.h была перемещена в cutils/android_filesystem_config.h . Чтобы управлять этими заголовками, выполните одно из следующих действий:

  • Удалите зависимость от private/android_filesystem_config.h , заменив все макросы AID_* вызовами getgrnam / getpwnam , если это возможно. Например:
    • (uid_t)AID_WIFI становится getpwnam("wifi")->pw_uid .
    • (gid_t)AID_SDCARD_R становится getgrnam("sdcard_r")->gr_gid .
    Подробную информацию см. в файле private/android_filesystem_config.h .
  • Для жестко закодированного AIS включите cutils/android_filesystem_config.h .