Compatibilité avec Neon

Le NDK est compatible avec ARM Advanced SIMD, communément appelé Neon, une extension facultative contenant un ensemble d'instructions pour ARMv7 et ARMv8. Neon fournit des instructions et des registres scalaires/vectoriels (partagés avec le FPU) comparables à MMX/SSE/3DNow! dans un environnement x86.

Tous les appareils Android basés sur ARMv8 ("arm64") sont compatibles avec Neon. Presque tous les appareils Android basés sur ARMv7 ("32 bits") sont compatibles avec Neon, y compris l'ensemble des appareils livrés avec le niveau d'API 21 ou supérieur. Le NDK active Neon par défaut pour les deux ABI Arm.

Si vous ciblez des appareils très anciens, vous pouvez filtrer les appareils incompatibles dans la Google Play Console. Vous pouvez également utiliser la console pour votre application afin de voir le nombre d'appareils concernés.

Pour assurer une compatibilité maximale, le code 32 bits peut procéder à la détection de l'environnement d'exécution afin de vérifier que le code Neon peut être exécuté sur l'appareil cible. Une application peut effectuer cette vérification à l'aide de l'une des options mentionnées dans Fonctionnalités du processeur.

Vous ne devez pas écrire de fonctionnalités intrinsèques Neon explicites dans votre code C/C++. Les types de vecteurs portables de Clang utiliseront automatiquement les instructions Neon. Les intrinsèques Neon de Clang ne sont en fait qu'un wrapper non portable autour des types portables. Par conséquent, l'écriture d'intrinsèques Neon ne rendra pas votre code plus rapide que l'utilisation des types portables, mais le rendra moins portable.

Créer

Désactiver Neon de manière globale

ndk-build

ndk-build ne permet pas de désactiver Neon de manière globale. Pour désactiver Neon sur l'ensemble d'une application ndk-build, appliquez la procédure "Désactiver Neon pour un module" à chaque module de l'application.

CMake

Transmettez -DANDROID_ARM_NEON=ON lors de l'appel de CMake. Si vous compilez votre application à l'aide d'Android Studio/Gradle, définissez l'option suivante dans votre fichier build.gradle :

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

Désactiver Neon pour un module

ndk-build

Pour créer tous les fichiers sources d'un module ndk-build sans Neon, ajoutez ce qui suit à la définition du module dans votre fichier Android.mk :

LOCAL_ARM_NEON := false

CMake

Pour créer tous les fichiers sources d'une cible CMake sans Neon, ajoutez ce qui suit à votre fichier CMakeLists.txt :

if(ANDROID_ABI STREQUAL armeabi-v7a)
    set_target_properties(${TARGET} PROPERTIES COMPILE_FLAGS -mfpu=vfpv3-d16)
endif()

Remplacez ${TARGET} par le nom de votre bibliothèque.

Compatibilité multiplate-forme pour x86

Le NDK est compatible avec la compilation multiplate-forme de vos fonctionnalités intrinsèques ARM SIMD (Neon) dans le code SSE x86 à l'aide du fichier tiers NEON_2_SSE.h. Pour plus d'informations sur ce sujet, consultez l'article From ARM NEON to Intel SSE-the automatic porting solution, tips and tricks.

Exemple de code

L'exemple de vectorisation montre comment utiliser différents outils de vectorisation pour implémenter une multiplication matricielle et compare leurs performances.