Configuration native

Ce guide vous explique comment configurer votre projet Android natif pour utiliser l'API Play Integrity à partir de C ou C++. Avant de pouvoir effectuer des appels à l'API, vous devez d'abord intégrer le SDK natif Play Core en configurant votre environnement de développement et en mettant à jour vos fichiers build.gradle et CMakeLists.txt, comme indiqué dans la section suivante. Pour en savoir plus, consultez notre documentation de référence sur l'API native.

1. Effectuez l'une des opérations suivantes :

   • Installez Android Studio version 4.0 ou ultérieure. À l'aide de l'interface utilisateur SDK Manager, installez la version 10.0 d'Android SDK Platform (niveau d'API 29).
   • Installez les outils de ligne de commande du SDK Android et utilisez sdkmanager pour installer la version 10.0 d'Android SDK Platform (niveau d'API 29).

2. Préparez Android Studio pour le développement natif en installant la dernière version de CMake et du kit de développement natif Android (NDK) à l'aide de SDK Manager. Pour en savoir plus sur la création ou l'importation de projets natifs, consultez Premiers pas avec le kit NDK.

3. Téléchargez le fichier ZIP et extrayez-le avec votre projet.

   Lien de téléchargement	Taille	Somme de contrôle SHA256
   play-core-native-sdk-1.15.4.zip	39,6 Mio	92b43246860d4ce4772a3a0786212d9b4781920e112d81b93ca1c5ebd8da89cb

4. Mettez à jour le fichier build.gradle de votre application comme indiqué ci-dessous :

   Groovy

       // App build.gradle
   
       plugins {
         id 'com.android.application'
       }
   
       // Define a path to the extracted Play Core SDK files.
       // If using a relative path, wrap it with file() since CMake requires absolute paths.
       def playcoreDir = file('../path/to/playcore-native-sdk')
   
       android {
           defaultConfig {
               ...
               externalNativeBuild {
                   cmake {
                       // Define the PLAYCORE_LOCATION directive.
                       arguments "-DANDROID_STL=c++_static",
                                 "-DPLAYCORE_LOCATION=$playcoreDir"
                   }
               }
               ndk {
                   // Skip deprecated ABIs. Only required when using NDK 16 or earlier.
                   abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
               }
           }
           buildTypes {
               release {
                   // Include Play Core Library proguard config files to strip unused code while retaining the Java symbols needed for JNI.
                   proguardFile '$playcoreDir/proguard/common.pgcfg'
                   proguardFile '$playcoreDir/proguard/gms_task.pgcfg'
                   proguardFile '$playcoreDir/proguard/per-feature-proguard-files'
                   ...
               }
               debug {
                   ...
               }
           }
           externalNativeBuild {
               cmake {
                   path 'src/main/CMakeLists.txt'
               }
           }
       }
   
       dependencies {
           // Import these feature-specific AARs for each Google Play Core library.
           implementation 'com.google.android.play:app-update:2.1.0'
           implementation 'com.google.android.play:asset-delivery:2.3.0'
           implementation 'com.google.android.play:integrity:1.4.0'
           implementation 'com.google.android.play:review:2.0.2'
   
           // Import these common dependencies.
           implementation 'com.google.android.gms:play-services-tasks:18.0.2'
           implementation files("$playcoreDir/playcore-native-metadata.jar")
           ...
       }
       

   Kotlin

   // App build.gradle
   
   plugins {
       id("com.android.application")
   }
   
   // Define a path to the extracted Play Core SDK files.
   // If using a relative path, wrap it with file() since CMake requires absolute paths.
   val playcoreDir = file("../path/to/playcore-native-sdk")
   
   android {
       defaultConfig {
           ...
           externalNativeBuild {
               cmake {
                   // Define the PLAYCORE_LOCATION directive.
                   arguments += listOf("-DANDROID_STL=c++_static", "-DPLAYCORE_LOCATION=$playcoreDir")
               }
           }
           ndk {
               // Skip deprecated ABIs. Only required when using NDK 16 or earlier.
               abiFilters.clear()
               abiFilters += listOf("armeabi-v7a", "arm64-v8a", "x86", "x86_64")
           }
       }
       buildTypes {
           release {
               // Include Play Core Library proguard config files to strip unused code while retaining the Java symbols needed for JNI.
               proguardFile("$playcoreDir/proguard/common.pgcfg")
               proguardFile("$playcoreDir/proguard/gms_task.pgcfg")
               proguardFile("$playcoreDir/proguard/per-feature-proguard-files")
               ...
           }
           debug {
               ...
           }
       }
       externalNativeBuild {
           cmake {
               path = "src/main/CMakeLists.txt"
           }
       }
   }
   
   dependencies {
       // Import these feature-specific AARs for each Google Play Core library.
       implementation("com.google.android.play:app-update:2.1.0")
       implementation("com.google.android.play:asset-delivery:2.3.0")
       implementation("com.google.android.play:integrity:1.4.0")
       implementation("com.google.android.play:review:2.0.2")
   
       // Import these common dependencies.
       implementation("com.google.android.gms:play-services-tasks:18.0.2")
       implementation(files("$playcoreDir/playcore-native-metadata.jar"))
       ...
   }

5. Mettez à jour les fichiers CMakeLists.txt de votre application comme indiqué ci-dessous :

   cmake_minimum_required(VERSION 3.6)
   
   ...
   
   # Add a static library called “playcore” built with the c++_static STL.
   include(${PLAYCORE_LOCATION}/playcore.cmake)
   add_playcore_static_library()
   
   // In this example “main” is your native code library, i.e. libmain.so.
   add_library(main SHARED
           ...)
   
   target_include_directories(main PRIVATE
           ${PLAYCORE_LOCATION}/include
           ...)
   
   target_link_libraries(main
           android
           playcore
           ...)
   

Collecte des données

Le SDK natif Play Core peut collecter des données liées à la version pour permettre à Google d'améliorer le produit, y compris :

• Nom du package de l'application
• Version du package de l'application
• Version du SDK natif Play Core

Ces données seront collectées lorsque vous importerez votre package d'application dans la Play Console. Pour désactiver ce processus de collecte des données, supprimez l'importation $playcoreDir/playcore-native-metadata.jar dans le fichier build.gradle.

Notez que cette collecte de données liée à votre utilisation du SDK natif Play Core et l'utilisation par Google des données collectées sont des opérations distinctes et indépendantes de la collecte de dépendances de bibliothèque que Google déclare dans Gradle lorsque vous importez votre package d'application dans la Play Console.