Wear OS uygulamasında hata ayıklama

Fiziksel bir saatte Wear OS uygulamanızdaki hataları ayıklamak için geliştirme makinenizi kablosuz bağlantı veya Bluetooth kullanarak saate bağlayın. Alternatif olarak, saatinizde USB bağlantı noktası varsa USB kullanarak bağlayın.

Uygulamanız için destek gerekiyorsa, saat ve telefon gibi birden fazla cihazı kapsayan iş akışlarını da test edebilirsiniz. Test için bağlantı kurma hakkında daha fazla bilgi edinmek isterseniz saati telefona bağlama bölümünü ziyaret edin.

Not: Fiziksel bir saatiniz yoksa Android Studio'da uygulamanızı bir emülatörde test edip çalıştırabilirsiniz.

Wear OS'in en son sürümüne güncelleyin

Uygulamanızın en son yazılımda beklendiği gibi davrandığını doğrulamaya yardımcı olmak için test cihazınızın desteklediği en güncel Wear OS sürümünü çalıştırdığından emin olun.

Test cihazınızda sistem güncellemesi olup olmadığını kontrol etmek için aşağıdaki adımları uygulayın:

  1. Cihazı kablosuz ağa bağlayın.
  2. Cihazı şarj etmeye başlayın.
  3. Cihaz pilinin% 50 veya daha yüksek bir oranda şarj olmasını bekleyin.
  4. Test cihazınızda Ayarlar > Sistem > Sistem güncellemeleri'ne gidin.

    Sistem güncellemesi varsa indirilip test cihazınıza yüklenir.

Wear OS'in belirli bir sürümünü yükleyin (isteğe bağlı)

Uygulamanızın test durumu Wear OS'in belirli bir sürümüne bağlıysa USB veri bağlantısını destekleyen saatlere bir yazılım görüntüsü ekleyebilirsiniz. Örneğin, Google Pixel Watch 2'ye fabrika resmi veya tam OTA görüntüsü yükleyebilirsiniz.

Kol saatinizde geliştirici seçeneklerini etkinleştirin

Saatinizde hata ayıklama işlemi yapabilmek için önce geliştirici seçeneklerini etkinleştirin. Bunu yalnızca bir kez yapmanız yeterlidir. Geliştirici seçenekleri, siz devre dışı bırakana kadar etkin kalır. Geliştirici seçeneklerini etkinleştirmek için aşağıdakileri yapın:

  1. Saatte Ayarlar'ı açın.
  2. Sistem > Hakkında > Sürümler'e dokunun.
  3. Derleme numarası öğesine yedi kez dokunun.
  4. Artık geliştirici olduğunuzu onaylayan bir mesaj görünür.

Kablosuz ağ üzerinden hata ayıkla

Başlamadan önce, kol saatindeki geliştirici seçeneklerini daha önce açıklandığı gibi etkinleştirin.

Kol saatini kablosuz ağa bağlayın

  1. Saatte Ayarlar'ı açın.
  2. Bağlantı > Kablosuz'a dokunun.
  3. Bir ağ seçin ve gerekirse şifresini girin.

    Not: Saat ve geliştirme makineniz aynı ağa bağlı olmalıdır. Tüm erişim noktaları uygun değildir. Güvenlik duvarı adb özelliğini desteklemek için doğru şekilde yapılandırılmış bir erişim noktası kullanmanız gerekebilir.

Kablosuz ağ hata ayıklamasını etkinleştir

  1. Saatte Ayarlar'ı açın.
  2. Geliştirici seçenekleri > Kablosuz bağlantı üzerinden hata ayıkla'ya dokunun.
  3. Kısa bir süre sonra ekranda saatin IP adresi (ör. 192.168.1.100) görüntülenir. Sonraki adımda bu bilgiye ihtiyacınız olacak, bu nedenle not edin.

Hata ayıklayıcıyı saatle eşleme

  1. Wear OS cihazınızın sistem ayarlarında kablosuz hata ayıklama seçeneklerini bulun. Yeni cihaz eşle'yi seçin.
  2. Kablosuz eşleme kodu ile IP adresi ve bağlantı noktasını not edin.
  3. Geliştirme makinenizdeki bir terminal penceresine şu komutu yazın:
    adb pair IP_ADDRESS:PORT
    
  4. İstendiğinde, 2. adımdaki kablosuz eşleme kodunu girin. Terminal, eşleştirmenin başarılı olup olmadığı bilgisini verir. Örnek:
    Enter pairing code: 123456
    Successfully paired to 192.168.1.100:5555
    
Eşleme işleminden sonra ana bilgisayar, Wear OS cihazınızın Kablosuz Hata Ayıklama ekranındaki Eşlenen cihazlar listesinde görünür.

Hata ayıklayıcıyı saate bağlayın

  1. Saatinizi ve geliştirme makinenizi aynı ağa bağlayın.
  2. Saatin IP adresini ve bağlantı noktası numarasını kullanarak hata ayıklayıcıyı saate bağlayın. Örneğin, IP adresi 192.168.1.100 ve bağlantı noktası numarası 5555 ise adb connect komutu ve yanıtı aşağıdaki gibi görünür:

    adb connect 192.168.1.100:5555
    connected to 192.168.1.100:5555
    

