Home API'leri Android Örnek Uygulaması

Örnek Uygulama, Android için Google Home API'lerinin temel özelliklerini gösterir.

Ön koşullar

Uygulamayı oluşturmak, yüklemek ve test etmek için birkaç ön koşulu karşılamanız gerekir:

  • Android Studio, 2024.2.1 ("Ladybug") veya sonraki sürümler. Bu sürümden önceki sürümlerin Home API'leri SDK'sıyla düzgün çalışmayabileceğini unutmayın.

    Android Studio'yu indirin.

  • Android hata ayıklayıcısı (adb).

    adb uygulamasını yükleyin.

    Bu işlem SDK Yöneticisi ile yapılabilir.

Ayrıca, Home API'lerini test etmek için şunlara ihtiyacınız vardır:

  • Geliştirme için kullanmayı planladığınız bir Google Hesabı ile kurulmuş, Android 10 veya sonraki bir sürümü çalıştıran bir Android cihaz. Android Studio'nın güncel bir sürümünün yüklendiğinden ve bu geliştirici hesabıyla oturum açıldığından emin olun.
  • Kablosuz ağ
  • Matter cihazlara erişmek ve bunları kontrol etmek için Home API'lerini destekleyen bir Google hub'ı da gerekir. Ayrıntılar için Android'de bağlantı başlıklı makaleyi inceleyin.

  • Evde desteklenen en az bir cihaz olmalıdır. Bu cihaz (veya test etmek istediğiniz başka bir cihaz) Thread kullanıyorsa hub da Thread sınır yönlendirici olmalıdır. Android örnek uygulamasında aşağıdaki cihaz türleri ve özellikleri desteklenir:

    • Renk sıcaklığı ışığı (açma/kapama, parlaklık)
    • Temas sensörü (boolean durumu)
    • Kısılabilir Işık (açma/kapama, parlaklık)
    • Genişletilmiş Renkli Işık (açma/kapama, parlaklık)
    • Genel Anahtar
    • Google Kamera
    • Varlık sensörü (evde birisinin olup olmadığını algılama)
    • Işığı açma/kapatma (açma ve kapatma, parlaklık)
    • Açma/Kapatma Işık Anahtarı
    • Açma/Kapatma Eklenti Birimi (açık ve kapalı)
    • Açma/Kapatma Sensörü

Kaynak kodunu indirme

Örnek uygulamanın kaynak kodu GitHub'da mevcuttur.

Projeyi kaydetmek istediğiniz yere gidin ve projeyi klonlayın:

git clone https://github.com/google-home/google-home-api-sample-app-android.git

SDK'yı ayarlama

Bu açık beta sürümündeki Android için Ev API'leri, Google'ın geliştirme için sağladığı standart kitaplıklara henüz dahil edilmemiştir. Home API'leri ile Android uygulamaları geliştirmek için kitaplıkları indirip yerel olarak barındırmanız gerekir.

Home API'leri Android SDK'sını indirmek için önce Google Home Developers'a giriş yapmanız gerekir.

Hemen oturum açın!

Uygulamayı oluşturma

  1. Android Studio simgesini ve ardından yerel makinenize kopyalanan google-home-api-sample-app-android proje klasörünü açın.

  2. İlk kurulumunuz sırasında, Android Studio tüm proje bağımlılıklarını indirmek ve Gradle derlemesini tamamlamak için 10 dakika kadar sürebilir.

  3. Bilgisayarınızı bir USB kablosuyla fiziksel bir Android telefona bağlayın ve geliştirici seçeneklerinde ADB'yi etkinleştirin. Android Studio adlı çocuğun ADB aracılığıyla Android telefona bağlanabildiğinden emin olun.

  4. Örnek Uygulama'nın paket adını, daha önce kaydedilmemiş yeni bir adla (ör. kuruluşunuzun adına dayalı bir ad) değiştirin:

    1. Projeyi açın.
    2. Kaynak hiyerarşisini genişletin.
    3. Paketin değiştirmek istediğiniz bölümünü seçin. Diğer bir deyişle, com.example.
    4. Paketi sağ tıklayın ve Yeniden düzenle > Yeniden adlandır...'ı seçin. Yeniden düzenleme > Yeniden adlandırma menüsü
    5. Yeni adı girin ve Refactor'u (Yeniden düzenle) tıklayın.
    6. build.gradle.kts dosyasını düzenleyerek android namespace ve applicationId değerlerini yeni paket adıyla değiştirin.

  5. Gerekli tüm kitaplıklar indirildikten ve Gradle senkronizasyonu tamamlandıktan sonra uygulamayı oluşturup çalıştırmak için Çalıştır düğmesini tıklayın. Uygulama telefonunuzda başarıyla çalıştırıldığında Örnek Uygulama ana sayfasını görürsünüz.

