Uygulamanızı test edin ve hatalarını ayıklayın

Yerel karşılama uygulamanızı daha önce açıklanan adımları uygulayarak oluşturmanızı, ardından aşağıdaki adımları uygulayarak akıllı ev entegrasyonunuzu kendi barındırma ortamınızda test etmenizi öneririz:

  1. Kendi barındırma ortamınızda, yerel karşılama uygulamanızı çalıştıran HTML sayfasını sunun. Aşağıdaki snippet'te, yerel karşılama uygulamanızı çalıştıran statik bir HTML dosyası örneği gösterilmektedir.

    <html>
      <head>
        <!-- Local Home SDK -->
        <script src="//www.gstatic.com/eureka/smarthome/smarthome_sdk.js"></script>
        <!-- Local app under development -->
        <script src="local_execution.js"></script>
      </head>
    
    </html>
  2. Test cihazı kontrolü.

  3. Chrome'dan hata ayıklama. Entegrasyonunuzla ilgili sorunları gidermek için kesme noktalarını ve günlükleri kullanın.

  4. TypeScript kodunuzu değiştirip derleyin, ardından bu adımları tekrarlayın.

Bu derleme ve test sürecini tekrarlayarak değişikliklerinizi hızlı bir şekilde görebilir ve kodunuzdaki sorunları giderebilirsiniz.

Test cihazı kontrolü

Google Home Developer Console bölümünde, yerel karşılama sırasında Google Home veya Google Nest cihazına yüklenen HTML'yi sunan web uygulamanızın URL'sini belirtmeniz gerekir.

Cihaz kontrolünü yerel karşılama ile test etmek için aşağıdaki adımları uygulayın:

Chrome

  1. Google Home Developer Console'da buluttan buluta entegrasyonunuzun Kurulum ve yapılandırma sayfasına gidin, Yerel karşılama'ya ilerleyin ve ayarı açın.
  2. Testing URLs (Test URL'leri) > Testing URL for Chrome (Chrome için test URL'si) bölümünde, yerel karşılama uygulamanızı çalıştıran HTML'yi sunan geliştirme sunucusu URL'sini belirtin.
  3. Kaydet'i tıklayın. Google'ın konsol değişikliklerinizi yayması 30 dakikayı bulabilir.
  4. Test Google Home veya Google Nest cihazınızı yeniden başlatın.
  5. Akıllı cihazınıza komut verin. Örneğin, cihazınız OnOff özelliğini uyguluyorsa "Ok Google, ışıkları aç" diyebilirsiniz.

Node.js

  1. Google Home Developer Console'nın Kurulum ve yapılandırma sayfasında Yerel sipariş karşılama'ya gidin ve ayarı etkinleştirin.
  2. URL'leri test etme > Düğüm için URL'yi test etme bölümünde, yerel karşılama uygulamanızı çalıştıran JavaScript'i sunan geliştirme sunucusu URL'sini belirtin.
  3. Kaydet'i tıklayın. Google'ın konsol değişikliklerinizi yayması 30 dakikayı bulabilir.
  4. Test Google Home veya Google Nest cihazınızı yeniden başlatın.
  5. Akıllı cihazınıza komut verin. Örneğin, cihazınız OnOff özelliğini uyguluyorsa "Ok Google, ışıkları aç" diyebilirsiniz.

Cihazınızın hangi çalışma zamanını kullandığı hakkında daha fazla bilgi için Desteklenen cihazlar başlıklı makaleyi inceleyin.

Chrome'dan hata ayıklama

Chrome Geliştirici Araçları'nı kullanarak yerel karşılama uygulamanızda hata ayıklayabilirsiniz. Hata ayıklama işlemine başlamadan önce ortamınızın doğru şekilde ayarlandığından emin olun:

Yerel karşılama uygulamanızı Chrome Geliştirici Araçları hata ayıklayıcısına bağlamak için aşağıdaki adımları uygulayın:

Chrome

  1. Yerel geliştirme makinenizde Google Chrome tarayıcıyı yükleyip başlatın.
  2. Chrome tarayıcınızın adres alanına chrome://inspect#devices yazarak Chrome denetleyicisini başlatın. Sayfada cihazların listesini görürsünüz. HTML dosyanız, test Google Home veya Google Nest cihazınızın adı altında listelenir.
  3. Chrome Geliştirici Araçları'nı başlatmak için HTML'nizin altındaki mavi renkli inceleme bağlantısını tıklayın. Konsol sekmesine geçin. Local Home platformu, uygulama sürümünüzü ve Local Home SDK sürümünü konsol günlüğüne çıkarır. Günlüğü görüyorsanız Google, uygulamanızı başarıyla yüklemiş ve uygulamaya bağlanabiliyor demektir. Yanmıyorsa Google Home veya Google Nest cihazınızı yeniden başlatın.
  4. Şekil 1: chrome://inspect sayfasındaki yerel karşılama uygulaması.

