1. Avant de commencer
Ce que vous allez faire
Dans cet atelier de programmation, vous allez étendre un exemple d'application Android Home existant en utilisant la base de connaissances de l'API Home et Gemini dans Android Studio pour automatiser la création d'UI et l'intégration d'API. Vous allez ajouter une interface de débogage qui permet aux utilisateurs de vider les journaux et de résumer leur maison pour le débogage et le développement.
Le duo gagnant : base de connaissances de l'API Home + Gemini dans Android Studio
Ce workflow repose sur deux composants essentiels :
- Base de connaissances de l'API Home : fichier de documentation organisé (
google-home-api-knowledge-base.txt) qui fournit à Gemini les contraintes techniques, les modèles et les méthodes spécifiques nécessaires pour interagir avec les appareils Google Home. - Consultez https://developers.home.google.com/apis/android/knowledge-base.
- Gemini dans Android Studio : un outil collaboratif optimisé par l'IA qui se trouve directement dans votre IDE. Il est sensible au contexte de votre code, de vos ressources et de votre terminal.
Points abordés
- Comment fournir la base de connaissances de l'API Home comme contexte à Gemini dans Android Studio.
- Découvrez comment faire du vibe coding avec Gemini dans Android Studio pour ajouter de nouvelles fonctionnalités à l'application exemple Home API existante.
2. Conditions préalables et configuration
Avant de continuer, assurez-vous d'avoir effectué les actions suivantes :
- Créez et exécutez l'application Android exemple des API Home : suivez les instructions sur https://developers.home.google.com/apis/android/sample-app/build#build_the_app pour créer et exécuter l'application exemple sur laquelle notre atelier de programmation est basé.
- Configuration de l'environnement
- Téléchargez Android Studio : installez la dernière version stable (Koala ou version ultérieure) sur le site officiel pour les développeurs.
- Activez Gemini : ouvrez la fenêtre d'outil Gemini (généralement sur la bande de droite). Connectez-vous avec votre compte Google et acceptez les conditions d'utilisation pour activer l'assistant IA. Pour obtenir des instructions, consultez https://developer.android.com/studio/gemini/get-started.
- Fichier de la base de connaissances : assurez-vous que le fichier
google-home-api-knowledge-base.txtest enregistré dans le répertoire de votre projet. - Remarque : Si vous avez cloné l'application exemple à partir de l'application exemple GitHub officielle, ce fichier est déjà inclus dans le dossier
tools/.
3. Créer le fichier AGENTS.md
Au lieu de répéter les instructions dans chaque discussion, créez un "cerveau" persistant pour Gemini.
Dans la racine de votre projet, créez un fichier nommé AGENTS.md et collez le contexte suivant :
**Role:** You are an expert Android Home API Developer.
**Context:** This project uses the Google Home APIs.
**Source of Truth:** Always reference tools/google-home-api-knowledge-base.txt for Home API patterns, data models (Structures, Automations), and debugging methods.
**Guidelines:** Prioritize Material 3 Compose components and ensure all code is compatible with the latest Home API SDK.
Dans "Contexte", cochez la case à côté de AGENTS.md Files.
Vérifions si la configuration a réussi. Posez une question à Gemini :
Can you see the Agents.md file? Do you know what file you need to check first before developing with Google Home API?
Un résultat semblable à celui ci-dessous devrait s'afficher, indiquant que le fichier AGENTS.md est en cours de lecture et que le fichier de la base de connaissances sera utilisé.
4. Créer un onglet "Déboguer"
Utilisez Gemini et la base de connaissances pour modifier HomeAppView.kt et ajouter une destination de navigation.
Avant de commencer, voici à quoi devrait ressembler votre application exemple Home APIs :
Demandez à Gemini d'utiliser une icône en forme de roue pour représenter le nouvel onglet de débogage.
Can you help to add a wheel icon as the third tab in the HomeAppView .
Vous trouverez ci-dessous un exemple de dialogue entre un utilisateur et Gemini dans Android Studio.
Un nouvel onglet "Debug" s'affiche en bas de l'écran :
5. Créez deux boutons pour "Dump Structure" et "Dump Automation".
Envoyer une requête à Gemini :
Create two selectable buttons on the Debug page called "Dump Structure" and "Dump Automations".
Deux nouveaux boutons ont été ajoutés à la page "Débogage".
6. Implémenter la fonctionnalité "Dump Structure"
Envoyer une requête à Gemini :
Implement the first button "Dump Structure" to call dumpStructure(structure: Structure) in Debugger.kt with current selected structure.
Lorsque vous cliquez sur le bouton "Dump Structure" (Vider la structure), les journaux de structure sont vidés dans LogCat.
7. Implémenter la fonctionnalité "Dump Automation"
Envoyer une requête à Gemini :
Now Implement the "Dump Automation" functionality to call dumpAutomationsInStructure(structure: Structure) in Debugger.kt with current selected structure.
Lorsque vous cliquez sur le bouton "Dump Automation" (Vider l'automatisation), les journaux d'automatisation sont vidés dans LogCat.
8. Implémenter un bouton "Résumer la maison" qui liste les pièces et les appareils actuels
Envoyer une requête à Gemini :
In Debug tab, add a button "Summarize Home" to find the current room and devices with Home API and show them on a dialog.
Nouveau bouton "Résumer la page d'accueil" sur la page de débogage
Lorsque vous cliquez dessus, un récapitulatif actuel des pièces et des appareils s'affiche.
9. Examiner les modifications
Gemini peut également vous aider à examiner les modifications (ou le dernier commit Git), à identifier les problèmes potentiels et à les résoudre.
Envoyer une requête à Gemini :
Review the uncommitted changes and find potential issues.
10. Félicitations !
Félicitations ! Vous avez réussi à étendre votre application exemple Android Home en utilisant la base de connaissances de l'API Home et Gemini pour automatiser la création d'UI et l'intégration d'API. Maintenant que vous savez comment étendre l'application exemple à l'aide du développement basé sur l'IA, voici d'autres choses que vous pouvez essayer :
- Affinez votre fichier AGENTS.md : essayez d'ajouter des normes de codage ou des consignes relatives à la marque spécifiques à votre fichier
AGENTS.mdpour voir comment cela modifie les suggestions de code de Gemini. - Créer une automatisation personnalisée : utilisez Gemini et la base de connaissances pour écrire un script qui déclenche une routine "Bonne nuit", par exemple en verrouillant toutes les portes et en baissant la lumière.
- Consultez le guide officiel de la base de connaissances de l'API Home et regardez Accélérer le développement avec Gemini et la base de connaissances.