Wear OS uygulamasında hata ayıklama

Wear OS uygulamanızda fiziksel bir saatte hata 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ğlanın.

Uygulamanız bu desteği gerektiriyorsa saat 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 istiyorsanız saati telefona bağlama başlıklı makaleyi inceleyin.

Not: Fiziksel bir kol 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üncelleme

Uygulamanızın en yeni yazılımda beklendiği gibi çalıştığını doğrulamak için test cihazınızın, 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ı 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 test cihazınıza indirilip yüklenir.

Wear OS'in belirli bir 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ükleyebilirsiniz. Örneğin, Google Pixel Watch 3 veya Google Pixel Watch 2 cihazına fabrika ayarı görüntüsü ya da tam OTA görüntüsü yükleyebilirsiniz.

Kol saatinizde geliştirici seçeneklerini etkinleştirme

Saatinizde hata ayıklama 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. 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österilir.

Kablosuz ağ üzerinden hata ayıkla

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

Kol saatini bir kablosuz ağa bağlayın.

  1. Kol saatinin Ayarlar'ını açın.
  2. Bağlantı > Kablosuz'a dokunun.
  3. Bir ağ seçin ve gerekirse ş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. adb'ı desteklemek için güvenlik duvarı düzgün ş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ıklama'ya dokunun.
  3. Bir süre sonra ekranda saatin IP adresi (ör. 192.168.1.100) gösterilir. Bu bilgiye sonraki adımda ihtiyacınız olacak. Bu nedenle, bilgiyi 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 kodunu ve IP adresini 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. Örneğin: 
    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şlenmiş cihazlar listesinde görünür.

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

  1. Kol saatinizi ve geliştirme makinenizi aynı ağa bağlayın.

  2. Hata ayıklayıcıyı, saatin IP adresini ve bağlantı noktası numarasını kullanarak 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

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

adb -s 192.168.1.100:5555 <command>

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

adb <command>

Bluetooth üzerinden hata ayıkla

Not: Bluetooth hata ayıklama yalnızca Android ile eşlenmiş ve Wear OS 2 çalıştıran saatlerde işe yarar.

Başlamadan önce saati ve telefonu eşleyin, ardından daha önce açıklandığı gibi saatte geliştirici seçeneklerini etkinleştirin. Telefonun Ayarlar menüsünü açıp Geliştirici Seçenekleri'ni bularak telefonda geliştirici seçeneklerinin etkinleştirildiğini doğrulayın. 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 hata ayıklama'yı etkinleştirin.

Kol saatinde ADB veya Bluetooth hata ayıklama işlevini etkinleştirme

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

Telefonda Bluetooth hata ayıklamayı 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österilir: 
    Host: disconnected
Target: connected

Bu noktada geliştirme makinesi (ana makine), kol saati (hedef) ile iletişim kurmuyor. Bağlantıyı tamamlamanız gerekir.

Not: Tek seferde yalnızca bir cihazla hata ayıklama yapabilirsiniz. Birden fazla kol saatiniz eşlenmişse Bluetooth hata ayıklama yalnızca ana ekranda seçilen cihazda etkinleştirilir.

Hata ayıklayıcıyı saate 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 makinenizde kullanılabilen 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ğlanma komutunu girdikten sonra kol saati, ADB hata ayıklamasına 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ı 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'dı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 yalnızca bir cihaz bağlıysa adresi belirtmeniz gerekmez:

adb <command>