Uygulamaları donanım cihazında çalıştırma

Android uygulamanızı her zaman şurada test edin: gerçek bir cihaza sahip olması gerekir. Bu sayfada, dönüşüm izlemeyi nasıl test ve hata ayıklama için geliştirme ortamınızı ve Android cihazınızı Android Debug Bridge (ADB) bağlantısı.

Geliştirme için cihaz kurulumu

Cihazınızda hata ayıklamaya başlamadan önce USB kablosu veya kablosuz ağ kullanarak cihaza bağlayabilirsiniz. Ardından şunları yapın:

  1. Cihazda Ayarlar uygulamasını açın, Geliştirici seçenekleri'ni seçin ve ve ardından USB üzerinden hata ayıklama'yı etkinleştirin (varsa).

  2. Sisteminizi cihazınızı algılayacak şekilde ayarlayın.

    • ChromeOS: Ek yapılandırma gerekmez.
    • macOS: Ek yapılandırma gerekmez.
    • Windows: ADB için USB sürücüsü yükleyin (varsa). Örneğin, kurulum kılavuzu ve OEM sürücülerinin bağlantıları için OEM USB'yi yükleme edinin.
    • Ubuntu Linux: Aşağıdakileri kurun:

      • ADB'yi kullanmak isteyen her kullanıcının plugdev grubunda olması gerekir. Şurada olmadığınızı belirten bir hata mesajı görürseniz: plugdev grubunu eklemek için aşağıdaki komutu kullanarak kendinizi bu gruba ekleyin:
      sudo usermod -aG plugdev $LOGNAME
      

      Gruplar yalnızca giriş yapıldığında güncellenir, bu nedenle için çıkış yapmanız gerekir geçerli olur. Tekrar giriş yaptığınızda id kullanarak şu işlemleri yapabilirsiniz: plugdev grubunda olup olmadığınızı kontrol edin.

      • Sistemde, cihazı kapsayan udev kuralları yüklü olmalıdır. android-sdk-platform-tools-common paketi şunları içeriyor: Android cihazlar için topluluk tarafından korunan varsayılan udev kural grubu. Bu uzantıyı yüklemek için aşağıdaki komutu kullanın:
      apt-get install android-sdk-platform-tools-common
      

Cihazınıza USB ile bağlayın

Kurulumu yapıp USB üzerinden taktığınızda Çalıştır'ı tıklayın. kullanarak uygulamanızı cihazda derleyip çalıştırın.

Komut vermek için adb simgesini de kullanabilirsiniz. şu şekilde:

  • adb devices komutunu çalıştırarak cihazınızın bağlı olduğunu doğrulayın android_sdk/platform-tools/ dizininizden. Eğer bağlı olduğunda cihazın listelendiğini görürsünüz.
  • Herhangi bir adb komutu -d işaretini kullanın.

Kablosuz ağ kullanarak cihazınıza bağlanın

Android 11 ve sonraki sürümler, uygulamanızın kablosuz olarak dağıtılmasını ve hata ayıklamasını destekler Android Debug Bridge (ADB) aracılığıyla iş istasyonunuzdan. Örneğin, şunları yapabilirsiniz: hata ayıklaması yapılabilir uygulamanızı fiziksel olarak birden fazla uzak cihaza dağıtın USB ile cihazınızı bağlamak ve sık karşılaşılan USB bağlantı sorunlarıyla mücadele etmek, örneğin sürücü yüklemesi gibi.

Kablosuz hata ayıklama özelliğini kullanmak için cihazınızı iş istasyonunuzla eşlemeniz gerekir. girdiğinizi varsayalım. Başlamak için aşağıdaki adımları tamamlayın:

  1. İş istasyonunuzun ve cihazınızın aynı kablosuz ağa bağlı olduğundan emin olun. ağ.
  2. Cihazınızın Android 11 veya sonraki bir sürümü çalıştırdığından emin olun. Daha fazla bilgi için Android sürümünüzü kontrol etme ve güncelleme başlıklı makaleyi inceleyin.
  3. Android Studio'nun en son sürümünü yüklediğinizden emin olun. Buradan indirin.
  4. İş istasyonunuzda SDK Platform Araçları'nı en son sürüme güncelleyin.

