Suivez votre progression
Accueil Trailhead
Accueil Trailhead

Premiers pas avec le développement Android natif

Objectifs de formation

Une fois cette unité terminée, vous pourrez :

  • Décrire deux des principales fonctionnalités du kit de développement Mobile SDK pour Android
  • Installer le kit de développement Mobile SDK pour Android
  • Créer une application Android et préciser les options de l'application
  • Importer et élaborer votre application dans Android Studio

Développement Android natif

Le kit de développement Mobile SDK pour Android vous propose des outils et des ressources pour élaborer des applications Salesforce sur la plate-forme mobile la plus populaire au monde. Dans ce module, vous découvrez deux fonctionnalités fondamentales du kit de développement natif Android :

  • Automation du flux d’authentification OAuth2, qui facilite l’intégration du processus dans votre application.
  • Accès à l'API REST Salesforce, avec des classes utilitaires simplifiant cet accès.

Commençons ! Nous considérons que vous avez compléter le projet Configuration de votre environnement de développement mobile SDK. Si vous n'avez suivi ce projet, assurez-vous que votre environnement de développement est correctement configuré. Lorsque vous êtes prêt(e), vous allez commencer par créer une simple application Android native. Après un rapide examen, vous aiguisez vos talents de développement Android en modifiant les interactions REST et l’interface utilisateur de l’application.

Création d'une application connectée

Important

Important

Le module Bases de Salesforce Mobile SDK, qui présente des instructions de création d'une application connectée, est un prérequis à ce module. Vous ne pouvez pas relever le défi de cette unité sans créer une application connectée.

Pour se connecter au service Salesforce, chaque appareil mobile nécessite une application connectée Salesforce. Une application connectée permet à votre application de communiquer avec Salesforce et d’accéder en toute sécurité aux API Salesforce.

Après avoir créé et enregistré votre application connectée, notez ses détails.
  • Copiez les valeurs URL de rappel et Clé consommateur. Ces valeurs sont utiles pour configurer l'authentification dans votre application.
  • Les applications Mobile SDK n’utilisent pas de secret de consommateur. Par conséquent, vous pouvez ignorer cette valeur.

Création d'un projet Android

Maintenant que vous avez configuré votre environnement de développement Android et créé une application connectée Salesforce, vous êtes prêt à créer votre première application forcedroid.

  1. Lorsque la commande vous y invite, modifiez le répertoire dans lequel vous voulez stocker le projet puis saisissez :
    forcedroid create
  2. À l’invite de forcedroid, saisissez les valeurs suivantes :
    • Type d’application : natif
    • Nom de l’application : MyTrailNative
    • Nom du package : com.mytrail.android
    • Nom de l’organisation : MyApps, Inc.
    • Répertoire de sortie : TrailAndroidApps

Après une séquence de messages de journal, un message de félicitations apparaît et vous retournerez à l'invite de commande. Félicitations ! Votre nouvelle application peut maintenant être exécutée.

Exécution de votre nouvelle application Android

Le projet créé par forcedroid est prêt et peut être exécuté immédiatement. Il contient peu de fonctionnalités, il se contente d’exécuter une simple requête SOQL et d’afficher un tableau de noms. Au moins, vous savez que les fondations sont posées et qu'il est prêt pour votre offre. Examinons-le en action !

Lorsqu’il crée une application native, forcedroid substitue les valeurs génériques d’ID de consommateur et d’URI de rappel. Chaque application a besoin de ces valeurs pour se connecter au serveur et aux données Salesforce. Avant de publier une application, pensez à remplacer les paramètres génériques par les valeurs de votre propre application connectée. Nous allons le faire maintenant pour mémoriser le processus.

  1. Depuis le répertoire de votre projet, ouvrez app\res\values\bootconfig.xml dans un éditeur de texte compatible UTF-8. (Astuce Windows : l’encodage ANSI par défaut de notepad.exe ne va pas fonctionner. Vous pouvez toutefois utiliser la boîte de dialogue Enregistrer sous du bloc-notes pour sélectionner l’encodage UTF-8).
  2. Remplacez la valeur remoteAccessConsumerKey par la clé consommateur de votre application connectée.
  3. Remplacez la valeur oauthRedirectURI par l’URL de rappel de votre application connectée.
  4. Enregistrez le fichier sous l’encodage UTF-8.
Vous l’avez fait ! Vous avez réussi à créer et à personnaliser une application native Android qui utilise le kit de développement Mobile SDK. Nous pouvons maintenant élaborer et exécuter avec Android Studio.
  1. Lancez Android Studio.
  2. Sur l'écran de bienvenue, sélectionnez Importer le projet (ADT pour Eclipse, Gradle, etc.). Alternativement, si Android Studio est en cours d’exécution, sélectionnez Fichier | Nouveau | Importer le projet.
  3. Accédez à votre répertoire cible, TrailAndroidApps, puis cliquez sur OK.

    Android Studio élabore automatiquement votre espace de travail. Ce processus peut prendre quelques minutes. Lorsque la barre de statut indique « Gradle build successful », vous pouvez exécuter le projet.

  4. Cliquez sur Exécuter | Exécuter l’application, ou appuyez sur MAJ+F10 (Windows) ou ^R (Mac).
  5. Sélectionnez un émulateur ou un appareil connecté qui exécute l’API Android SDK 23 ou une version supérieure (jusqu’à Android 10 (API 29)).

    Android Studio lance votre application dans l'émulateur ou sur votre appareil Android connecté.