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

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

  1. Kendi barındırma ortamınızda, yerel sipariş tamamlama uygulamanızı çalıştıran HTML sayfasını yayınlayın. Aşağıdaki snippet'te, yerel sipariş tamamlama 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. Cihaz kontrolünü test edin.

  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 ve ardından bu adımları tekrarlayın.

Bu derleme ve test sürecini tekrarlayarak değişikliklerinizi hızlı bir şekilde çalışırken görebilir ve kodunuzdaki sorunları daha kolay yakalayıp hata ayıklayabilirsiniz.

Cihaz denetimini test etme

İşlem Konsolu'nda, yerel sipariş 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.

Yerel sipariş tamamlama ile cihaz kontrolünü test etmek için aşağıdaki adımları uygulayın:

Chrome

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

Node.js

  1. Actions Console'da Akıllı Ev projenizi açın.
  2. Sol gezinme menüsünde İşlemler'i tıklayın.
  3. Yerel ana sayfa SDK'sını yapılandırma (isteğe bağlı) > Node için test URL'nizi girin bölümünde, yerel sipariş tamamlama uygulamanızı çalıştıran JavaScript'i sunan geliştirme sunucusu URL'sini belirtin.
  4. Kaydet'i tıklayın. Google'ın Console değişikliklerinizi dağıtması 30 dakikayı bulabilir.
  5. Test amaçlı Google Home veya Google Nest cihazınızı yeniden başlatın.
  6. Akıllı cihazınıza komut verin. Örneğin, cihazınız OnOff özelliğini kullanıyorsa "Ok Google, ışıkları aç" diyebilirsiniz.

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

Chrome'dan hata ayıklama

Yerel sipariş tamamlama uygulamanızdaki hataları Chrome Geliştirme Araçları'nı kullanarak ayıklayabilirsiniz. Hata ayıklamadan önce ortamın doğru şekilde ayarlandığından emin olun:

  • Konsoldaki geliştirme URL'nizi, Google Home veya Google Nest cihazının (yerel alan ağında veya internet üzerinden) erişebileceği bir URL olarak ayarladıysanız
  • Cihazınız, test ettiğiniz Google Home veya Google Nest cihazıyla aynı yerel alana bağlı olmalıdır.
  • Ağınız, cihazlar arasındaki paketleri engellemiyor.
  • Actions Console'da ve Google Home veya Google Nest cihazda aynı Google Hesabı ile giriş yapmış olmanız gerekir.
  • Bulut sipariş tamamlama işleminizde SYNC yanıtını güncellediniz. otherDeviceIds alanında en az bir geçerli değer döndürmelidir.
  • İşlemler Konsolu'na doğru tarama yapılandırması bilgilerini girdiniz.

Yerel sipariş tamamlama 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 makinenize Google Chrome tarayıcısını yükleyip başlatın.
  2. Chrome tarayıcınızın adres alanına chrome://inspect#devices yazarak Chrome denetçisini başlatın. Sayfada cihazların listesini görürsünüz. HTML dosyanız, test ettiğiniz Google Home veya Google Nest cihazının adı altında listelenir.
  3. Chrome Geliştirici Araçları'nı başlatmak için HTML'nizin altındaki mavi "İncele" bağlantısını tıklayın. Konsol sekmesine geçin. Yerel Home platformu, uygulama sürümünüzü ve Yerel Home SDK sürümünü konsol günlüğüne gönderir. Günlüğü görüyorsanız Google, uygulamanızı başarıyla yüklemiş ve uygulamaya bağlanabilmiş demektir. Sorun düzelmediyse Google Home veya Google Nest cihazınızı yeniden başlatın.
    4. Şekil 1: chrome://inspect adresindeki yerel sipariş tamamlama uygulaması.

Node.js

  1. Yerel geliştirme makinenize Google Chrome tarayıcısını yükleyip çalıştırı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 denetçisini başlatın.
  4. Hedef bulma ayarlarını açmak için Yapılandır...'ı seçin.
    5. Şekil 2: chrome://inspect adresindeki hedef bulma ayarları.
  5. Listeye DEVICE_IP_ADDRESS:9222 yazın ve 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 Home platformu, uygulama sürümünüzü ve Yerel Home SDK sürümünü konsol günlüğüne gönderir. Günlüğü görüyorsanız Google, uygulamanızı başarıyla yüklemiş ve uygulamaya bağlanabilmiş demektir. Sorun düzelmediyse 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 bölümüne bakın.

Hata ayıklamayla ilgili ipuçları

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

  • Aynı yerel ağdaki test hesabınıza birden fazla Google Home veya Google Nest cihazı bağlamayın. Yerel yerine getirme komutlarıyla hangi Google Home veya Google Nest cihazının hedeflendiğini kontrol edemezsiniz.
  • Yerel sipariş tamamlama uygulama 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 Home platformunu sıfırlamaz. Yerel sipariş tamamlama uygulamanızda platform intent'lerini (IDENTIFY gibi) yeniden tetiklemek için bu işlem gerekli olabilir. Yerel Home platformunu sıfırlamak için Google Home veya Google Nest cihazınızı yeniden başlatın.
  • JavaScript uygulamanızın hatasız şekilde yüklenip yüklenmediğini kontrol edin. Bunun için DevTools sayfasının konsol bölümünü kontrol edin. Sorun varsa şuna benzer 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ş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.
  • Bellekte genel durumu korumaktan kaçının. Uygulama yaşam döngüsü başlıklı makaleyi inceleyin.
  • Yerel sipariş karşılama uygulamanız tarafından oluşturulan hatalar, projenizin hata günlüklerinde görünür.

Hazırlayıp üretime 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 dizininde npm run build komutunu çalıştırın. Bu komut, uygulamanız için dist dizininde 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 Home SDK'yı yapılandır bölümünde JavaScript dosyalarını yükle'yi tıklayın.
    Şekil 3: JavaScript uygulamanızı yükleyin.
  3. Dosyaları yükle iletişim kutusunda, daha önce oluşturduğunuz paket dosyalarını yükleyin. İşleminizin yerel sipariş tamamlamanın desteklediği tüm çalışma ortamlarında düzgün ş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'i 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. Üretim ortamında beklendiği gibi davrandığını doğrulamak için işleminizi Asistan özellikli bir cihazda test edin. Daha fazla bilgi için Akıllı ev işleminizi test etme ve paylaşma başlıklı makaleyi inceleyin.
  5. İşleminizin işleyişinden memnun kaldığınızda Akıllı ev işleminizi kullanıma sunma başlıklı makaledeki talimatları uygulayarak üretime dağıtılmak üzere Google'a gönderin. Buna kendi kendine test ve sertifika isteği adımlarını tamamlama da dahildir.
Önceki
Yerel sipariş karşılama uygulamasını uygulayın