Documentazione di Oracle Cloud Infrastructure

Aggiungere il kit SDK client Oracle Android al progetto

Di seguito sono riportati i dettagli sull'aggiunta dell'SDK Oracle Android Native Client al progetto.

Per aggiungere l'SDK utilizzando la versione Arctic Fox di Android Studio o superiore:
  1. Scaricare l'SDK client ODA per Android ed estrarlo nel sistema locale.
  2. In Android Studio, selezionare la directory app del progetto.
  3. Selezionare la directory libs.
  4. Aggiungere com.oracle.bots.client.sdk.android.core-24.12.aar e com.oracle.bots.client.sdk.android.ui-24.12.aar alla cartella libs.
  5. Aggiungere quanto segue alle dipendenze al file build.gradle (Module: app). Di seguito sono riportate alcune delle dipendenze.
    • Dipendenza della libreria SDK
    • Dipendenze di base e dell'interfaccia utente: utilizzate dalla libreria SDK per il corretto funzionamento delle funzioni della libreria.
         // 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. Aggiornare il file AndroidManifest.xml con le autorizzazioni che consentiranno all'applicazione host di utilizzare le funzionalità supportate dall'SDK client Android. È necessario dichiarare queste autorizzazioni nel file manifesto a partire dalla versione 24.12 e successive dell'SDK client Android.
    Nota

    È possibile omettere le autorizzazioni che non si applicano all'applicazione. 
    <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" />
Per le versioni precedenti di Android Studio:
  1. Selezionare la directory app del progetto, quindi fare clic su File> Nuovo> Nuovo modulo.
  2. Scegliere Importa file JAR/. Pacchetto AAR, quindi fare clic su Avanti.
  3. Passare a com.oracle.bots.client.sdk.android.core-24.08.aar e selezionarlo. Fare clic su Fine.
  4. Ripetere la procedura per importare com.oracle.bots.client.sdk.android.ui-24.08.aar.
    Nota

    Non è necessario importare questo package se si utilizza l'SDK in modalità headless.
  5. Assicurarsi che queste librerie siano elencate nella parte superiore del file settings.gradle del progetto. Ad esempio:
     include ':app', ':com.oracle.bots.client.sdk.android.core-24.12', ':com.oracle.bots.client.sdk.android.ui-24.12'
    rootProject.name = 'ODASDKSample'
  6. Aggiungere quanto segue alle dipendenze nel file build.gradle (Module: app). Di seguito sono riportate alcune delle dipendenze.
    • Dipendenza della libreria SDK
    • Dipendenze di base e dell'interfaccia utente utilizzate dalla libreria SDK per il corretto funzionamento delle funzioni della libreria.
       // 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'