Quickstarters

Comment construire un backend pour Kotlin ?

39min

Introduction

Dans ce tutoriel, vous apprendrez à construire un backend complet pour une application Android (écrite en Kotlin) en utilisant Back4App.

Nous allons passer en revue l'intégration des fonctionnalités essentielles de Back4App—y compris la gestion de base de données, les fonctions Cloud Code, les API REST et GraphQL, l'authentification des utilisateurs et les requêtes en temps réel (Live Queries)—pour créer un backend sécurisé, évolutif et robuste qui communique sans effort avec votre application Android.

Vous verrez également comment la configuration rapide et l'environnement intuitif de Back4App peuvent réduire considérablement le temps et les efforts par rapport à la configuration manuelle des serveurs et des bases de données.

En cours de route, vous acquerrez une expérience pratique avec des fonctionnalités clés, y compris des fonctionnalités de sécurité avancées, la planification de tâches avec Cloud Jobs et la configuration de webhooks pour des intégrations externes.

À la fin de ce tutoriel, vous serez bien préparé à améliorer cette configuration de base en une application prête pour la production, ou à incorporer facilement une logique personnalisée et des API tierces selon vos besoins.

Prérequis

Pour compléter ce tutoriel, vous aurez besoin de :

  • Un compte Back4app et un nouveau projet Back4app Commencer avec Back4app. Si vous n'avez pas de compte, vous pouvez en créer un gratuitement. Suivez le guide ci-dessus pour préparer votre projet.
  • Environnement de développement Android/Kotlin de base Assurez-vous d'avoir Android Studio installé sur votre machine. Vous pouvez suivre la documentation officielle de configuration d'Android Studio si vous ne l'avez pas encore configuré.
  • Un minimum d'Android 4.0 ou supérieur dans la configuration Gradle de votre application Typiquement, vous définirez cela dans votre minSdkVersion dans le build.gradle de votre module.
  • Familiarité avec Kotlin et les concepts de base d'Android Documentation pour développeurs Android. Si vous êtes nouveau dans Android ou Kotlin, consultez la documentation officielle ou un tutoriel pour débutants avant de commencer.

Assurez-vous d'avoir tous ces prérequis en place avant de commencer. Avoir votre projet Back4app configuré et votre environnement Android local prêt vous aidera à suivre plus facilement.

Étape 1 – Configuration du projet Back4app

Créer un nouveau projet

La première étape pour construire votre backend Android sur Back4app consiste à créer un nouveau projet. Si vous ne l'avez pas encore fait, suivez ces étapes :

  1. Connectez-vous à votre compte Back4app.
  2. Cliquez sur le bouton “Nouvelle application” dans votre tableau de bord Back4app.
  3. Donnez un nom à votre application (par exemple, “Android-Kotlin-Backend-Tutorial”).
Document image


Une fois le projet créé, vous le verrez listé dans votre tableau de bord Back4app. Ce projet sera la base de toutes les configurations backend discutées dans ce tutoriel.

Connecter le SDK Parse

Back4App s'appuie sur la plateforme Parse pour gérer vos données, fournir des fonctionnalités en temps réel, gérer l'authentification des utilisateurs, et plus encore. L'intégration de votre application Android avec Back4App implique d'ajouter les dépendances du SDK Android Parse à vos fichiers Gradle et de les initialiser avec les identifiants de votre tableau de bord Back4App.

Récupérez vos clés Parse: Dans votre tableau de bord Back4App, accédez à la section “Paramètres de l'application” ou “Sécurité & Clés” de votre application pour trouver votre ID d'application et Clé client. Vous trouverez également l' URL du serveur Parse (souvent au format https://parseapi.back4app.com).

Document image


Ajoutez le SDK Parse à vos build.gradle fichiers:

Dans votre build.gradle racine (niveau projet):

Text


Dans votre build.gradle au niveau du module (généralement app/build.gradle):

Text


Initialiser Parse dans votre application Android:

Créer une Application personnalisée (par exemple, App.kt) si vous n'en avez pas déjà une :

Kotlin


Ensuite, ouvrez votre AndroidManifest.xml et enregistrez la Application personnalisée :

XML


En complétant cette étape, vous avez établi une connexion sécurisée entre votre interface Android (Kotlin) et le backend Back4App. Toutes les demandes et transactions de données sont acheminées de manière sécurisée via ce SDK, réduisant la complexité des appels REST ou GraphQL manuels (bien que vous puissiez toujours les utiliser si nécessaire).

Étape 2 – Configuration de la base de données

Sauvegarde et requête de données

Avec votre projet Back4App configuré et le SDK Parse intégré dans votre application Android, vous pouvez maintenant commencer à enregistrer et à récupérer des données. Ci-dessous un exemple utilisant Kotlin pour créer et récupérer des données.

Kotlin


Alternativement, vous pouvez utiliser les points de terminaison de l'API REST de Back4App :

Bash


Back4app fournit également une interface GraphQL :

