Home APIs 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 indirme

  • Android hata ayıklayıcı (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:

  • Android 10 veya sonraki bir sürümü çalıştıran ve geliştirme için kullanmayı planladığınız bir Google Hesabı ile kurulmuş bir Android cihaz. Android Studio uygulaması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 bu cihazları 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. Aşağıdaki cihaz türleri ve özellikleri Android örnek uygulaması tarafından 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
    • 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 klonlanan google-home-api-sample-app-android proje klasörünü açın.

  2. İlk kurulum 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 uygulamanı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 Refactor (Yeniden düzenle) > Rename... (Yeniden adlandır...) seçeneğini belirleyin. Yeniden düzenleme > Yeniden adlandırma menüsü
    5. Yeni adı girin ve Yeniden düzenle'yi 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 içinde 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ı makaleye göz atın.

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

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

    Daha ayrıntılı talimatlar için Android Developers sitesindeki Run apps on a hardware device (Uygulamaları donanım cihazda ç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 Console'da proje seçici kontrol paneline gidin ve OAuth kimlik bilgileri oluşturmak için kullanmak istediğiniz projeyi seçin.
  2. API'ler ve Hizmetler sayfasına gidip gezinme menüsünde Kimlik Bilgileri'ni 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. İzin ekranını yapılandır'ı tıklayın. OAuth izin ekranı sayfası gösterilir.
    2. Kullanım alanınıza bağlı olarak Dahili veya Harici'yi seçip Oluştur'u 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österilir.
    4. Kapsam eklemeniz gerekmez. Bu nedenle Kaydet ve devam et'i tıklayın. Test kullanıcıları bölmesi gösterilir.
    5. Kitle'yi ve + KULLANICI EKLE düğmesini tıklayın.
    6. Test kullanıcınızın e-posta adresini girin ve KAYDET düğmesini 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'ı ayarlama bölümündeki talimatları uygulayarak örnek uygulamayı OAuth 2.0 için kaydedin ve OAuth kimlik bilgileri oluşturun.
    1. Yerel/Android uygulaması olan uygulama türünü 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 örnek uygulamayı mobil cihazınızda çalıştırmak için Projeyi çalıştır'ı tekrar tıklayın.

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