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. Daha sonra ş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 daha fazla bilgi için Kontrol ve Android cihazınızı güncelleyin sürümü) tıklayın.
3. Android Studio'nun en son sürümünün yüklü olduğundan emin olun. Buradan indirin.
4. İş istasyonunuzda SDK Platformu Araçları.

Cihazınıza bağlanmak için şu 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ü.

   

   
   
   Şekil 2'de gösterildiği gibi Cihazları kablosuz ağ üzerinden eşle iletişim kutusu görünür.

   

2. Geliştiriciyi etkinleştir seçenekleri cihazınızda.
3. Şurada hata ayıklamayı etkinleştir: Kablosuz ağ cihazınızda.

   

4. Kablosuz hata ayıklama'ya dokunun ve 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 .

      

5. Eşleme işleminden sonra 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).

Sesi yönlendir

Cihaz yansıtma özelliğini 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.

Bilinen sorunlar

Bazı cihazlar, yeterli bit hızında kodlama yapamayabilir. destekler. Bu tür durumlarda, RunningDevices (Çalıştırılan Cihazlar) penceresi ve 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 sorunları 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. Şunu kullanın: Asistan panelinin altındaki Sonraki ve Önceki düğmelerini kullanarak sayfaları gerektiği gibi inceleyin:

• 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: Connection Assistant ardından cihaz üzerindeki geliştirici seçeneklerinden USB hata ayıklamasını etkinleştirin.
• 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ı listede hâlâ görmüyorsanız varsa aşağıdaki bölümde yer alan 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 Emülatör'e bağlanıp bağlanmadığını kontrol edin

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ılanmazsa sorun USB'de olabilir kabloyla.

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 ekleyin.
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:

• İş istasyonunuz ve cihazınız aynı kablosuz ağa bağlı.
• Cihazınız Android 11 veya sonraki bir sürümü çalıştırıyordur. Daha fazla bilgi için bkz. Kontrol et ve Android cihazınızı güncelleyin sürümü) tıklayın.
• Android Studio'nun en son sürümüne sahip olduğunuzdan emin olun. Şunları indirebilirsiniz: Android Studio ana sayfasından devre dışı bırakabilirsiniz.
• Şu uygulamanın en son sürümüne sahip: İş istasyonunuzdaki SDK Platform Araçları.

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. Kablo 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.