Cómo usar el kit de desarrollo nativo de Android con Bazel

Informar un problema . Ver fuente . . Por la noche · 7.3 · 7.2 · 7.1 · 7.0 · 6.5

Si es la primera vez que utilizas Bazel, comienza con el curso Cómo compilar Android con Instructivo de Bazel.

Descripción general

Bazel puede ejecutarse en muchas configuraciones de compilación diferentes, incluidas varias que usan conjunto de herramientas del kit de desarrollo nativo (NDK) de Android. Esto significa que lo normal Las reglas cc_library y cc_binary se pueden compilar para Android directamente en Bazel Bazel logra esto mediante el repositorio android_ndk_repository. .

Requisitos previos

Asegúrate de haber instalado el SDK y el NDK de Android.

Para configurar el SDK y el NDK, agrega el siguiente fragmento a tu WORKSPACE:

android_sdk_repository(
    name = "androidsdk", # Required. Name *must* be "androidsdk".
    path = "/path/to/sdk", # Optional. Can be omitted if `ANDROID_HOME` environment variable is set.
)

android_ndk_repository(
    name = "androidndk", # Required. Name *must* be "androidndk".
    path = "/path/to/ndk", # Optional. Can be omitted if `ANDROID_NDK_HOME` environment variable is set.
)

Para obtener más información sobre la regla android_ndk_repository, consulta el artículo Compila Entrada de enciclopedia.

Si estás usando una versión reciente del NDK de Android (r22 y posteriores), utiliza el Implementación de Starlark de android_ndk_repository. Sigue las instrucciones que se indican en su archivo README.

Inicio rápido

Para compilar C++ para Android, simplemente agrega dependencias cc_library a tu Reglas android_binary o android_library.

Por ejemplo, con el siguiente archivo BUILD de una app para Android:

# In <project>/app/src/main/BUILD.bazel

cc_library(
    name = "jni_lib",
    srcs = ["cpp/native-lib.cpp"],
)

android_library(
    name = "lib",
    srcs = ["java/com/example/android/bazel/MainActivity.java"],
    resource_files = glob(["res/**/*"]),
    custom_package = "com.example.android.bazel",
    manifest = "LibraryManifest.xml",
    deps = [":jni_lib"],
)

android_binary(
    name = "app",
    deps = [":lib"],
    manifest = "AndroidManifest.xml",
)

Este archivo BUILD da como resultado el siguiente gráfico de destino:

Resultados de ejemplo

Figura 1: Gráfico de compilación del proyecto de Android con dependencias de cc_library

Para compilar la app, simplemente ejecuta lo siguiente:

bazel build //app/src/main:app

El comando bazel build compila los archivos Java, los archivos de recursos de Android y cc_library y empaqueta todo en un APK:

$ zipinfo -1 bazel-bin/app/src/main/app.apk
nativedeps
lib/armeabi-v7a/libapp.so
classes.dex
AndroidManifest.xml
...
res/...
...
META-INF/CERT.SF
META-INF/CERT.RSA
META-INF/MANIFEST.MF

Bazel compila todas las bibliotecas cc_bibliotecas en un único archivo de objeto compartido (.so). está orientada a la ABI armeabi-v7a de forma predeterminada. Si quieres cambiar esto o crear contenido para varias ABI al mismo tiempo; consulta la sección sobre cómo configurar el segmento ABI.

Configuración de ejemplo

Este ejemplo está disponible en los ejemplos de Bazel Cloud Storage.

En el archivo BUILD.bazel, se definen tres destinos con android_binary. Reglas android_library y cc_library.

El objetivo de nivel superior android_binary compila el APK.

El destino cc_library contiene un solo archivo de origen C++ con una función JNI. implementación:

#include <jni.h>
#include <string>

extern "C"
JNIEXPORT jstring

JNICALL
Java_com_example_android_bazel_MainActivity_stringFromJNI(
        JNIEnv *env,
        jobject /* this */) {
    std::string hello = "Hello from C++";
    return env->NewStringUTF(hello.c_str());
}

El destino android_library especifica las fuentes de Java, los archivos de recursos y el dependencia en un objetivo cc_library. En este ejemplo, se carga MainActivity.java el archivo de objeto compartido libapp.so y define la firma del método para la JNI función:

