Télécharger et configurer un projet Android avec Back4App

19 min

téléchargez un projet android avec le code source et commencez à utiliser back4app introduction dans ce guide, vous apprendrez comment commencer avec une application android écrite en java ou kotlin et la connecter à back4app si vous souhaitez un guide quickstart détaillé ou connecter back4app à un projet existant, rendez vous sur notre tutoriel d'installation du sdk parse https //www back4app com/docs/android/parse android sdk objectif téléchargez un modèle android et connectez le à back4app prérequis version 4 1 ou plus récente d'android studio https //developer android com/studio/index html une application créée sur back4app suivez le tutoriel de nouvelle application parse https //www back4app com/docs/get started/new parse app pour apprendre à créer une application parse sur back4app 1 téléchargez le modèle il existe 2 modèles android, l'un écrit en java et l'autre en kotlin dépôt d'exemple kotlin https //github com/templates back4app/android kotlin starter template dépôt d'exemple java https //github com/templates back4app/android java starter template choisissez le modèle qui vous convient, et procédez au téléchargement ou à l'importation de votre projet sur android studio android studio 1 1 télécharger directement depuis github utilisez les commandes suivantes pour télécharger et décompresser votre modèle de projet macos et linux $ curl lok https //github com/templates back4app/android java starter template/archive/master zip && unzip master zip$ curl lok https //github com/templates back4app/android kotlin starter template/archive/master zip && unzip master zip windows 1 2 ouvrir le projet sur android studio après avoir téléchargé les fichiers, décompressez les ouvrons android studio dans l'écran d'accueil d'android studio, choisissez ‘ouvrir un projet existant’ et sélectionnez le dossier du projet choisissez l'emplacement de votre dossier téléchargé et décompressé et ouvrez le veuillez attendre la fin du processus d'exécution de gradle vous pouvez maintenant voir les onglets de la console gradle en bas dans android studio 1 3 importer depuis github (chemin optionnel) vous pouvez importer le lien du dépôt directement dans android studio sur l'écran d'accueil d'android studio, choisissez ‘obtenir depuis le contrôle de version’ android studio vous demandera le lien du dépôt git et le chemin de projet souhaité vous pouvez trouver les liens des dépôts au début de cette section vous pouvez trouver les liens des dépôts au début de cette section après avoir rempli les champs url et répertoire, cliquez sur le clone bouton ensuite, android studio copiera et ouvrira le projet pour vous veuillez attendre la fin du processus d'exécution de gradle vous pouvez maintenant voir les onglets de la console gradle en bas dans android studio android studio copiera et ouvrira le projet pour vous veuillez patienter jusqu'à ce que l'exécution de gradle soit terminée vous pouvez voir les onglets de la console gradle en bas dans android studio 2 obtenez vos clés d'application dans ce guide, nous utiliserons les fichiers suivants dans le projet \androidmanifest xml\ nous allons définir nos identifiants back4app comme \\<meta data\>\ et les autorisations de l'application \app java\ ( \app kt\ pour kotlin) nous allons modifier notre code d'initialisation ici \mainactivity java\ ( \mainactivity kt\ pour kotlin) contiendra notre tout premier code pour créer un objet parse \strings xml\ nous allons stocker et lire les identifiants de configuration back4app ici \build gradle\ nous allons définir notre version du sdk android parse ici pour connecter votre projet d'application au serveur de back4app, vous aurez besoin de trois informations principales l'url du serveur, l'id de l'application et la clé client dans un projet android, strings xml est un endroit parfait pour définir ces informations c'est là que le sdk android parse lit les valeurs de clé d'application pour établir une connexion avec votre application back4app l'url du serveur est déjà dans le projet vous devez maintenant aller sur back4app, copier vos clés d'application et mettre à jour votre strings xml avec ces valeurs ouvrez votre fichier strings \ /app/src/main/res/values/strings xml\ 2\ allez sur votre tableau de bord d'application à back4app website https //www back4app com/ 3\ trouvez vos clés sur \paramètres de l'application\ > \sécurité et clés\ 4\ retournez à votre \strings xml\ fichier et collez votre \applicationid \ et \clientkey\ 1 \<resources> 2 \<string name="app name">back4appexample\</string> 3 \<string name="back4app server url" translatable="false">https //parseapi back4app com/\</string> 4 5 \<! paste both keys here > 6 \<string name="back4app app id" translatable="false">paste your application id here\</string> 7 \<string name="back4app client key" translatable="false">paste your client key here\</string> 8 \</resources> 5\ ouvrez votre fichier build gradle (module\ back4appexample app) dans les scripts gradle depuis l'explorateur de projet dans la section \dependencies \ changez la valeur de parse sdk android avec la version de votre choix implementation "com github parse community parse sdk android\ parse\ latest version here" après avoir enregistré \build gradle\ exécutez ‘sync now’ vous pouvez voir la version actuelle du sdk ici versions du sdk https //jitpack io/#parse community/parse sdk android 3 connectez vous à back4app après avoir configuré vos identifiants d'application, vous êtes prêt à vous connecter à votre instance de parse server sur back4app voici le code d'initialisation que vous allez utiliser vous pouvez trouver le code d'initialisation dans le projet dans \app java\ ( \app kt\ pour kotlin) nous utilisons \app java\ pour notre initialisation car nous devons établir la connexion avant que l'application n'effectue toute autre action \app java\ est le premier contexte à être créé avant toute autre activité et service et le dernier à être détruit le code d'initialisation ci dessous obtient les clés d'application de \strings xml\ et essaie d'établir une connexion avec notre serveur back4app nous plaçons notre code dans la méthode oncreate() car nous voulons nous connecter à notre serveur d'abord avant de prendre toute autre action app java 1 public class app extends application { 2 @override 3 public void oncreate() { 4 super oncreate(); 5 parse initialize(new parse configuration builder(this) 6 applicationid(getstring(r string back4app app id)) 7 clientkey(getstring(r string back4app client key)) 8 server(getstring(r string back4app server url)) 9 build()); 10 } 11 } app kt 1 class app application() { 2 override fun oncreate() { 3 super oncreate() 4 parse initialize( 5 parse configuration builder(this) 6 applicationid(getstring(r string back4app app id)) 7 clientkey(getstring(r string back4app client key)) 8 server(getstring(r string back4app server url)) 9 build()); 10 } 11 } il est maintenant temps d'ajouter quelques codes pour interagir avec le serveur ouvrons notre fichier mainactivity les fichiers d'activité sont excellents pour interagir avec l'utilisateur leur but principal est de fournir une interface utilisateur vous pouvez choisir quelle activité afficher au lancement dans \androidmanifest xml\ 1 \<activity android\ name=" mainactivity"> 2 \<intent filter> 3 \<action android\ name="android intent action main" /> 4 \<category android\ name="android intent category launcher" /> 5 \</intent filter> 6 \</activity> dans notre projet, mainactivity est configuré pour s'ouvrir au lancement dans cet exemple de code, nous avons un code sdk parse pour enregistrer un objet parse sur le serveur et afficher l'objectid de l'objet parse enregistré à l'utilisateur avec un textview mainactivity java 1 public class mainactivity extends appcompatactivity { 2 @override 3 protected void oncreate(bundle savedinstancestate) { 4 super oncreate(savedinstancestate); 5 setcontentview(r layout activity main); 6 textview textview = findviewbyid(r id textview); 7 parseobject firstobject = new parseobject("firstclass"); 8 firstobject put("message","hey ! first message from android parse is now connected"); 9 firstobject saveinbackground(e > { 10 if (e != null){ 11 log e("mainactivity", e getlocalizedmessage()); 12 }else{ 13 log d("mainactivity","object saved "); 14 textview\ settext(string format("object saved %s", firstobject getobjectid())); 15 } 16 }); 17 } 18 } mainactivity kt 1 class mainactivity appcompatactivity() { 2 override fun oncreate(savedinstancestate bundle?) { 3 super oncreate(savedinstancestate) 4 setcontentview(r layout activity main) 5 val textview = findviewbyid\<textview>(r id textview) 6 val firstobject = parseobject("firstclass") 7 firstobject put("message","hey ! first message from android parse is now connected") 8 firstobject saveinbackground { 9 if (it != null){ 10 it localizedmessage? let { message > log e("mainactivity", message) } 11 }else{ 12 log d("mainactivity","object saved ") 13 textview\ text = string format("object saved %s", firstobject objectid) 14 } 15 } 16 } 17 } 4 tester la connexion construisez votre application sur un appareil ou un appareil virtuel ( \shift\ + \f10\ ) si vous n'avez pas d'appareil virtuel pour exécuter l'application vous pouvez en créer un nouveau à partir du gestionnaire avd dans android studio attendez que l' \hello word! \ l'écran apparaisse après \hello word!\ vous verrez objet enregistré ce message inclura l'id de l'objet enregistré 2\ connectez vous à site web back4app https //www back4app com/ 3\ trouvez votre application et cliquez sur \tableau de bord \ > \base de données \ > \navigateur\ si tout fonctionne correctement, vous devriez trouver une classe nommée \firstclass \ comme suit c'est fait! vous pouvez voir l'objectid dans le tableau de bord et l'écran de votre application correspond ! à ce stade, vous avez appris comment commencer avec les applications android en savoir plus en parcourant nos tutoriels android https //www back4app com/docs/android/android project with source code download ou consultez la documentation open source de parse pour le sdk android http //docs parseplatform org/android/guide/