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:
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).
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ılanudev
kural grubu. Bu uzantıyı yüklemek için aşağıdaki komutu kullanın:
apt-get install android-sdk-platform-tools-common
- ADB'yi kullanmak isteyen her kullanıcının
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ınandroid_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:
- İş istasyonunuzun ve cihazınızın aynı kablosuz ağa bağlı olduğundan emin olun. ağ.
- 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.
- Android Studio'nun en son sürümünün yüklü olduğundan emin olun. Buradan indirin.
- İş istasyonunuzda SDK Platformu Araçları.
Cihazınıza bağlanmak için şu adımları uygulayın:
- 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 1. Yapılandırmaları çalıştırma açılır.
Şekil 2. Eşleme iletişim kutusu cihazlarda QR kodu veya eşleme kodu kullanılıyor. - Geliştiriciyi etkinleştir seçenekleri cihazınızda.
- Şurada hata ayıklamayı etkinleştir:
Kablosuz ağ
cihazınızda.
Şekil 3. İlgili içeriği oluşturmak için kullanılan Google Pixel'de kablosuz hata ayıklama ayarı dokunun. - Kablosuz hata ayıklama'ya dokunun ve cihazınızı eşleyin:
- 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.
- 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 .
Şekil 4. Altı basamaklı sayı örneği girin.
- 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:
- Cihazınızda Kablosuz hata ayıklama'ya gidin.
- Eşlenen cihazlar bölümünden iş istasyonunuzun adına dokunun.
- 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:
- Cihaz Yöneticisi'ni açın.
- Henüz yapmadıysanız yeni bir ortalama görüntüleme süresi (AVD) oluşturun bir tanem var.
- AVD'nizi kullanarak emülatörü çalıştırın.
- 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:
- İkincil kabloyu kullanarak cihazı bağlayın.
- Bağlantı Asistanı'nın artık cihazı algılayıp algılayamadığını kontrol edin.
- Cihaz algılanmazsa birincil kabloyu tekrar deneyin.
- 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:
- İkincil cihazı bilgisayarınıza bağlayın.
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:
- Geliştirme için cihaz ayarlama başlıklı makaledeki adımları uygulayın. bölümüne ekleyin.
- 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.