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

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

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

    <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. Cihaz kontrolünü test edin.

  3. Chrome'da hata ayıklayın. Entegrasyonunuzla ilgili sorunları gidermek için kesme noktaları ve günlükler kullanın.

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

Bu derleme ve test işlemini tekrarlayarak değişikliklerinizin nasıl çalıştığını hızlı ve kolay bir şekilde görebilir, kodunuzdaki sorunları daha kolay bir şekilde yakalayıp hata ayıklayabilirsiniz.

Cihaz kontrolünü test et

İşlem konsolunda web uygulamanızın URL'sini belirtmeniz gerekir. Bu URL, yerel sipariş karşılama sırasında Google Home veya Google Nest cihazına yüklenen HTML'yi yayınlar.

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

Chrome

  1. Actions konsolunda Akıllı Ev projenizi açın.
  2. Sol gezinme menüsünde İşlemler'i tıklayın.
  3. Yerel ana SDK'yı yapılandır (isteğe bağlı) > Chrome için test URL'nizi girin altında, yerel sipariş karşılama uygulamanızı çalıştıran HTML'yi sunan geliştirme sunucusu URL'sini belirtin.
  4. Kaydet'i tıklayın. Google'ın konsol değişikliklerinizi dağıtması 30 dakikayı bulabilir.
  5. Google Home veya Google Nest cihazınızı yeniden başlatın.
  6. Akıllı cihazınıza bir komut verin. Örneğin, cihazınız Kapalı özelliğini uyguluyorsa "Ok Google, ışıkları aç" diyebilirsiniz.

Node.js

  1. Actions konsolunda Akıllı Ev projenizi açın.
  2. Sol gezinme menüsünde İşlemler'i tıklayın.
  3. Yerel ana SDK'yı yapılandırın (isteğe bağlı) > Düğüm için test URL'nizi girin altında, yerel sipariş karşılama uygulamanızı çalıştıran JavaScript'i sunan geliştirme sunucusu URL'sini belirtin.
  4. Kaydet'i tıklayın. Google'ın konsol değişikliklerinizi dağıtması 30 dakikayı bulabilir.
  5. Google Home veya Google Nest cihazınızı yeniden başlatın.
  6. Akıllı cihazınıza bir komut verin. Örneğin, cihazınız Kapalı ö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 bölümüne bakın.

Chrome'da hata ayıklama

Chrome Geliştirici Araçları'nı kullanarak yerel sipariş karşılama uygulamasında hata ayıklama yapabilirsiniz. Hata ayıklama yapmadan önce, ortamınızın doğru şekilde ayarlandığından emin olun:

  • Konsoldaki geliştirme URL'nizi, Google Home veya Google Nest cihazı (yerel alan ağı veya internet üzerinden) tarafından erişilebilen bir URL olarak ayarladınız
  • Makineniz, test ettiğiniz Google Home veya Google Nest cihazla aynı yerel alan ağına bağlı.
  • Ağınız, cihazlar arasındaki paketleri engellemez.
  • Actions Console'da ve Google Home veya Google Nest cihazında aynı Google hesabıyla giriş yaptınız.
  • Bulut karşılamanızdaki SYNC yanıtını güncellediniz. otherDeviceIds alanında en az bir geçerli değer döndürmelidir.
  • Actions konsoluna doğru tarama yapılandırma bilgilerini girdiniz.

