Compatibilidad con Neon

El NDK admite la extensión Advanced SIMD de ARM, más conocida como Neon, una extensión opcional del conjunto de instrucciones para ARMv7 y ARMv8. Neon proporciona instrucciones y registros escalares y vectoriales (que se comparten con las FPU) similares a MMX/SSE/3DNow! en el entorno x86.

No todos los dispositivos Android basados en ARMv7 admiten Neon, pero los que sí lo hacen pueden aprovechar al máximo su compatibilidad con instrucciones escalares y vectoriales.

Todos los dispositivos basados en ARMv8 admiten Neon.

El NDK admite la compilación de módulos o, incluso, de archivos de origen específicos que admiten Neon. Puedes usar las funciones intrínsecas de Neon en el código C y C++ para aprovechar la extensión Advanced SIMD. La Guía del programador de Neon para Armv8-A proporciona más información sobre las funciones intrínsecas de Neon y la programación de Neon en general.

Compilación

Cómo habilitar Neon a nivel global

ndk-build

ndk-build no permite habilitar Neon a nivel global. Para habilitar Neon en una aplicación ndk-build completa, implementa los pasos por módulo en cada módulo de tu aplicación.

CMake

Pasa -DANDROID_ARM_NEON=ON cuando invoques a CMake. Si compilas con Android Studio o Gradle, configura la siguiente opción en tu archivo build.gradle:

android {
        defaultConfig {
            externalNativeBuild {
                cmake {
                    arguments "-DANDROID_ARM_NEON=ON"
                }
            }
        }
    }
    

Cómo habilitar Neon por módulo

ndk-build

Para compilar todos los archivos de origen en un módulo ndk-build con NEON, agrega lo siguiente a la definición del módulo en tu archivo Android.mk:

LOCAL_ARM_NEON := true
    

CMake

Para compilar todos los archivos de origen en un destino CMake con NEON, agrega lo siguiente a tu archivo CMakeLists.txt:

if(ANDROID_ABI STREQ armeabi-v7a)
        set_target_properties(${TARGET} PROPERTIES COMPILE_FLAGS -mfpu=neon)
    endif()
    

${TARGET} se reemplaza por el nombre de tu biblioteca.

Puede resultarte muy útil compilar todos los archivos de origen de manera que admitan Neon si quieres compilar una biblioteca compartida o estática que contenga específicamente solo código Neon.

Cómo habilitar Neon por archivo de origen

ndk-build

Al enumerar los archivos de origen para tu variable LOCAL_SRC_FILES, puedes usar el sufijo .neon para indicar que quieres compilar archivos individuales que admiten Neon. Por ejemplo, a continuación, se compila un archivo (foo.c) que admite Neon y otro (bar.c) que no:

LOCAL_SRC_FILES := foo.c.neon bar.c
    

Puedes combinar el sufijo .neon con .arm, que especifica el conjunto de instrucciones de ARM de 32 bits (en lugar de Thumb2) para las instrucciones que no son de Neon. En ese caso, .arm debe aparecer antes que .neon. Por ejemplo: foo.c.arm.neon funciona, pero foo.c.neon.arm no.

CMake

Para compilar un archivo de origen específico con Neon, agrega lo siguiente a tu archivo CMakeLists.txt:

if(ANDROID_ABI STREQ armeabi-v7a)
        set_source_files_properties(foo.cpp PROPERTIES COMPILE_FLAGS -mfpu=neon)
    endif()
    

Detección del entorno de ejecución

No todos los dispositivos Android basados en ARMv7 admiten Neon. Para lograr máxima compatibilidad, el código de 32 bits debe realizar la detección del entorno de ejecución a fin de confirmar que se puede ejecutar el código de Neon en el dispositivo de destino. La app puede realizar esta verificación mediante cualquiera de las opciones mencionadas en Cómo tratar con funciones de CPU.

Como opción, se pueden filtrar dispositivos no compatibles en Google Play Console. Además, puedes usar la consola para ver cuántos dispositivos estarían afectados.

Compatibilidad entre plataformas para x86

NDK admite la compilación multiplataforma de tus funciones intrínsecas existentes de ARM SIMD (Neon) en código x86 de SSE, mediante el uso de NEON_2_SSE.h de terceros. Para obtener más información sobre este tema, consulta De ARM NEON a Intel SSE: La solución de portabilidad automática, consejos y trucos.

Código de muestra

La muestra hello-neon proporciona un ejemplo de cómo usar la biblioteca cpufeatures y los elementos intrínsecos de Neon al mismo tiempo. En esta muestra, se implementa una pequeña referencia para un bucle de filtros FIR con una versión C y una optimizada para Neon correspondiente a dispositivos compatibles con Neon.