Wear OS uygulamasında hata ayıklama

Fiziksel bir kol saatinde Wear OS uygulamanızdaki hataları ayıklamak için şu uygulamayı kullanarak geliştirme makinenizi kol saatine bağlayın: Kablosuz veya Bluetooth. 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. Kurulum hakkında daha fazla bilgi için test bağlantısı, saati bir telefon.

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ı tamamlayın:

  1. Cihazı 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.

    Bir sistem güncellemesi varsa bu güncelleme indirilerek şuraya yüklenir: test cihazınıza yükleyin.

Belirli bir Wear OS sürümünü yükleme (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 kol saatlerine yazılım görüntüsü yükleme. Ö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 şu zamana kadar etkin kalır: bunları devre dışı bırakmanız gerekir. 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, önceden açıklandığı gibi kol saatinde 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: 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'ü desteklemek için doğru şekilde yapılandırılmış bir erişim noktası kullanmanız gerekebilir.

Kablosuz bağlantı hata ayıklamasını etkinleştir

  1. Kol saatinin Ayarlar'ını açın.
  2. Geliştirici seçenekleri > Kablosuz ağ üzerinden hata ayıklayın.
  3. Bir süre sonra ekranda saatin IP adresi (ör. 192.168.1.100) gösterilir. Bir sonraki adımda buna ihtiyacınız olduğu için, bunu 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 adresini ve bağlantı noktası.
  3. Geliştirme makinenizdeki bir terminal penceresine şunu yazın: komut: 
    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. Örneğin: 
    Enter pairing code: 123456
Successfully paired to 192.168.1.100:5555
Eşleme işleminden sonra ana bilgisayar, Eşlenen cihazlar listesinde görünür. Wear OS cihazınızın Kablosuz Hata Ayıklama ekranında.

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ı 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ı ş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. adb komutu gönder -s işaretini kullanarak, saatin IP adresini belirtir ve bağlantı noktası numarası:

adb -s 192.168.1.100:5555 <command>

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

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. Geliştirici seçeneklerinin telefonunun Ayarlar menüsüne gidip Geliştirici Seçenekleri'ni bulun. Gerekirse geliştiriciyi telefondaki seçenekler'e dokunun.

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

  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ıklama özelliğini etkinleştirin

  1. Saatin Ayarlar menüsünü açın.
  2. Geliştirici Seçenekleri'ne ilerleyin.
  3. ADB hata ayıklama işleminin etkin olduğunu onaylayın.
  4. Bluetooth üzerinden hata ayıkla'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), yani saat, yani hedef. Bağlantıyı tamamlamanız gerekir.

Not: Aynı anda yalnızca bir cihazla hata ayıklayabilirsiniz. Birden fazla kol saatiniz eşlenmişse Bluetooth hata ayıklama yalnızca etkinleştirilir. ana ekranda seçili cihaz görünür.

Hata ayıklayıcıyı kol saatine bağlayın

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. Kol saati hata ayıklayıcıya bağlandı ve hata ayıklamaya hazırsınız.

Bluetooth'u kullanarak bir kol saatindeki hataları ayıklarken adb her zaman 127.0.0.1 IP adresini kullanır ve atadığınız bağlantı noktasını ekleyin. Bu örnekte, bağlantı noktası 4444 olarak belirlenmiş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ı yalnızca bir cihazınız varsa adresi belirtmeniz gerekir:

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 bir 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 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: İndirmek için FFmpeg web sitesine bakın ve yükleme talimatları.