Como usar dependências nativas

A partir do Plug-in do Android para Gradle 4.0, as dependências C/C ++ podem ser importadas de AARs vinculados ao arquivo build.gradle. O Gradle disponibiliza essas opções automaticamente para o sistema de compilação nativo, mas seu sistema de compilação precisa ser configurado para usar as bibliotecas e os cabeçalhos importados. Como as dependências C/C++ são distribuídas como AARs, os seguintes links sobre AARs genéricos podem ser úteis:

Este documento se concentra em como configurar o sistema de compilação nativo e supõe que você já adicionou um AAR de dependência C/C++ ao ambiente de build do Gradle do seu projeto.

Dependências nativas em AARs

As dependências de AAR dos módulos do Gradle podem expor bibliotecas nativas para uso pelo seu aplicativo. Dentro do AAR, o diretório prefab contém um pacote Prefab, que inclui os cabeçalhos e bibliotecas da dependência nativa.

Cada dependência pode expor, no máximo, um pacote Prefab, que compreende um ou mais módulos. Um módulo Prefab é uma única biblioteca, que pode ser compartilhada, estática ou apenas de cabeçalho.

Os nomes do pacote e do módulo precisam ser conhecidos para que você possa usar as bibliotecas. Por convenção, o nome do pacote corresponderá ao do artefato Maven, e o nome do módulo corresponderá ao da biblioteca C/C++, mas isso não é obrigatório. Consulte a documentação da dependência para determinar quais nomes são usados.

Configuração do sistema de compilação

O recurso prefab precisa estar ativado para seu módulo do Gradle para Android.

Para fazer isso, adicione o seguinte ao bloco android do arquivo build.gradle do módulo:

buildFeatures {
  prefab true
}

As dependências importadas de um AAR são expostas ao CMake por CMAKE_FIND_ROOT_PATH (link em inglês). Esse valor será definido automaticamente pelo Gradle quando o CMake for invocado. Portanto, se o build modificar essa variável, anexe-a em vez de atribuí-la.

Cada dependência expõe um pacote config-file ao build (link em inglês). Elas são importadas com o comando find_package (link em inglês). Esse comando procura por pacotes config-file que correspondam ao nome do pacote e à versão fornecidos e expõe os destinos que ele define para serem usados no build. Por exemplo, caso o aplicativo defina libapp.so e use cURL, CMakeLists.txt precisará incluir o seguinte:

add_library(app SHARED app.cpp)

# Add these two lines.
find_package(curl REQUIRED CONFIG)
target_link_libraries(app curl::curl)

app.cpp agora pode #include "curl/curl.h", libapp.so. Portanto, ele será automaticamente vinculado a libcurl.so durante a criação e libcurl.so será incluído no APK.