Cihazınıza bağlanmak için aşağıdaki adımları uygulayın:

  1. Android Studio'yu açın ve çalıştırma sırasında Cihazları Kablosuz Bağlantı Kullanarak Eşle'yi seçin. yapılandırma menüsü.
    Yapılandırmaları çalıştır açılır menüsü
    Şekil 1. Yapılandırmaları çalıştırma açılır.

    Şekil 2'de gösterildiği gibi Cihazları kablosuz ağ üzerinden eşle iletişim kutusu görünür.
    Kablosuz ağ üzerinden cihaz eşleme pop-up penceresinin ekran görüntüsü
    Şekil 2. QR kodu veya eşleme kodunu kullanarak cihazları eşlemek için iletişim kutusu.
  2. Geliştiriciyi etkinleştir seçenekleri cihazınızda.
  3. Şurada hata ayıklamayı etkinleştir: Kablosuz ağ cihazınızda.
    Kablosuz hata ayıklamayı gösteren piksel telefonun ekran görüntüsü
      sistem ayarını değiştirebilirsiniz.
    Şekil 3. İlgili içeriği oluşturmak için kullanılan Google Pixel'de kablosuz hata ayıklama ayarı dokunun.
  4. Kablosuz hata ayıklama'ya dokunup cihazınızı eşleyin:
    1. Cihazınızı QR koduyla eşlemek için Cihazı QR koduyla eşle'yi seçin. açın ve Şekil 2'de gösterilen QR kodunu tarayın.
    2. Cihazınızı bir eşleme koduyla eşlemek için Cihazı şununla eşle: Kablosuz ağ üzerinden yeni cihazları eşle iletişim kutusundan eşleme kodunu girin. Cihazınızda Eşleme kodunu kullanarak eşle'yi seçin. Altı basamaklı görünür. Cihazınız Cihazları kablosuz ağ üzerinden eşle penceresindeki altı haneli kodu tıklayın ve Eşle'yi seçin .
      Örnek eşleme kodu girişinin ekran görüntüsü
      Şekil 4. Altı basamaklı sayı örneği girin.
  5. Eşleme sonrasında uygulamanızı cihazınıza dağıtmayı deneyebilirsiniz.

Farklı bir cihazı eşlemek veya iş istasyonunuzda bu cihazı unutmak için:

  1. Cihazınızda Kablosuz hata ayıklama'ya gidin.
  2. Eşlenen cihazlar bölümünden iş istasyonunuzun adına dokunun.
  3. Unut'u seçin.

Cihaz yansıtma

Fiziksel cihazınızı, Android'deki Çalışan Cihazlar penceresine yansıtabilirsiniz. Stüdyo'yu seçin. Cihazınızın ekranını doğrudan Android Studio'ya aktararak şunları yapabilirsiniz: uygulama başlatma ve düzenleme gibi genel işlemleri yürütmek için ekranı döndürüyor, telefonu katlayıp açabilir ve ses seviyesi değiştiriliyor.

Cihaz yansıtma özelliği, etkinleştirilmiş bir bilgisayarda kullanın. 24 saat boyunca Çalışan Cihazlar penceresini veya Cihaz Yöneticisi'ni kullanarak yansıtma (Görünüm > Araç Pencereleri > Cihaz Yöneticisi). Ayrıca, cihazlarınızın ne zaman yansıtma, ayarlarında etkinleştirilmiş (Ayarlar > Araçlar > Cihaz Yansıtma).

Çalışan Cihazlar kullanıcı arayüzü

Sesi yönlendir

Cihaz yansıtma kullanırken bağlı cihazlardan gelen sesi yönlendirebilirsiniz bilgisayarınızın hoparlörlerine veya kulaklığınıza fiziksel cihazlarınızı bağlayabilirsiniz. Sesli yönlendirme için, kulaklığınızı bilgisayarınıza bağlı tutun ve birine manuel olarak yeniden bağlanmak zorunda kalmadan bilgisayarı ve bağlı telefonu cihaz ve ardından başka bir cihaz kullanabilirsiniz. Ses yönlendirmeyi etkinleştirmek için Dosya (Android) Studio) > Ayarlar > Araçlar > Cihaz Yansıtma'yı tıklayın ve Yerel cihazlardaki sesi yönlendirin. Sesin her zaman yeniden yönlendirildiğini unutmayın. Android 12 veya sonraki sürümleri çalıştıran Firebase Test Lab cihazları için ayarlardan bağımsız olarak daha yüksek olabilir.

