פיתוח אפליקציה ל-Android Home API באמצעות מאגר הידע של Home API ו-Gemini

1. לפני שמתחילים

מה תפַתחו

בשיעור Codelab הזה נשתמש בבסיס הידע של Home API וב-Gemini ב-Android Studio כדי להרחיב אפליקציית דוגמה קיימת של Android Home API, להפוך את יצירת ממשק המשתמש לשלב אוטומטי ולשלב את ה-API. תוסיפו ממשק ניפוי באגים שיאפשר למשתמשים להעביר יומנים ולסכם את מסך הבית שלהם לצורך ניפוי באגים ופיתוח.

השילוב המנצח: מאגר הידע של Home API‏ + Gemini ב-Android Studio

תהליך העבודה הזה מסתמך על שני רכיבים קריטיים:

  • בסיס הידע של Home API: קובץ תיעוד (google-home-api-knowledge-base.txt) שנערך בקפידה ומספק ל-Gemini את האילוצים הטכניים הספציפיים, המודלים והשיטות שנדרשים כדי ליצור אינטראקציה עם מכשירי Google Home.
  • למידע נוסף: https://developers.home.google.com/apis/android/knowledge-base
  • ‫Gemini ב-Android Studio: שותף מבוסס-AI שמוטמע ישירות בסביבת הפיתוח המשולבת (IDE). הוא מודע להקשר של הקוד, המשאבים והטרמינל.

מה תלמדו

  • איך מספקים את בסיס הידע של Home API כהקשר ל-Gemini ב-Android Studio.
  • איך משתמשים ב-Gemini ב-Android Studio כדי להוסיף פונקציונליות חדשה לאפליקציית הדוגמה הקיימת של Home API.

2. דרישות מוקדמות והגדרה

לפני שממשיכים, צריך לוודא שהפעולות הבאות הושלמו:

  • איך יוצרים ומריצים אפליקציה לדוגמה של Home APIs ל-Android: פועלים לפי ההוראות שבכתובת https://developers.home.google.com/apis/android/sample-app/build#build_the_app כדי ליצור ולהריץ את האפליקציה לדוגמה שעליה מבוסס ה-codelab שלנו.
  • הגדרת הסביבה
  • הורדה של Android Studio: מתקינים את הגרסה היציבה האחרונה (Koala או גרסה חדשה יותר) מהאתר הרשמי למפתחים.
  • הפעלת Gemini: פותחים את חלון הכלים של Gemini (בדרך כלל ברצועה בצד שמאל). כדי להפעיל את העוזר הדיגיטלי מבוסס ה-AI, צריך להיכנס לחשבון Google ולאשר את התנאים. הוראות מפורטות זמינות בכתובת https://developer.android.com/studio/gemini/get-started.
  • קובץ בסיס הידע: מוודאים שהקובץ google-home-api-knowledge-base.txt נשמר בספריית הפרויקט.
  • הערה: אם שיבטתם את האפליקציה לדוגמה מאפליקציית הדוגמה הרשמית של GitHub, הקובץ הזה כבר כלול בתיקייה tools/.

3. יצירת הקובץ AGENTS.md

במקום לחזור על ההוראות בכל שיחה, אתם יכולים ליצור ל-Gemini "מוח" קבוע.

בשורש הפרויקט, יוצרים קובץ חדש בשם AGENTS.md ומדביקים בו את ההקשר הבא:

**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.

בקטע 'הקשר', מסמנים את התיבה לצד AGENTS.md Files.

2047b69244c9da6e.png

עכשיו נבדוק אם ההגדרה בוצעה בהצלחה. כותבים הנחיה ל-Gemini:

Can you see the Agents.md file? Do you know what file you need to check first before developing with Google Home API?

אמורה להופיע תוצאה דומה לזו שבהמשך, שבה מצוין שהקובץ AGENTS.md נקרא ושהקובץ של בסיס הידע ישמש אתכם.

830ef529169d47b.png