Yerel sipariş 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 şu adresi girerek Chrome denetleyicisini başlatın: chrome://inspect#devices. Sayfada cihazların listesi göreceksiniz. HTML dosyanız da test amaçlı Google Home veya Google Nest cihazınızın adının altında listelenmelidir.
  3. Chrome Geliştirici Araçları'nı başlatmak için HTML'nizin altındaki mavi denetleme bağlantısını tıklayın. Konsol sekmesine geçin. Yerel Ev platformu, uygulamanızın sürümünü ve Yerel Ev SDK sürümünü konsol günlüğünde oluşturur. Günlüğü görmeniz, Google'ın uygulamanızı başarıyla yüklediği ve uygulamaya bağlanabileceği anlamına gelir. Açılmamışsa Google Home veya Google Nest cihazınızı yeniden başlatın.
    4. Şekil 1: chrome://inspect'teki yerel sipariş 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 şu adresi girerek Chrome denetleyicisini başlatın: chrome://inspect#devices.
  4. Hedef keşif ayarlarını açmak için Yapılandır... seçeneğini belirleyin.
    5. Şekil 2: chrome://inspect'teki keşif ayarlarını hedefleme.
  5. Listeye DEVICE_IP_ADDRESS:9222 yazıp Bitti'yi tıklayın.
  6. Chrome Geliştirici Araçları'nı başlatmak için komut dosyanızın altındaki mavi denetleme bağlantısını tıklayın. Konsol sekmesine geçin. Yerel Ev platformu, uygulamanızın sürümünü ve Yerel Ev SDK sürümünü konsol günlüğünde oluşturur. Günlüğü görmeniz, Google'ın uygulamanızı başarıyla yüklediği ve uygulamaya bağlanabileceği anlamına gelir. Açılmamışsa Google Home veya Google Nest cihazınızı yeniden başlatın.

Cihazınızın hangi çalışma zamanını kullandığı hakkında daha ayrıntılı bilgi için Desteklenen Cihazlar bölümüne bakın.

Hata ayıklama ipuçları

Hata ayıklama sırasında dikkat edilmesi gereken diğer noktalar:

  • Aynı yerel ağdaki test hesabınıza birden çok Google Home veya Google Nest cihazı bağlamayın. Yerel karşılama komutlarıyla hangi Google Home veya Google Nest cihazın hedeflendiğini kontrol edemezsiniz.
  • Yerel sipariş karşılama kapsayıcınızı, geliştirme URL'nizdeki en son kodla yeniden yüklemek için Chrome Geliştirici Araçları'ndaki sayfayı yenileyin. Bu işlem, yerel sipariş karşılama uygulamanızda platform niyetlerini (IDENTIFY gibi) 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 bir şekilde yüklenip yüklenmediğini kontrol edin. Bunun için Geliştirici Araçları sayfasının konsol bölümüne göz atın. Sorun olursa şöyle bir mesaj görürsünüz: Uncaught TypeError: Cannot read property ‘open’ of null.
  • IDENTIFY yanıtındaki verificationId, SYNC yanıtındaki otherDeviceIds ile eşleşmelidir.
  • EXECUTE işleyici 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 Promise döndürmeyi unutmayın.
  • Genel bellek durumunu korumaktan kaçının. Uygulama yaşam döngüsü bölümüne bakın.
  • Yerel sipariş karşılama uygulamanız tarafından yapılan hatalar, proje hata günlüklerinizde görünür.

Hazırlık ve üretime sunma

Akıllı ev İşleminizi başlatmaya 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, dist dizini için uygulamanız için aşağıdaki JavaScript paketlerini oluşturur: 
    project-directory/
└── dist
 ├── web
 │    └── bundle.js
 └── node
      └── bundle.js
  2. Konsolda, Geliştir > İşlemler'i tıklayarak JavaScript uygulamanızı yükleyin. Yerel Ev SDK'yı Yapılandır bölümünde JavaScript dosyaları yükle'yi tıklayın.
    Şekil 3: JavaScript uygulamanızı yükleyin.
  3. Dosya yükleme iletişim kutusunda, daha önce oluşturduğunuz paket dosyalarını yükleyin. İşleminizin yerel istek 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 (Düğüm, Web) her iki sürümünü de yüklediğinizden emin olun.
    1. JavaScript.js'yi hedefleyerek JavaScript dosyanızı yükleyin: bundle.js dosyasını dist/node dizininden yükleyin.
    2. Chrome'u hedefleyen JavaScript'i (tarayıcı) yükleyin: bundle.js dosyasını dist/web dizininden 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 işleminizi test etme ve paylaşma başlıklı makaleye bakın.
  5. İşleminizin çalışmasından memnun olduğunuzda Akıllı ev Action'ınızı başlatma bölümündeki talimatları uygulayarak üretim dağıtımı için Google'a gönderin. Buna test ve sertifika isteği adımlarının tamamlanması dahildir.
Önceki
Yerel sipariş karşılama uygulamasını uygulayın