public class MainActivity extends AppCompatActivity {

    static {
        System.loadLibrary("app");
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
       // ...
    }

    public native String stringFromJNI();

}

Cómo configurar la ABI de destino

Para configurar la ABI de destino, usa la marca --android_platforms de la siguiente manera:

bazel build //:app --android_platforms=comma-separated list of platforms

Al igual que la marca --platforms, los valores que se pasan a --android_platforms son los siguientes: las etiquetas de platform usando valores de restricción estándar para describir tu dispositivo.

Por ejemplo, para un dispositivo Android con un procesador ARM de 64 bits, definirías tu plataforma de la siguiente manera:

platform(
    name = "android_arm64",
    constraint_values = [
        "@platforms//os:android",
        "@platforms//cpu:arm64",
    ],
)

Todos los platform de Android deben usar @platforms//os:android. Restricción del SO. Para migrar la restricción de CPU, consulta este gráfico:

Valor de CPU Plataforma
armeabi-v7a @platforms//cpu:armv7
arm64-v8a @platforms//cpu:arm64
x86 @platforms//cpu:x86_32
x86_64 @platforms//cpu:x86_64

Por supuesto, en el caso de un APK multiarquitectónica, debes pasar varias etiquetas para ejemplo: --android_platforms=//:arm64,//:x86_64 (suponiendo que los definiste en tu archivo BUILD.bazel de nivel superior).

Bazel no puede seleccionar una plataforma de Android predeterminada, por lo que se debe definir y se especifica con --android_platforms.

Según la revisión del NDK y el nivel de API de Android, las siguientes ABI se disponibles:

Revisión del NDK ABI
16 y anteriores armeabi, armeabi-v7a, arm64-v8a, mips, mips64, x86, x86_64
17 y más armeabi-v7a, arm64-v8a, x86 y x86_64

Consulta la documentación del NDK para obtener más información sobre estas ABI.

No se recomienda usar APK Fat de varias ABI para compilaciones de lanzamiento, ya que aumentan el tamaño del APK, pero puede ser útil para compilaciones de desarrollo y control de calidad.

Cómo seleccionar un estándar C++

Usa las siguientes marcas para compilar según un estándar de C++:

C++ estándar Marca
C++98 Predeterminado, no se necesita marca
C++11 --cxxopt=-std=c++11
C++14 --cxxopt=-std=c++14
C++17 --cxxopt=-std=c++17

Por ejemplo:

bazel build //:app --cxxopt=-std=c++11

Obtén más información sobre cómo pasar marcas del compilador y del vinculador con --cxxopt, --copt y --linkopt en el Manual del usuario.

Las marcas del compilador y del vinculador también se pueden especificar como atributos en cc_library. con copts y linkopts. Por ejemplo:

cc_library(
    name = "jni_lib",
    srcs = ["cpp/native-lib.cpp"],
    copts = ["-std=c++11"],
    linkopts = ["-ldl"], # link against libdl
)

Cómo compilar un cc_library para Android sin usar android_binary

Para compilar un cc_binary o un cc_library independiente para Android sin usar un android_binary, usa la marca --platforms.

Por ejemplo, si definiste plataformas de Android en my/platforms/BUILD:

bazel build //my/cc/jni:target \
      --platforms=//my/platforms:x86_64

Con este enfoque, se ve afectado todo el árbol de compilación.

Estas marcas se pueden colocar en una configuración de bazelrc (una para cada ABI), en project/.bazelrc

common:android_x86 --platforms=//my/platforms:x86

common:android_armeabi-v7a --platforms=//my/platforms:armeabi-v7a

# In general
common:android_<abi> --platforms=//my/platforms:<abi>

Luego, para compilar un cc_library para x86, por ejemplo, ejecuta lo siguiente:

bazel build //my/cc/jni:target --config=android_x86

En general, usa este método para objetivos de bajo nivel (como cc_library) o cuando sabes exactamente lo que estás construyendo; se basan en la configuración automática Transiciones de android_binary para objetivos de alto nivel en los que esperas para construir muchos objetivos que no controlas.