Saat hata ayıklayıcıya bağlıdır ve hata ayıklamaya başlayabilirsiniz. Saatin IP adresini ve bağlantı noktası numarasını belirterek -s işaretini kullanarak saate adb komutları gönderin:

adb -s 192.168.1.100:5555 <command>

Emülatörü kullanmıyorsanız ve hata ayıklama için bağlı tek bir cihazınız varsa adresi belirtmeniz gerekmez:

adb <command>

Bluetooth üzerinden hata ayıkla

Not: Bluetooth hata ayıklama özelliği yalnızca Wear OS 2'yi çalıştıran ve Android ile eşlenmiş saatlerde çalışır.

Başlamadan önce kol saati ile telefonu eşleyip daha önce açıklandığı gibi saatte geliştirici seçeneklerini etkinleştirin. Telefonun Ayarlar menüsünü açıp Geliştirici Seçenekleri'ni arayarak geliştirici seçeneklerinin etkinleştirilmiş olduğundan emin olun. Gerekirse telefonda geliştirici seçeneklerini etkinleştirin.

Telefonda USB üzerinden hata ayıklamayı etkinleştirin

  1. Telefonun Ayarlar menüsünü açın.
  2. Geliştirici Seçenekleri'ni seçin ve USB üzerinden hata ayıklama'yı etkinleştirin.

Saatte ADB veya Bluetooth hata ayıklamasını etkinleştirin

  1. Saatin Ayarlar menüsünü açın.
  2. Geliştirici Seçenekleri'ne ilerleyin.
  3. ADB hata ayıklama'nın etkin olduğunu onaylayın.
  4. Bluetooth üzerinden hata ayıkla'yı etkinleştirin.

Telefonda Bluetooth hata ayıklamasını etkinleştirin

  1. Telefonda Wear OS tamamlayıcı uygulamasını açın.
  2. Gelişmiş Ayarlar'a gidin ve Gelişmiş Ayarlar seçeneklerini görüntülemek için dokunun.
  3. Bluetooth üzerinden hata ayıklama'yı etkinleştirin. Bu seçeneğin altında aşağıdaki durum mesajı görünür:
    Host: disconnected
    Target: connected
    

Bu noktada, geliştirme makinesi (ana makine) saatle, yani hedefle iletişim kurmaz. Bağlantıyı tamamlamanız gerekiyor.

Not: Aynı anda yalnızca bir cihazla hata ayıklayabilirsiniz. Eşlenmiş birden fazla saatiniz varsa Bluetooth hata ayıklama özelliği ana ekranda seçilen cihazla etkinleştirilir.

Hata ayıklayıcıyı saate bağlayın

Bu son adımda tüm öğeleri kullanırsınız: hata ayıklayıcı, telefon ve kol saati.

  1. Telefonu bir USB kablosuyla geliştirme makinenize bağlayın.
  2. Hata ayıklayıcıda şu iki komutu çalıştırın:
    adb forward tcp:4444 localabstract:/adb-hub
    adb connect 127.0.0.1:4444
    

    Not: IP adresi olarak 127.0.0.1 kullanmanız gerekir. Geliştirme makinenizdeki herhangi bir bağlantı noktasını ve her iki komutta da aynı bağlantı noktasını kullanın. Bu örnekte, bağlantı noktası 4444'tür.

  3. Bağlan komutunu girdikten sonra, saat ADB Hata Ayıklaması'na izin verdiğinizi onaylamanızı ister.
  4. Telefonda, Wear OS tamamlayıcı uygulamasındaki durum ekranında şunları kontrol edin:
    Host: connected
    Target: connected
    
  5. Saat hata ayıklayıcıya bağlıdır ve hata ayıklamaya başlayabilirsiniz.

Bluetooth kullanarak bir saatte hata ayıklarken adb, her zaman IP adresi (127.0.0.1) ve atadığınız bağlantı noktasını kullanır. Bu örnekte, bağlantı noktası 4444'tir. Tüm adb komutları aşağıdaki biçimi kullanır:

adb -s 127.0.0.1:4444 <command> 

Emülatörü kullanmıyorsanız ve hata ayıklama için bağlı tek bir cihazınız varsa adresi belirtmeniz gerekmez:

adb <command>

Wear OS için ekran kaydını kullanın

macOS'te uygulama geliştiriyorsanız Wear OS cihazınızdan video kaydetmek için GitHub projesi Mac için Android aracını kullanabilirsiniz.

Alternatif olarak aşağıdaki adımları uygulayarak Wear OS cihazınızdan da video kaydedebilirsiniz:

  1. Ham kareleri saatte kaydedin:
    adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw
  2. Ham dosyayı geliştirme makinenize kopyalayın:
    adb pull /sdcard/video.raw video.raw
  3. Ham dosyayı MP4'e dönüştürmek için ffmpeg kodunu kullanın:
    ffmpeg -f rawvideo -vcodec rawvideo -s 400x400 -pix_fmt rgb24 -r 10 -i video.raw -an -c:v libx264 -pix_fmt yuv420p video.mp4

    Not: İndirme ve yükleme talimatları için FFmpeg web sitesine bakın.