Node.js

  1. Yerel geliştirme makinenizde Google Chrome tarayıcıyı yükleyip başlatın.
  2. Test cihazınızın yerel IP adresini belirleyin.
  3. Chrome tarayıcınızın adres alanına chrome://inspect#devices yazarak Chrome denetleyicisini başlatın.
  4. Hedef keşif ayarları'nı açmak için Yapılandır...'ı seçin.
  5. Şekil 2: chrome://inspect sayfasındaki hedef keşif ayarları.
  6. Listeye DEVICE_IP_ADDRESS:9222 girin ve Bitti'yi tıklayın.
  7. Chrome Geliştirici Araçları'nı başlatmak için komut dosyanızın altındaki mavi inceleme bağlantısını tıklayın. Konsol sekmesine geçin. Yerel Ev platformu, uygulama sürümünüzü ve Yerel Ev SDK'sı sürümünü konsol günlüğünde gösterir. Günlüğü görüyorsanız Google, uygulamanızı başarıyla yüklemiş ve uygulamaya bağlanabiliyor demektir. Yanmıyorsa Google Home veya Google Nest cihazınızı yeniden başlatın.

Cihazınızın kullandığı çalışma zamanı hakkında daha fazla bilgi için Desteklenen Cihazlar başlıklı makaleyi inceleyin.

Hata ayıklama ipuçları

Hata ayıklama sırasında göz önünde bulundurulması gereken diğer noktalar şunlardır:

  • Aynı yerel ağda test hesabınıza birden fazla Google Home veya Google Nest cihazı bağlamayın. Yerel karşılama komutlarıyla hangi Google Home veya Google Nest cihazın hedefleneceğini kontrol edemezsiniz.
  • Yerel karşılama uygulaması kapsayıcınızı geliştirme URL'nizdeki en son kodla yeniden yüklemek için Chrome Geliştirici Araçları'nda sayfayı yenileyin. Bu işlem, yerel karşılama uygulamanızda platform intent'lerini (ör. IDENTIFY) yeniden tetiklemek için gerekli olabilecek Yerel Ev platformunu sıfırlamaz. Yerel Ev platformunu sıfırlamak için Google Home veya Google Nest cihazınızı yeniden başlatın.
  • JavaScript uygulamanızın hatasız yüklendiğinden emin olun. Bunu yapmak için Geliştirici Araçları sayfasının konsol bölümüne bakın. Bir sorun varsa "Uncaught TypeError: Cannot read property 'open' of null" gibi bir mesaj görürsünüz.
  • IDENTIFY yanıtındaki verificationId, SYNC yanıtındaki otherDeviceIds değerlerinden biriyle eşleşmelidir.
  • EXECUTE işleyicisi için HTTP, TCP veya UDP komutlarınızın cihazınız tarafından alınabildiğinden ve beklendiği gibi çalıştığından emin olun.
  • İşleyicilerden bir Promise döndürdüğünüzden emin olun.
  • Genel durumu bellekte tutmaktan kaçının. Uygulama yaşam döngüsü bölümünü inceleyin.
  • Yerel karşılama uygulamanız tarafından oluşturulan hatalar, projenizin hata günlüklerinde görünür.

Hazırlama ve üretim kanalında kullanıma sunma

Akıllı ev işleminizi kullanıma sunmaya hazır olduğunuzda aşağıdaki adımları uygulayın:

  1. Bir terminal penceresi açın. Proje dizininizde npm run build komutunu çalıştırın. Bu komut, uygulamanız için dist dizini altında aşağıdaki JavaScript paketlerini oluşturur:
    project-directory/
    └── dist
     ├── web
     │    └── bundle.js
     └── node
          └── bundle.js
    
  2. Google Home Developer Console'ın Kurulum ve yapılandırma sayfasında Yerel sipariş karşılama'ya gidin ve ayarı etkinleştirin.
  3. JavaScript yükle düğmelerini kullanarak daha önce oluşturduğunuz paket dosyalarını yükleyin.
    Şekil 3: JavaScript uygulamanızı yükleyin.
    İşleminizin, yerel sipariş karşılamanın desteklediği tüm çalışma zamanı ortamlarında doğru şekilde çalışacak şekilde yapılandırılması için paket dosyalarının her iki sürümünü de (Node, Web) yüklediğinizden emin olun.
    1. Node.js'yi hedefleyen JavaScript'inizi yükleyin: dist/node dizinindeki bundle.js dosyasını yükleyin.
    2. Chrome'u (tarayıcı) hedefleyen JavaScript'inizi yükleyin: dist/web dizinindeki bundle.js dosyasını yükleyin.
  4. İşleminizi Asistan özellikli bir cihazda test ederek üretim ortamında beklendiği gibi davrandığını doğrulayın. Daha fazla bilgi edinmek için Akıllı ev İşleminizi test etme ve paylaşma başlıklı makaleyi inceleyin.
  5. İşleminizin işleyişinden memnun kaldığınızda Akıllı ev İşleminizi kullanıma sunma bölümündeki talimatları uygulayarak İşleminizi üretim dağıtımı için Google'a gönderin. Buna, kendi kendine test ve sertifika isteği adımlarının tamamlanması da dahildir.