Bilinen sorunlar

Bazı cihazlar, yeterli bit hızında kodlama yapamayabilir. destekler. Bu tür durumlarda, RunningDevices (Çalıştırılan Cihazlar) penceresinin yanı sıra aşağıdakine benzer günlükler gösterilir.

2023-06-01 15:32:22,675 [  56094]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - Too many video encoder errors:
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - encoder: c2.android.vp8.encoder
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - mime type: video/x-vnd.on2.vp8
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max resolution: 640x640
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - min resolution: 2x2
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - alignment: 2x2
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max frame rate: 960
2023-06-01 15:32:22,676 [  56095]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max frame rate for 288x640: 960
2023-06-01 15:32:22,870 [  56289]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - max bitrate: 20000000
2023-06-01 15:32:22,871 [  56290]   WARN - ScreenSharingAgent Samsung SM-A045F API 33 - terminated with code 1

Gizlilik uyarısı

Cihaz yansıtma ayarlarına bağlı olarak Android Studio otomatik olarak başlatılabilir cihaz yansıtma özelliğini kullanabilirsiniz. Bu da adb tcpip komutuna bağlı cihazlar için bilgi açıklaması Bunun nedeni, yansıtma bilgilerinin ve komutların şifrelenmemiş bir yardımcı olur. Ayrıca, Android Studio, bir kullanıcı tarafından bir içerik üreticiyle iletişim kurmak için adb sunucusu ile yapılır. Böylece, yansıtılan bilgiler diğer kullanıcılar tarafından ele geçirilebilir. kontrol edin.

Cihaz bağlantısı sorunlarını giderme

Cihazınız Android Studio'ya bağlanmıyorsa aşağıdaki adımları deneyin: sorunu çözün:

Bağlantı Asistanı ile sorun giderme

Bağlantı Asistanı, kurulum yapmanıza yardımcı olacak adım adım talimatlar sunar. ve ADB bağlantısı üzerinden bir cihaz kullanmanız gerekir.

Asistanı başlatmak için Araçlar > Cihaz bağlantı sorunlarını giderme.

Connection Assistant'ta talimatlar, bağlam içi denetimler ve liste Asistan panelinde bir dizi sayfada bulunan bağlı cihaz sayısını gösterir. Sayfalar arasında gerektiği gibi gezinmek için Asistan panelinin alt kısmındaki Sonraki ve Önceki düğmelerini kullanın:

  • Cihazınızı USB üzerinden bağlama: Bağlantı Asistanı ilk olarak istekte bulunur. USB üzerinden bağlamanıza olanak tanır ve USB cihazları yeniden tarama Bu düğmeyi kullanarak bağlı cihazlar için yeni bir tarama başlatabilirsiniz.
  • USB üzerinden hata ayıklamayı etkinleştir: Bağlantı Asistanı, cihaz üzerindeki geliştirici seçeneklerinde USB üzerinden hata ayıklamayı nasıl etkinleştireceğinizi size bildirir.
  • ADB sunucusunu yeniden başlatın: Cihazınızı cihazların listesini görmek için Bağlantı Asistanı'nın son sayfası. ADB sunucusunun yeniden başlatılması da Cihazları tekrar taramak için ADB'ye gidin. Cihazınızı kullanılabilir cihazlar listesinde hâlâ görmüyorsanız aşağıdaki bölümdeki sorun giderme adımlarını deneyin.

USB bağlantısı sorunlarını çözme

Bağlantı Asistanı, cihazınızı USB üzerinden algılamazsa şunları deneyin: sorunu çözmek için aşağıdaki sorun giderme adımlarını uygulayın:

Android Studio'nun Android Emulator'a bağlanıp bağlanmadığını kontrol etme