GraphQL


Ces options diverses vous permettent d'intégrer les opérations de données de la manière qui convient le mieux à votre processus de développement, que ce soit via le SDK Parse, REST ou GraphQL.

Conception de schéma et types de données

Par défaut, Parse permet la création de schémas à la volée, mais vous pouvez également définir vos classes et types de données dans le tableau de bord Back4app pour plus de contrôle.

  1. Accédez à la section “Base de données” dans votre tableau de bord Back4app.
  2. Créez une nouvelle classe (par exemple, “Todo”) et ajoutez des colonnes pertinentes, telles que titre (String) et isCompleted (Boolean).
Créer une nouvelle classe
Créer une nouvelle classe


Back4app propose un agent IA qui peut vous aider à concevoir votre modèle de données :

  1. Ouvrez l'agent IA depuis votre tableau de bord d'application ou dans le menu.
  2. Décrivez votre modèle de données dans un langage simple (par exemple, “Veuillez créer une nouvelle application ToDo sur back4app avec un schéma de classe complet.”).
  3. Laissez l'agent IA créer le schéma pour vous.
Document image


Utiliser l'agent IA peut vous faire gagner du temps lors de la configuration de votre architecture de données et garantir la cohérence de votre application.

Données relationnelles

Si vous avez des données relationnelles—disons, un Category objet qui pointe vers plusieurs Todo éléments—vous pouvez utiliser Pointers ou Relations dans Parse. Par exemple, ajouter un pointeur à un Category:

Kotlin


Lorsque vous interrogez, vous pouvez également inclure des données de pointeur :

Kotlin


Cet include("category") appel récupère les détails de la catégorie avec chaque Todo, rendant vos données relationnelles facilement accessibles.

Requêtes en direct

Pour des mises à jour en temps réel, Back4app fournit des Live Queries. Vous pouvez vous abonner aux changements dans une classe spécifique depuis votre application Android :

  1. Activer les Requêtes en direct dans votre tableau de bord Back4App sous les Paramètres du serveur de votre application.
  2. Initialiser une souscription de Requête en direct dans votre code :
Kotlin


Chaque fois qu'un nouveau Todo est créé, mis à jour ou supprimé, le client reçoit un rappel en temps réel—parfait pour les applications collaboratives ou dynamiques.

Étape 3 – Application de la sécurité avec les ACL et les CLP

Mécanisme de sécurité Back4app

Back4app prend la sécurité au sérieux en fournissant Des listes de contrôle d'accès (ACL) et Des autorisations au niveau de la classe (CLP). Ces fonctionnalités vous permettent de restreindre qui peut lire ou écrire des données sur une base par objet ou par classe, garantissant que seuls les utilisateurs autorisés peuvent modifier vos données.

Document image


Listes de contrôle d'accès (ACL)

Une ACL est appliquée à des objets individuels pour déterminer quels utilisateurs, rôles ou le public peuvent effectuer des opérations de lecture/écriture. Par exemple:

Kotlin


Permissions au niveau de la classe (CLPs)

Les CLPs régissent les permissions par défaut d'une classe entière, telles que si la classe est lisible ou écrivable publiquement.

  1. Allez sur votre tableau de bord Back4app, sélectionnez votre application et ouvrez la base de données section.
  2. Sélectionnez une classe (par exemple, “Todo”).
  3. Ouvrez l'onglet des permissions au niveau de la classe
  4. Configurez vos paramètres par défaut, tels que “Nécessite une authentification” pour la lecture ou l'écriture, ou “Aucun accès” pour le public.
Document image


Étape 4 – Écriture de fonctions Cloud Code

Le Cloud Code vous permet d'exécuter du code JavaScript personnalisé similaire à Kotlin sur Parse Server (téléchargé en tant que .js fichiers), sans avoir besoin de gérer l'infrastructure du serveur. Cela est idéal pour la logique métier, les validations, les déclencheurs et les appels d'API externes.

Comment ça fonctionne

Vous placez généralement les fonctions JavaScript, les déclencheurs et tous les modules npm requis dans un main.js fichier. Ce fichier est déployé dans votre projet Back4App et s'exécute dans l'environnement Parse Server.

Cas d'utilisation typiques

  • Logique métier
  • Validations de données
  • Déclencheurs (comme beforeSave, afterSave)
  • Application de la sécurité
  • Intégrations avec des API tierces

Déployez votre fonction

Voici une fonction Cloud Code simple :

main.js


Déploiement via le Back4App CLI:

Bash


Configurez et déployez:

Bash


Appeler votre fonction

Depuis votre code Android (Kotlin) via le SDK Parse :

Kotlin


Vous pouvez également l'appeler via REST ou GraphQL de manière similaire.

Étape 5 – Configuration de l'authentification

Authentification des utilisateurs dans Back4App

Back4App utilise la classe Parse User pour l'authentification. Parse gère le hachage sécurisé des mots de passe, les jetons de session, et plus encore par défaut.