4. יצירת כרטיסיית ניפוי באגים חדשה

משתמשים ב-Gemini + Knowledge Base כדי לשנות את HomeAppView.kt ולהוסיף יעד ניווט חדש.

לפני שמתחילים, כך צריכה להיראות אפליקציית הדוגמה הנוכחית של Home APIs:

981f74eb250a2552.png

מבקשים מ-Gemini להשתמש בסמל של גלגל כדי לייצג את כרטיסיית הניפוי באגים החדשה.

Can you help to add a wheel icon as the third tab in the HomeAppView .

בהמשך מופיע דיאלוג פוטנציאלי של הנחיה ותשובה עם Gemini ב-Android Studio

c9cf695cb6549fa3.png

עכשיו אפשר לראות כרטיסייה חדשה בשם 'ניפוי באגים' בתחתית המסך:

ac1e16cc6bcae224.png

5. תיצור 2 כפתורים חדשים בשם Dump Structure ו-Dump Automation

כתיבת הנחיה ל-Gemini:

Create two selectable buttons on the Debug page called "Dump Structure" and "Dump Automations".

עכשיו יש 2 לחצנים חדשים בדף Debug (ניפוי באגים)

451ad164998d527c.png

6. הטמעה של הפונקציונליות 'יצירת קובץ Dump של המבנה'

כתיבת הנחיה ל-Gemini:

Implement the first button "Dump Structure" to call dumpStructure(structure: Structure) in Debugger.kt with current selected structure.

כשלוחצים על הכפתור Dump Structure (הצגת מבנה), יומני המבנה יוצגו ב-LogCat

af7295a2ad999798.png

7. הטמעה של הפונקציה Dump Automation (יצירת קובץ dump אוטומטית)

כתיבת הנחיה ל-Gemini:

Now Implement the "Dump Automation" functionality to call dumpAutomationsInStructure(structure: Structure) in Debugger.kt with current selected structure.

כשלוחצים על הלחצן Dump Automation (הצגת נתוני אוטומציה), נתוני האוטומציה מוצגים ב-LogCat

d5ea7f17e29d9220.png

8. הטמעה של לחצן 'סיכום הבית' שמציג רשימה של החדרים והמכשירים הנוכחיים

כתיבת הנחיה ל-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.

לחצן חדש 'סיכום של מסך הבית' בדף הניפוי באגים

a4cf16a09f535f8b.png

כשלוחצים עליו, מוצג סיכום עדכני של החדרים והמכשירים

cd2dcccc60947445.png

9. בדיקת השינויים

‫Gemini יכול גם לעזור לבדוק את השינויים (או את ה-commit האחרון ב-git), למצוא את הבעיות הפוטנציאליות ולתקן אותן.

כתיבת הנחיה ל-Gemini:

Review the uncommitted changes and find potential issues.

816ea8380bffc14f.png

10. מעולה!

מעולה! הצלחת להרחיב את אפליקציית הדוגמה של Android Home API באמצעות מאגר הידע של Home API ו-Gemini כדי לבצע אוטומציה של יצירת ממשק משתמש ושילוב API! אחרי שהבנתם איך להרחיב את אפליקציית הדוגמה באמצעות פיתוח מבוסס-AI, הנה עוד כמה דברים שאפשר לנסות:

  • שיפור קובץ ה-AGENTS.md: נסו להוסיף לקובץ AGENTS.md תקנים ספציפיים של קידוד או ספר מותג כדי לראות איך זה משנה את הצעות הקוד של Gemini.
  • יצירת אוטומציה בהתאמה אישית: אפשר להשתמש ב-Gemini ובמאגר הידע כדי לכתוב סקריפט שמפעיל את שגרת 'לילה טוב', כמו נעילת כל הדלתות והנמכת האורות.
  • מומלץ לקרוא את המדריך הרשמי למאגר הידע של Home API ולצפות בסרטון Accelerate Development with Gemini & the Knowledge Base (פיתוח מהיר באמצעות Gemini ומאגר הידע).