Sorunun, Android arasındaki bir bağlantı sorunundan kaynaklanıp kaynaklanmadığını kontrol etmek için Studio ve Android Emulator için şu adımları izleyin:

  1. Cihaz Yöneticisi'ni açın.
  2. Henüz yapmadıysanız yeni bir ortalama görüntüleme süresi (AVD) oluşturun bir tanem var.
  3. AVD'nizi kullanarak emülatörü çalıştırın.
  4. Aşağıdakilerden birini yapın:
    • Android Studio emülatöre bağlanamıyorsa en yeni SDK Platformu Araçları yeniden deneyin.
    • Emülatör başarıyla başlatılırsa USB kablosunu aşağıdaki bölümde açıklandığı şekilde kontrol edin.

USB kablosunu kontrol edin

Sorunun hatalı bir USB kablosundan kaynaklanıp kaynaklanmadığını kontrol etmek için şuradaki adımları uygulayın: bu bölümde bulabilirsiniz.

Başka bir USB kablonuz varsa:

  1. İkincil kabloyu kullanarak cihazı bağlayın.
  2. Bağlantı Asistanı'nın artık cihazı algılayıp algılayamadığını kontrol edin.
  3. Cihaz algılanmazsa birincil kabloyu tekrar deneyin.
  4. Cihaz hâlâ algılanmazsa sorunun cihazın ve cihazın geliştirme için ayarlanıp ayarlanmadığını kontrol etme belirtildiği şekilde seçin.

Başka bir USB kablonuz yoksa ancak başka bir Android cihazınız varsa:

  1. İkincil cihazı bilgisayarınıza bağlayın.
  2. Bağlantı Asistanı ikincil cihazı algılayabilirse birincil cihazla ilgili olduğunu ve cihazın geliştirme için ayarlanıp ayarlanmadığını kontrol edin.

    İkincil cihaz algılanmıyorsa sorun USB kablosuyla ilgili olabilir.

Cihazın geliştirme için ayarlanıp ayarlanmadığını kontrol etme

Sorunun cihazdaki ayarlardan kaynaklanıp kaynaklanmadığını kontrol etmek için şu adımları uygulayın: için şu adımları izleyin:

  1. Geliştirme için cihaz ayarlama başlıklı makaledeki adımları uygulayın. bölümüne bakın.
  2. Bu işlem sorunu çözmezse cihazın OEM'iyle iletişime geçin. müşteri destek ekibine ulaşın. Müşteri desteği temsilcisine cihaz ADB kullanarak Android Studio'ya bağlanmadıysa.

Kablosuz bağlantı sorunlarını çözme

Cihazınıza kablosuz olarak bağlanmayla ilgili sorun yaşıyorsanız şunları deneyebilirsiniz: sorunu çözmek için aşağıdaki sorun giderme adımlarını uygulayın:

İş istasyonunuzun ve cihazınızın ön koşulları karşılayıp karşılamadığını kontrol edin

Kablosuz hata ayıklama ön koşullarını karşılamak için şunlardan emin olun:

Diğer bilinen sorunları kontrol etme

Kablosuz hata ayıklama ile ilgili bilinen güncel sorunların bir listesini aşağıda bulabilirsiniz: Android Studio ve bunların çözümü:

  • Kablosuz ağ bağlanmıyor: Şirket kablosuz ağı gibi bazı kablosuz ağlar ağlar, p2p bağlantılarını engelleyebilir ve kablosuz ağ üzerinden bağlanmanıza izin vermeyebilir. Kabloyla veya başka bir kablosuz ağla bağlanmayı deneyin.
  • Kablosuz ağ üzerinden ADB bazen otomatik olarak kapanır: Bu durum, kablosuz ağları değiştirir veya ağ bağlantısını keser.

RSA güvenlik anahtarı

Android 4.2.2 (API düzeyi 17) veya sonraki sürümleri çalıştıran bir cihazı sistemde, RSA anahtarının kabul edilip edilmeyeceğini soran bir iletişim kutusu bu bilgisayar üzerinden hata ayıklamaya olanak tanır. Bu güvenlik mekanizması, kullanıcıyı USB üzerinden hata ayıklama ve diğer adb komutları ve iletişim kutusunu onaylamadığınız sürece yürütülür.