Home API Bilgi Bankası ve Gemini aracılığıyla Android Home API uygulaması geliştirme

1. Başlamadan önce

Ne oluşturacaksınız?

Bu codelab'de, kullanıcı arayüzü oluşturma ve API entegrasyonunu otomatikleştirmek için Home API Bilgi Bankası ve Android Studio'da Gemini'ı kullanarak mevcut bir Android Home API örnek uygulamasını genişleteceksiniz. Kullanıcıların hata ayıklama ve geliştirme için günlükleri döküm etmesine ve Evlerini özetlemesine olanak tanıyan bir hata ayıklama arayüzü ekleyeceksiniz.

Güçlü İkili: Home API Bilgi Bankası + Android Studio'da Gemini

Bu iş akışı iki kritik bileşene dayanır:

  • Home API Bilgi Bankası: Gemini'a Google Home cihazlarıyla etkileşim kurmak için gereken belirli teknik kısıtlamaları, modelleri ve yöntemleri sağlayan, derlenmiş bir doküman dosyasıdır (google-home-api-knowledge-base.txt).
  • Şu sayfaya bakın: https://developers.home.google.com/apis/android/knowledge-base
  • Android Studio'da Gemini: Doğrudan IDE'nizde bulunan yapay zeka destekli bir yardımcıdır. Kodunuz, kaynaklarınız ve terminaliniz hakkında bağlama duyarlıdır.

Neler öğreneceksiniz?

  • Android Studio'da Gemini'a bağlam olarak Home API Bilgi Bankası'nı sağlama
  • Mevcut Home API Örnek Uygulaması'na yeni işlevler eklemek için Android Studio'da Gemini ile nasıl vibe-code oluşturulur?

2. Ön koşullar ve kurulum

Devam etmeden önce aşağıdakilerin tamamlandığından emin olun:

  • Build and Run Home APIs Android Sample APP: https://developers.home.google.com/apis/android/sample-app/build#build_the_app adresindeki talimatları uygulayarak codelab'imizin temelini oluşturan örnek uygulamayı oluşturun ve çalıştırın.
  • Ortam Kurulumu
  • Android Studio'yu indirin: Resmi geliştirici sitesinden en yeni kararlı sürümü (Koala veya daha yeni) yükleyin.
  • Gemini'ı etkinleştirin: Gemini araç penceresini (genellikle sağ taraftaki şeritte) açın. Google Hesabınızla oturum açıp şartları kabul ederek yapay zeka asistanını etkinleştirin. Talimatlar için https://developer.android.com/studio/gemini/get-started adresini ziyaret edin.
  • Bilgi Bankası Dosyası: google-home-api-knowledge-base.txt dosyasının proje dizininize kaydedildiğinden emin olun.
  • Not: Örnek uygulamayı resmi GitHub örnek uygulamasından klonladıysanız bu dosya tools/ klasörüne zaten dahil edilmiştir.

3. AGENTS.md dosyasını oluşturma

Talimatları her sohbette tekrarlamak yerine Gemini için kalıcı bir "beyin" oluşturun.

Projenizin kök dizininde AGENTS.md adlı yeni bir dosya oluşturun ve aşağıdaki bağlamı yapıştırın:

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

"Bağlam" bölümünde AGENTS.md Files simgesinin yanındaki kutuyu işaretleyin.

2047b69244c9da6e.png

Kurulumun başarılı olup olmadığını doğrulayalım. Gemini'a şu istemi girin:

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

Aşağıdakine benzer bir sonuç görürsünüz. Bu sonuçta, AGENTS.md dosyasının okunduğu ve Bilgi Bankası dosyasının kullanılacağı belirtilir.

830ef529169d47b.png

4. Yeni bir hata ayıklama sekmesi oluşturma

HomeAppView.kt dosyasını değiştirmek ve yeni bir gezinme hedefi eklemek için Gemini + Knowledge Base'i kullanın.

Başlamadan önce, mevcut Home API'leri örnek uygulamanızın nasıl görünmesi gerektiğini aşağıda görebilirsiniz:

981f74eb250a2552.png

Yeni hata ayıklama sekmesini temsil etmek için Gemini'dan tekerlek simgesi kullanmasını isteyin.

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

Android Studio'da Gemini ile olası bir istem-yanıt diyaloğu için aşağıya bakın.

c9cf695cb6549fa3.png

Artık en altta yeni bir "Hata ayıklama" sekmesi görebilirsiniz:

ac1e16cc6bcae224.png

5. "Dump Structure" (Yapıyı Dök) ve "Dump Automation" (Otomasyonu Dök) için 2 yeni düğme oluşturun.

Gemini'a istem girme:

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

Hata ayıklama sayfasına 2 yeni düğme eklendi.

451ad164998d527c.png

6. "Dump Structure" işlevini uygulama

Gemini'a istem girme:

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

"Dump Structure" (Yapıyı Dök) düğmesi tıklandığında yapı günlükleri LogCat'e dökülür.

af7295a2ad999798.png

7. "Dump Automation" işlevini uygulama

Gemini'a istem girme:

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

"Dump Automation" (Otomasyonu Dök) düğmesi tıklandığında otomasyon günlükleri LogCat'e dökülür.

d5ea7f17e29d9220.png

8. Mevcut odaları ve cihazları listeleyen bir "Evi özetle" düğmesi uygulayın.

Gemini'a istem girme:

In Debug tab, add a button "Summarize Home" to find the current room and devices with Home API and show them on a dialog.

Hata ayıklama sayfasında yeni bir "Ana Sayfayı Özetle" düğmesi

a4cf16a09f535f8b.png

Bu simgeyi tıkladığınızda odaların ve cihazların mevcut durumuyla ilgili bir özet gösterilir.

cd2dcccc60947445.png

9. Değişiklikleri İnceleme

Gemini, değişiklikleri (veya son Git commit'ini) incelemenize, olası sorunları bulmanıza ve bunları düzeltmenize de yardımcı olabilir.

Gemini'a istem girme:

Review the uncommitted changes and find potential issues.

816ea8380bffc14f.png

10. Tebrikler!

Tebrikler! Android Home API örnek uygulamanızı, kullanıcı arayüzü oluşturma ve API entegrasyonunu otomatikleştirmek için Home API Bilgi Bankası ve Gemini'ı kullanarak başarıyla genişlettiniz. Yapay zeka destekli geliştirme ile örnek uygulamayı nasıl genişleteceğinizi öğrendiğinize göre deneyebileceğiniz diğer bazı şeyler şunlardır:

  • AGENTS.md dosyanızı iyileştirin: Gemini'ın kod önerilerini nasıl değiştirdiğini görmek için AGENTS.md dosyanıza belirli kodlama standartları veya marka yönergeleri eklemeyi deneyin.
  • Özel Otomasyon Oluşturma: Tüm kapıları kilitleme ve ışıkları karartma gibi bir "İyi Geceler" rutinini tetikleyen bir komut dosyası yazmak için Gemini'ı ve Bilgi Bankası'nı kullanın.
  • Official Home API Knowledge Base Guide (Resmi Home API Bilgi Bankası Kılavuzu) başlıklı makaleyi okuyun ve Accelerate Development with Gemini & the Knowledge Base (Gemini ve Bilgi Bankası ile Geliştirme Sürecini Hızlandırma) başlıklı videoyu izleyin.