Documentation Oracle Cloud Infrastructure

Ajout du kit SDK client Oracle Android au projet

Voici des détails sur l'ajout du kit SDK client natif Oracle Android à votre projet.

Pour ajouter le SDK à l'aide de la version Arctic Fox d'Android Studio ou d'une version ultérieure :
  1. Téléchargez le kit SDK du client ODA pour Android et extrayez-le vers votre système local.
  2. Dans Android Studio, sélectionnez le répertoire app de votre projet.
  3. Sélectionnez le répertoire libs.
  4. Ajoutez com.oracle.bots.client.sdk.android.core-24.12.aar et com.oracle.bots.client.sdk.android.ui-24.12.aar au dossier libs.
  5. Ajoutez ce qui suit aux dépendances dans le fichier build.gradle (Module: app). Ces dépendances incluent :
    • la dépendance de bibliothèque de kit SDK,
    • Dépendances principales et d'interface utilisateur : utilisées par la bibliothèque SDK pour un fonctionnement optimal des fonctionnalités de la bibliothèque.
         // SDK
       implementation files('libs/com.oracle.bots.client.sdk.android.ui-24.12.aar')
       implementation files('libs/com.oracle.bots.client.sdk.android.core-24.12.aar')

       // Core dependencies
       implementation 'androidx.room:room-runtime:2.6.1'
       implementation 'io.socket:socket.io-client:0.8.3'
       implementation 'androidx.core:core:1.15.0'

       //UI dependencies
       implementation 'androidx.appcompat:appcompat:1.7.0'
       implementation 'androidx.constraintlayout:constraintlayout:2.2.0'
       implementation 'androidx.webkit:webkit:1.12.1'
       implementation 'com.google.android.material:material:1.12.0'
       implementation 'com.intuit.sdp:sdp-android:1.0.6'
       implementation 'com.squareup.picasso:picasso:2.8'
       implementation 'com.google.android.gms:play-services-location:21.3.0'
  6. Mettez à jour le fichier AndroidManifest.xml avec les droits d'accès permettant à l'application hôte d'utiliser les fonctionnalités prises en charge par le kit SDK client Android. Vous devez déclarer ces autorisations dans le manifeste à partir de la version 24.12 et supérieure du SDK client Android.
    Remarque

    Vous pouvez omettre les droits d'accès qui ne s'appliquent pas à votre application. 
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
    <uses-permission android:name="android.permission.READ_MEDIA_AUDIO"/>
    <uses-permission android:name="android.permission.READ_MEDIA_VIDEO"/>
    <uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>
    <uses-permission android:name="android.permission.READ_MEDIA_VISUAL_USER_SELECTED"/>
    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    <uses-permission android:name="android.permission.CAMERA" />
    <uses-feature
    android:name="android.hardware.camera"
    android:required="false" />
Pour les versions antérieures d'Android Studio :
  1. Sélectionnez le répertoire app de votre projet, puis cliquez sur Fichier> Nouveau> Nouveau module.
  2. Sélectionnez Importer le package JAR/.AAR, puis cliquez sur Suivant.
  3. Accédez à com.oracle.bots.client.sdk.android.core-24.08.aar et sélectionnez ce dernier. Cliquez sur Terminer.
  4. Suivez ces étapes pour importer com.oracle.bots.client.sdk.android.ui-24.08.aar.
    Remarque

    Vous n'avez pas besoin d'importer ce package si vous utilisez le kit SDK en mode sans interface utilisateur.
  5. Assurez-vous que ces bibliothèques sont répertoriées en haut du fichier settings.gradle du projet. Par exemple :
     include ':app', ':com.oracle.bots.client.sdk.android.core-24.12', ':com.oracle.bots.client.sdk.android.ui-24.12'
    rootProject.name = 'ODASDKSample'
  6. Ajoutez ce qui suit aux dépendances dans le fichier build.gradle (Module: app). Ces dépendances incluent :
    • la dépendance de bibliothèque de kit SDK,
    • les dépendances principales et d'interface utilisateur utilisées par la bibliothèque de kit SDK pour un fonctionnement optimal des fonctionnalités de la bibliothèque.
       // SDK
       implementation files('libs/com.oracle.bots.client.sdk.android.ui-24.08.aar')
       implementation files('libs/com.oracle.bots.client.sdk.android.core-24.08.aar')

       // Core dependencies
       implementation 'androidx.room:room-runtime:2.5.1'
       implementation 'io.socket:socket.io-client:0.8.3'
       implementation 'androidx.core:core:1.8.0'

       //UI dependencies
       implementation 'androidx.appcompat:appcompat:1.6.1'
       implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
       implementation 'androidx.webkit:webkit:1.10.0'
       implementation 'com.google.android.material:material:1.8.0'
       implementation 'com.intuit.sdp:sdp-android:1.0.6'
       implementation 'com.squareup.picasso:picasso:2.8'
       implementation 'com.google.android.gms:play-services-location:21.2.0'