Wear OS uygulamasında hata ayıklama

Wear OS uygulamanızda fiziksel bir saatte hata ayıklama yapmak için geliştirme makinenizi kablosuz bağlantı veya Bluetooth kullanarak saate bağlayın. Alternatif olarak, kol saatinizde USB bağlantı noktası varsa USB kullanarak bağlanabilirsiniz.

Uygulamanız bu desteği gerektiriyorsa kol saati ve telefon gibi birden fazla cihazı kapsayan iş akışlarını da test edebilirsiniz. Test için bağlantı oluşturma hakkında daha fazla bilgi edinmek isterseniz saati telefona bağlama başlıklı makaleyi inceleyin.

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

Wear OS'u en son sürüme güncelleyin

Uygulamanızın en son yazılımda beklendiği gibi davrandığını doğrulamak için test cihazınızda, cihazınızın desteklediği Wear OS'in en güncel sürümünün çalıştığı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ı bir kablosuz ağa bağlayın.
  2. Cihazı şarj etmeye başlayın.
  3. Cihazın pilinin% 50 veya daha fazla ş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.

Belirli bir Wear OS sürümünü yükleme (isteğe bağlı)

Uygulamanızın test senaryosu Wear OS'un belirli bir sürümüne bağlıysa USB veri bağlantısını destekleyen kol saatlerine yazılım resmi yükleyebilirsiniz. Örneğin, Google Pixel Watch 3 veya Google Pixel Watch 2 cihazına fabrika resmi ya da tam OTA resmi yükleyebilirsiniz.

Kol saatinizde geliştirici seçeneklerini etkinleştirme

Saatinizde hata ayıklama işlemi yapabilmek için geliştirici seçeneklerini etkinleştirin. Bunu yalnızca bir kez yapmanız gerekir. 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. Kol saatinin Ayarlar'ını 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, daha önce açıklandığı şekilde saatte geliştirici seçeneklerini etkinleştirin.

Kol saatini kablosuz ağa bağlama

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

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

Kablosuz hata ayıklamayı etkinleştirme

  1. Kol saatinin Ayarlar'ını açın.
  2. Geliştirici seçenekleri > Kablosuz ağ üzerinden hata ayıkla'ya dokunun.
  3. Bir süre sonra ekranda saatin IP adresi (ör. 192.168.1.100) gösterilir. Sonraki adımda bu kimliğe ihtiyacınız olacağından not edin.

Hata ayıklayıcıyı kol saatiyle eşleme

  1. Wear OS cihazınızda, 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 penceresinde aşağıdaki komutu yazın: 
    adb pair IP_ADDRESS:PORT
  4. İstendiğinde 2. adımdaki kablosuz eşleme kodunu girin. Terminal, eşlemenin başarılı olup olmadığını gösterir. Ö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ı kol saatine bağlama

  1. Kol 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ı kol saatine bağlayın. Örneğin, IP adresi 192.168.1.100 ve bağlantı noktası numarası 5555 ise adb connect komutu ve yanıtı şu şekilde görünür: 

    adb connect 192.168.1.100:5555
connected to 192.168.1.100:5555

Kol saati hata ayıklayıcıya bağlandı ve hata ayıklamaya hazırsınız. -s işaretini kullanarak saatin IP adresini ve bağlantı noktası numarasını belirterek 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 Android ile eşlenmiş ve Wear OS 2 yüklü saatlerde çalışır.

Başlamadan önce kol saatini ve telefonu eşleyin ve daha önce açıklandığı gibi kol saatinde geliştirici seçeneklerini etkinleştirin. Telefonun Ayarlar menüsünü açıp Geliştirici Seçenekleri'ni arayarak geliştirici seçeneklerinin telefonda etkinleştirildiğinden emin olun. Gerekirse telefonda geliştirici seçeneklerini etkinleştirin.

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

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

Saatte ADB veya Bluetooth hata ayıklama özelliğini etkinleştirin

  1. Kol saatinin Ayarlar menüsünü açın.
  2. Geliştirici Seçenekleri'ne gidin.
  3. ADB hata ayıklama'nın etkinleştirildiğinden emin olun.
  4. Bluetooth üzerinden hata ayıklama'yı etkinleştirin.

Telefonda Bluetooth hata ayıklama özelliğini etkinleştirme

  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. 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ıklama yapabilirsiniz. Birden fazla kol saatiniz eşlenmişse Bluetooth hata ayıklaması yalnızca ana ekranda seçilen cihaz ile etkinleştirilir.

Hata ayıklayıcıyı kol saatine bağlama

Bu son adımda hata ayıklayıcıyı, telefonu ve kol saatini kullanırsınız.

  1. Telefonu 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: 127.0.0.1 IP adresini kullanmanız gerekir. Geliştirme makinenizdeki herhangi bir bağlantı noktasını kullanı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 kol saati, ADB hata ayıklama'ya izin verdiğinizi onaylamanızı ister.
  4. Telefonda, Wear OS tamamlayıcı uygulamasındaki durum ekranında aşağıdakileri kontrol edin: 
    Host: connected
Target: connected

    5. Saat artık hata ayıklayıcıya bağlıdır ve hata ayıklamaya başlayabilirsiniz.

Bluetooth kullanarak bir kol saatinde hata ayıklama yaptığınızda adb her zaman 127.0.0.1 IP adresini ve atadığınız bağlantı noktasını kullanır. Bu örnekte bağlantı noktası 4444'tür. 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ı kullanma

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

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

  1. Saatte ham kareler kaydetme: 
    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 simgesini 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.