İmzalama sertifikası oluşturma

Android Studio'da bir uygulamayı çalıştırdığınızda veya uygulamada hata ayıklama işlemi yaptığınızda, geliştirme ve hata ayıklama için tasarlanmış bir hata ayıklama sertifikası otomatik olarak oluşturulur. Ayrıntılı açıklama için Android Studio: Hata ayıklama derlemenizi imzalama başlıklı makaleyi inceleyin.

  1. Uygulamayı Android Studio içinde çalıştırarak bir hata ayıklama uygulaması imzalama sertifikası oluşturun. Android Studio içinde bir uygulamayı çalıştırdığınızda veya hata ayıkladığınızda, Android Studio otomatik olarak geliştirme ve hata ayıklama için tasarlanmış bir uygulama imzalama sertifikası oluşturur. Tam açıklama için Android Studio: Hata ayıklama yapınızı imzalama konusuna bakın.

    Mobil cihazınızı yerel makinenize bağlayın. Android Studio bağlı cihazlarınızı model numarasına göre listeleyecektir. Listeden cihazınızı seçin ve ardından Projeyi çalıştır'a tıklayın. Bu komut, örnek uygulamayı mobil cihazınızda oluşturup yükler.

    Daha ayrıntılı talimatlar için Android Developers sitesindeki Donanım cihazda uygulamaları çalıştırma başlıklı makaleyi inceleyin.

    Şimdi çalışan uygulamayı durdurun.

  2. Google Cloud Console Yardım sitesindeki OAuth İstemcilerini / Uygulama Türlerini / Yerel Uygulamaları / Android'i Yönetme bölümünde ayrıntılı olarak açıklanan talimatları uygulayarak hata ayıklama sertifikanızın SHA-1 parmak izini alın.

  1. Google Cloud konsolunda proje seçici panosuna gidin ve OAuth kimlik bilgilerini oluşturmak için kullanmak istediğiniz projeyi seçin.
  2. API'ler ve Hizmetler sayfasına gidin ve gezinme menüsünde Kimlik Bilgileri'ne tıklayın.

  3. Bu Google Cloud projesi için izin ekranınızı henüz yapılandırmadıysanız İzin ekranını yapılandır düğmesi görünür. Bu durumda, aşağıdaki prosedürü kullanarak izin ekranınızı yapılandırın. Aksi takdirde bir sonraki bölüme geçin.

    1. Onay ekranını yapılandır'a tıklayın. OAuth onay ekranı sayfası görüntülenir.
    2. Kullanım durumunuza bağlı olarak Dahili veya Harici'yi seçin ve ardından Oluştur'a tıklayın. OAuth izin ekranı bölmesi gösterilir.
    3. Uygulama bilgileri sayfasında ekrandaki talimatlara göre bilgileri girin ve Kaydet ve devam et'i tıklayın. Kapsamlar bölmesi görüntülenir.
    4. Kapsam eklemeniz gerekmez. Bu nedenle Kaydet ve devam et'i tıklayın. Test kullanıcıları bölmesi gösterilir.
    5. Hedef Kitle'ye tıklayın ve + KULLANICI EKLE düğmesine tıklayın.
    6. Test kullanıcı e-posta adresinizi girin ve KAYDET düğmesine tıklayın.
    7. Kaydet ve devam et'i tıklayın. Özet bölmesi gösterilir.
    8. OAuth kullanıcı rızası ekranı bilgilerinizi inceleyin ve Kontrol paneline geri dön'ü tıklayın.

Ayrıntılı bilgi için Google Cloud Console Yardım sitesindeki OAuth kullanıcı rızası ekranınızı ayarlama başlıklı makaleyi inceleyin. Devam etmeden önce en az bir test kullanıcısı eklediğinizden emin olun.

OAuth kimlik bilgilerini ayarlama

  1. OAuth 2.0 için Örnek Uygulamayı kaydedin ve OAuth 2.0 Kurulumu bölümünde verilen talimatları izleyerek OAuth kimlik bilgilerini oluşturun.
    1. Uygulama türünü (yerel/Android uygulaması) belirtin.
    2. Google Cloud Console Yardım sitesindeki OAuth 2.0 / Yerel uygulamalar / Android'i ayarlama bölümündeki talimatları uygulayarak SHA-1 parmak izini OAuth istemcisine ekleyin. Geliştirme süreci boyunca varsayılan Android Studio anahtarından SHA-1 anahtarı oluşturmanız gerekir.

Uygulamayı çalıştırma

  1. Mobil cihazınız yerel makinenize bağlıyken Projeyi çalıştır'ı tekrar tıklayarak örnek uygulamayı mobil cihazınızda çalıştırın.

Yüklendikten sonra uygulama, mobil cihazınızda Home API Sample App olarak kullanılabilir.