Configuration de l'authentification des utilisateurs

En Kotlin, vous pouvez créer un nouvel utilisateur :

Kotlin


Connectez un utilisateur existant :

Kotlin


Les connexions sociales telles que Google, Facebook et Apple peuvent également être intégrées. Consultez les Docs de connexion sociale pour plus de détails.

Gestion des sessions

Parse gère automatiquement les jetons de session. Vous pouvez accéder à l'utilisateur actuel :

Kotlin


Et se déconnecter :

Kotlin


Étape 6 – Gestion du stockage de fichiers

Téléchargement et récupération de fichiers

Parse inclut la ParseFile classe pour gérer les téléchargements de fichiers :

Kotlin


Sécurité des fichiers

Vous pouvez contrôler qui peut télécharger ou télécharger des fichiers en ajustant les ACL et les CLP ou en utilisant des paramètres spécifiques aux fichiers dans la configuration du serveur parse.

Étape 7 – Vérification par e-mail et réinitialisation du mot de passe

  1. Activer la vérification par e-mail dans les paramètres de votre tableau de bord Back4App.
  2. Configurer votre adresse d'expéditeur, vos modèles d'e-mail ou votre domaine personnalisé si vous le souhaitez.
  3. Utiliser ParseUser.requestPasswordResetInBackground(email, callback) pour déclencher un flux de réinitialisation de mot de passe dans votre application.

Étape 8 – Planification des tâches avec des travaux Cloud

Les travaux Cloud vous permettent d'automatiser des tâches routinières comme le nettoyage des données ou l'envoi de notifications périodiques.

JS


Planifiez le travail dans votre tableau de bord Back4App sous Paramètres du serveur > Travaux en arrière-plan.

Étape 9 – Intégration des Webhooks

Les Webhooks permettent à votre application Back4App d'envoyer des requêtes HTTP à un service externe chaque fois que certains événements se produisent.

  1. Ajouter un Webhook dans votre tableau de bord Back4App sous Plus > Webhooks.
  2. Configurer les déclencheurs (par exemple, après avoir enregistré un nouvel objet).
  3. Ajouter un point de terminaison URL (comme un webhook Slack ou Stripe).
Ajout d'un Webhook
Ajout d'un Webhook


Étape 10 – Explorer le panneau d'administration Back4App

L' Application d'administration Back4App est une interface web conviviale pour les utilisateurs non techniques afin de gérer les données.

  1. Activez-le sous Tableau de bord de l'application > Plus > Application d'administration.
  2. Créez votre premier utilisateur administrateur.
  3. Choisissez un sous-domaine pour accéder au panneau d'administration.
  4. Connectez-vous pour visualiser, modifier ou supprimer facilement des enregistrements de votre base de données.
Activer l'application d'administration
Activer l'application d'administration


Conclusion

En suivant ce tutoriel complet, vous avez :

  • Créé un backend sécurisé pour une application Android sur Back4App.
  • Configuré une base de données avec des schémas de classe, des types de données et des relations.
  • Intégré des requêtes en temps réel (Live Queries) pour des mises à jour de données immédiates.
  • Appliqué des mesures de sécurité en utilisant des ACL et des CLP pour protéger et gérer l'accès aux données.
  • Implémenté des fonctions Cloud Code pour exécuter une logique métier personnalisée côté serveur.
  • Mis en place une authentification utilisateur avec support pour la vérification par e-mail et la réinitialisation de mot de passe.
  • Géré les téléchargements de fichiers et la récupération, avec des contrôles de sécurité de fichiers optionnels.
  • Planifié des tâches Cloud pour des tâches d'arrière-plan automatisées.
  • Utilisé des Webhooks pour s'intégrer à des services externes.
  • Exploré le panneau d'administration Back4App pour la gestion des données.

Avec un front-end Android (Kotlin) solide et un backend Back4App robuste, vous êtes maintenant bien équipé pour développer des applications riches en fonctionnalités, évolutives et sécurisées. Continuez à explorer des fonctionnalités plus avancées, intégrez votre logique métier et exploitez la puissance de Back4App pour vous faire gagner d'innombrables heures dans l'administration des serveurs et des bases de données. Bon codage !

Prochaines étapes

  • Construire une application Android prête pour la production en étendant ce backend pour gérer des modèles de données plus complexes, des stratégies de mise en cache et des optimisations de performance.
  • Intégrer des fonctionnalités avancées telles que des flux d'authentification spécialisés, un contrôle d'accès basé sur les rôles ou des API externes (comme des passerelles de paiement).
  • Consulter la documentation officielle de Back4app pour des plongées plus profondes dans la sécurité avancée, le réglage des performances et l'analyse des journaux.
  • Explorer d'autres tutoriels sur les applications de chat en temps réel, les tableaux de bord IoT ou les services basés sur la localisation. Vous pouvez combiner les techniques apprises ici avec des API tierces pour créer des applications complexes et réelles.