1. Développer et déployer des applications mobiles iOS pour tirer parti de vos services back-end
  2. Configurer Oracle Mobile Hub SDK avec l'application mobile

Configurer Oracle Mobile Hub SDK avec l'application mobile

Vous devez configurer le kit SDK Oracle Mobile Hub avec votre application mobile avant d'écrire du code.

Ajouter le kit SDK

Dans une configuration d'application de base, sans créer de cadre, vous ajouterez le SDK client iOS à une application.

  1. Décompressez le fichier de téléchargement, omce-ios-sdk-{n}.zip (où {n} est le numéro de version du kit SDK) dans un répertoire de votre ordinateur.

  2. Faites glisser le répertoire oracle_mobile_ios_sdk du contenu extrait du fichier ZIP vers le navigateur de projet Xcode.

    • Sélectionnez Copier les éléments si nécessaire.

    • Sélectionnez Créer des groupes.

    • Cliquez sur Terminer.

    Une fois que le fichier.a d'une bibliothèque spécifique a été copié dans l'arborescence de développement de votre application dans Xcode, l'API de plate-forme correspondante est disponible pour votre application via des appels SDK. A ce stade, toutes les bibliothèques statiques du kit SDK sont disponibles pour votre application.

  3. Sélectionnez la cible du projet, sélectionnez l'onglet Phases de construction, développez Lier le fichier binaire aux bibliothèques, cliquez sur le bouton + et ajoutez les bibliothèques suivantes :

    • CoreData.framework

    • CoreLocation.framework

    • libsqlite3.0.tbd

    • Security.framework

    • SystemConfiguration.framework

  4. Dans la section Paramètres de construction du projet, cliquez deux fois sur Autres indicateurs d'éditeur de liens (sous Liaison ) et ajoutez -ObjC.

  5. Egalement dans Paramètres de construction, développez Chemins de recherche et :

    1. Ajoutez oracle_mobile_ios_sdk/release-iphoneos aux chemins de recherche de bibliothèque.

    2. Ajoutez oracle_mobile_ios_sdk/release-iphoneos/include aux chemins de recherche d'en-tête utilisateur.

  6. Développez le dossier Documentation du fichier ZIP décompressé, copiez le fichier OMC.plist et placez-le dans la racine du package d'applications principal de votre application.

  7. Modifiez le fichier OMC.plist de style.

  8. A partir de Xcode 7, vous devez prendre en compte la stratégie Application Transport Security (ATS), ce qui impose des communications distantes sur HTTPS.

    A des fins de développement uniquement, ajoutez la clé suivante dans le fichier Info.plist de l'application pour désactiver la stratégie ATS pour l'application. 

    <key>NSAppTransportSecurity</key> 
<dict>
 <key>NSAllowsArbitraryLoads</key>
 <true/> 
</dict>

    Remarque :

    Vous ne devez pas utiliser ce paramètre dans la production. Pour vous assurer que vous disposez d'une sécurité optimale pour votre application, examinez la documentation d'Apple et suivez les recommandations d'Apple pour désactiver ATS pour des domaines spécifiques et appliquer les réductions de sécurité appropriées pour ces domaines.

Configurer les propriétés SDK

Pour utiliser le SDK client dans une application iOS, vous devez ajouter le fichier de configuration OMC.plist à l'application et le remplir avec les détails d'environnement de votre back-end dans Oracle Mobile Hub, ainsi que d'autres informations de configuration. A leur tour, les classes SDK utilisent ces informations pour gérer les autorisations, la journalisation, le suivi des événements, la synchronisation des données et d'autres fonctionnalités.

Vous packagez le fichier de configuration à la racine du package principal de votre application.

Le fichier est essentiellement divisé en plusieurs parties :

  • La clé mobileBackend et son contenu.

    Vous incluez cette partie si vous utilisez un back-end avec l'application. Les classes SDK utilisent les détails d'environnement et d'authentification que vous indiquez pour accéder au back-end et construire des en-têtes HTTP pour les appels REST effectués vers des API.

  • Clés s'appliquant à la configuration dans son ensemble, telles que logLevel et oAuthTokenEndpoint. Ces clés apparaissent généralement mais pas dans la partie supérieure du fichier.

Le même fichier dans le formulaire de texte est le suivant :

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"
<plist version="1.0">
<dict>
  <key>logLevel</key>
  <string>debug</string>
  <key>logHTTP</key>
  <true/>
  <key>oAuthTokenEndPoint</key>
  <string>https://MY_TOKEN_ENDPOINT</string>
  <key>mobileBackend</key>
  <dict>
    <key>name</key>
    <string>EasyShoppingMBE</string>
    <key>baseURL</key>
    <string>https://MY_CLOUD_DOMAIN.oracle.com</string>
    <key>authentication</key>
    <dict>
      <key>type</key>
      <string>oauth</string>
      <key>oauth</key>
      <dict>
        <key>clientID</key>
        <string>11dac238ffaa4b029e78e982114642ab</string>
        <key>clientSecret</key>
        <string>5624cbdd-a7c5-4c10-a758-6019a5ab8da8</string>
        <key>enableOffline</key>
        <true/>
      </dict>
    </dict>
  </dict>
</dict>
</plist>

Voici une description des entrées les plus importantes dans le fichier OMC.plist.

  • oAuthTokenEndPoint : URL du serveur OAuth à partir duquel l'application obtient son jeton d'authentification. Cette clé doit être fournie pour toutes les applications reposant sur OAuth pour l'authentification. Pour ce faire, accédez à la page Paramètres du back-end. L'adresse doit uniquement être l'URL de base (au format https ://host.domain:port).

  • logLevel : détermine la quantité de journalisation SDK affichée dans la console de l'application. La valeur par défaut est error. Les autres valeurs possibles (en augmentant le niveau de détail) sont warning, info et debug. Il est également possible de définir la valeur sur none.

  • logHTTP : lorsque cette option est définie sur true, le kit SDK journalise les en-têtes et les corps de toutes les demandes et réponses HTTP.

  • mobileBackend : entrée de dictionnaire contenant les détails d'authentification de votre back-end et d'autres détails facultatifs, tels que les propriétés de synchronisation.

    Vous obtenez les détails d'authentification, tels que les informations d'identification et de connexion OAuth et HTTP, à partir de la page Paramètres du back-end.

  • mobileBackend/baseUrl — URL de base pour toutes les API que vous appelez via le back-end. Pour ce faire, accédez à la page Paramètres du back-end.

  • mobileBackend/authentication : contient un dictionnaire avec les éléments suivants :

    • Sous-clé type, avec les valeurs possibles (string) d'oauth, basic, facebook et tokenExchange.

    • Sous-clés des types d'authentification, contenant un dictionnaire avec les informations d'identification et de connexion d'authentification.

      Dans les sous-clés de basic et oauth, vous pouvez également ajouter la clé enableOffline. Par défaut, cette propriété est définie sur true.