Включение ВНДК

VNDK требует нескольких изменений в кодовой базе, чтобы разделить проблемы между поставщиком и системой. Используйте следующее руководство, чтобы включить VNDK в кодовой базе поставщика/OEM.

Сборка системных библиотек

Система сборки содержит несколько типов объектов, включая библиотеки (общие, статические или заголовочные) и двоичные файлы.

• 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 используются как образами системы, так и образами поставщиков.

  llndk_library {
      name: "libThatIsLlndk",
  }
  

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

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

Версии поставщиков библиотек создаются с -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 .