Android uygulamanızı kullanıcılara yayınlamadan önce her zaman gerçek bir cihazda test edin. Bu sayfada, Android Debug Bridge (ADB) bağlantısı üzerinden test ve hata ayıklama işlemi yapmak amacıyla geliştirme ortamınızı ve Android cihazınızı nasıl ayarlayacağınız açıklanmaktadır.
Geliştirme için cihaz kurma
Cihazınızda hata ayıklamaya başlamadan önce, cihaza USB kablosuyla mı yoksa kablosuz bağlantıyla mı bağlanmak istediğinize karar verin. Daha sonra, aşağıdakileri yapın:
Cihazda, Ayarlar uygulamasını açın, Geliştirici seçenekleri'ni seçin ve ardından USB üzerinden hata ayıklama'yı (varsa) etkinleştirin.
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 bir USB sürücüsü yükleyin (varsa). Yükleme kılavuzu ve OEM sürücülerinin bağlantıları için OEM USB sürücülerini yükleme başlıklı makaleyi inceleyin.
Ubuntu Linux: Aşağıdakileri ayarlayın:
- ADB'yi kullanmak isteyen her kullanıcı
plugdev
grubunda olmalıdır.plugdev
grubunda olmadığınızı belirten bir hata mesajı görürseniz aşağıdaki komutu kullanarak kendinizi gruba ekleyin:
sudo usermod -aG plugdev $LOGNAME
Gruplar yalnızca giriş yapıldığında güncellenir. Bu nedenle, bu değişikliğin geçerli olması için çıkış yapmanız gerekir. Tekrar giriş yaptığınızda,
plugdev
grubunda olup olmadığınızı kontrol etmek içinid
kullanabilirsiniz.- Sistemde cihazı kapsayan
udev
kural yüklü olmalıdır.android-sdk-platform-tools-common
paketi, Android cihazlar için topluluğun koruduğu varsayılanudev
kural kümesini içerir. 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ı
Cihazınıza USB kullanarak bağlayın
Kurulumu tamamlayıp USB üzerinden taktığınızda, uygulamanızı geliştirip cihazda çalıştırmak için Android Studio'da Çalıştır'ı tıklayın .
Komut vermek için adb
aracını da aşağıdaki gibi kullanabilirsiniz:
android_sdk/platform-tools/
dizininizdenadb devices
komutunu çalıştırarak cihazınızın bağlı olduğunu doğrulayın. Bağlanmışsa cihazı listelenmiş olarak görürsünüz.- Cihazınızı hedeflemek için
-d
işaretiyle herhangi biradb
komutu verin.
Kablosuz ağ kullanarak cihazınıza bağlanın
Android 11 ve sonraki sürümler, Android Debug Bridge (ADB) aracılığıyla uygulamanızı iş istasyonunuzdan kablosuz olarak dağıtmayı ve hata ayıklamayı destekler. Örneğin, hata ayıklaması yapılabilir uygulamanızı, cihazınızı USB ile fiziksel olarak bağlamaya ve sürücü kurulumu gibi yaygın USB bağlantısı sorunlarıyla uğraşmadan uzaktaki birden fazla cihaza dağıtabilirsiniz.
Kablosuz hata ayıklamayı kullanmak için eşleme kodu kullanarak cihazınızı iş istasyonunuzla eşlemeniz gerekir. Başlamak için aşağıdaki adımları uygulayın:
- İş istasyonunuzun ve cihazınızın aynı kablosuz ağa bağlı olduğundan emin olun.
- 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 bölümüne bakın.
- Cihazınızda Android Studio'nun son sürümünün yüklü olduğundan emin olun. Buradan indirin.
- İş istasyonunuzda SDK Platform Araçları'nın en son sürümüne güncelleyin.
Cihazınıza bağlanmak için şu adımları uygulayın:
- Android Studio'yu açın ve yapılandırmalar menüsünden Cihazları Kablosuz Ağ Kullanarak Eşle'yi seçin.
- Cihazınızda geliştirici seçeneklerini etkinleştirin.
- Cihazınızda kablosuz ağ üzerinden hata ayıklama'yı etkinleştirin.
- Kablosuz hata ayıklama'ya dokunun ve cihazınızı eşleyin:
- Cihazınızı bir QR koduyla eşlemek için Cihazı QR koduyla eşle'yi seçip şekil 2'de gösterilen QR kodunu tarayın.
- Cihazınızı bir eşleme koduyla eşlemek için Yeni cihazları kablosuz ağ üzerinden eşle iletişim kutusunda Cihazı eşleme koduyla eşle seçeneğini belirleyin. Cihazınızda Eşleme kodunu kullanarak eşle'yi seçin. Altı haneli bir kod
görüntülenir. Cihazınız Cihazları kablosuz ağ üzerinden eşle penceresinde göründüğünde cihazınızda gösterilen altı haneli kodu girin ve Eşle'yi seçin .
- Eşleme işleminden sonra uygulamanızı cihazınıza dağıtmayı deneyebilirsiniz.
Farklı bir cihazı eşlemek veya bu cihazı iş istasyonunuzda unutmak için:
- Cihazınızda Kablosuz hata ayıklama'ya gidin.
- Eşlenen cihazlar bölümünde iş istasyonu adınıza dokunun.
- Unut'u seçin.
Cihaz yansıtma
Fiziksel cihazınızı Android Studio'daki Çalışan Cihazlar penceresinde yansıtabilirsiniz. Cihazınızın ekranını doğrudan Android Studio'ya aktararak, uygulamaları başlatma, uygulamalarla etkileşimde bulunma, ekranı döndürme, telefonu katlayıp açma ve ses seviyesini değiştirme gibi sık yapılan işlemleri gerçekleştirmek için Studio IDE'nin kendisini kullanabilirsiniz.
Cihaz yansıtma, bilgisayara bağlı, USB veya kablosuz hata ayıklama işlevi etkinleştirilmiş cihazlar olduğunda her zaman kullanılabilir. Yansıtmayı Çalışan Cihazlar penceresini veya Cihaz Yöneticisi'ni (Görünüm > Araç Pencereleri > Cihaz Yöneticisi) kullanarak başlatıp durdurabilirsiniz. Ayrıca, cihaz yansıtmanın ne zaman etkinleştirileceğini ayarlardan özelleştirebilirsiniz (Ayarlar > Araçlar > Cihaz Yansıtma).
Sesi yönlendir
Cihaz yansıtmasını kullanırken bağlı fiziksel cihazlardan gelen sesi bilgisayarınızın hoparlörlerine veya kulaklığınıza yönlendirebilirsiniz. Ses yönlendirmesi sayesinde kulaklığınızı bilgisayarınıza bağlı tutarak hem bilgisayarı hem de bağlı telefonu bir cihaza manuel olarak yeniden bağlamanıza gerek kalmadan dinleyebilirsiniz. Ses yönlendirmeyi etkinleştirmek için Dosya (macOS'te Android Studio) > Ayarlar > Araçlar > Cihaz Yansıtma'ya gidin ve Yerel cihazlardan sesi yönlendir'i seçin. Android 12 veya sonraki sürümleri çalıştıran Firebase Test Lab cihazları için, ayarlardan bağımsız olarak sesin her zaman yönlendirildiğini unutmayın.
Bilinen sorunlar
Bazı cihazlar, cihaz yansıtmasını desteklemek için yeterli bir bit hızında kodlama yapamayabilir. Bu tür durumlarda, Çalışan Cihazlar penceresinde bir hata mesajı ve aşağıdakine benzer günlükler görebilirsiniz.
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ı
Android Studio, cihaz yansıtma ayarlarına bağlı olarak, bağlı ve eşlenmiş tüm cihazlar için cihaz yansıtmasını otomatik olarak başlatabilir. Yansıtma bilgileri ve komutlar, şifrelenmemiş bir kanal üzerinden iletildiğinden bu durum, adb tcpip
komutuyla bağlı cihazlar için bilgilerin açıklanmasına neden olabilir. Buna ek olarak, Android Studio adb sunucusuyla iletişim kurmak için şifrelenmemiş bir kanal kullanır. Bu sayede, ana makinenizdeki diğer kullanıcılar yansıtılan bilgilere müdahale edebilir.
Cihaz bağlantısıyla ilgili sorunları giderme
Cihazınız Android Studio'ya bağlanmıyorsa sorunu çözmek için aşağıdaki adımları deneyin:
Bağlantı Asistanı ile sorun giderme
Connection Assistant, ADB bağlantısı üzerinden bir cihaz kurup kullanmanıza yardımcı olacak adım adım talimatlar sağlar.
Asistanı başlatmak için Araçlar > Cihaz Bağlantı Sorunlarını Giderme'yi seçin.
Connection Assistant, Asistan panelinde yer alan bir dizi sayfada talimatlar, bağlam içi denetimler ve bağlı cihazların bir listesi sağlar. Gerektiğinde sayfalarda çalışmak 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ı önce cihazınızı USB üzerinden bağlamanızı ister ve USB cihazları yeniden tara düğmesi sağlar. Bu düğmeyi kullanarak bağlı cihazlar için yeni bir tarama başlatabilirsiniz.
- USB hata ayıklamasını etkinleştirin: Bağlantı Asistanı, cihaz üzerindeki geliştirici seçeneklerinde USB üzerinden hata ayıklamayı nasıl etkinleştireceğinizi söyler.
- ADB sunucusunu yeniden başlatın: Cihazınızı kullanılabilir cihazlar listesinde hâlâ görmüyorsanız Connection Assistant'ın son sayfasındaki ADB sunucusunu yeniden başlat düğmesini kullanın. ADB sunucusunun yeniden başlatılması, ADB'nin cihazları tekrar taramasına da neden olur. Cihazınızı hâlâ kullanılabilir cihazlar listesinde görmüyorsanız 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 sorunu çözmek için aşağıdaki sorun giderme adımlarını deneyin:
Android Studio'nun Android Emülatör'e bağlanıp bağlanmadığını kontrol etme
Sorunun, Android Studio ile Android Emülatör arasındaki bir bağlantı sorunundan kaynaklanıp kaynaklanmadığını kontrol etmek için şu adımları izleyin:
- Cihaz Yöneticisi'ni açın.
- Henüz yoksa yeni bir ortalama görüntüleme süresi oluşturun.
- Ortalama görüntüleme işleminizi kullanarak emülatörü çalıştırın.
- Aşağıdakilerden birini yapın:
- Android Studio emülatöre bağlanamazsa en son SDK Platform Araçları'nı indirip tekrar deneyin.
- Emülatör başarıyla başlarsa USB kablosunu aşağıdaki bölümde açıklandığı gibi kontrol edin.
USB kablosunu kontrol edin
Sorunun, hatalı bir USB kablosundan kaynaklanıp kaynaklanmadığını kontrol etmek için bu bölümdeki adımları uygulayın.
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 cihazda olduğunu varsayarak aşağıdaki bölümde açıklanan şekilde cihazın geliştirme için ayarlanıp ayarlanmadığını kontrol edin.
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ılayabiliyorsa sorunun birincil cihazda olduğunu varsayarak cihazın geliştirme için ayarlanıp ayarlanmadığını kontrol edin.
İkincil cihaz algılanmazsa sorun USB kablosundan kaynaklanıyor olabilir.
Cihazın geliştirme için ayarlanıp ayarlanmadığını kontrol etme
Sorunun nedeninin cihazdaki ayarlardan olup olmadığını kontrol etmek için şu adımları izleyin:
- Geliştirme için cihaz kurma bölümündeki adımları uygulayın.
- Bu işlem sorunu çözmezse yardım için cihazın OEM müşteri desteğiyle iletişim kurun. Müşteri destek temsilcisine cihazın ADB kullanarak Android Studio'ya bağlanmadığını söyleyin.
Kablosuz bağlantı sorunlarını çözme
Cihazınıza kablosuz olarak bağlanırken sorun yaşıyorsanız sorunu çözmek için aşağıdaki sorun giderme adımlarını deneyebilirsiniz:
İş istasyonunuzun ve cihazınızın ön koşulları karşılayıp karşılamadığını kontrol etme
Kablosuz hata ayıklamanın ö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ıyor. Daha fazla bilgi için Android sürümünüzü kontrol etme ve güncelleme bölümüne bakın.
- Android Studio'nun en son sürümüne sahip olduğunuzdan emin olun. Uygulamayı Android Studio ana sayfasından indirebilirsiniz.
- İş istasyonunuzda SDK Platform Araçları'nın en son sürümüne sahip olmalısınız.
Bilinen diğer sorunları kontrol edin
Aşağıda, Android Studio'da kablosuz hata ayıklama ile ilgili bilinen mevcut sorunların bir listesi ve bunların nasıl çözüleceği açıklanmıştır:
- Kablosuz ağ bağlanmıyor: Kurumsal kablosuz ağlar gibi bazı kablosuz ağlar, p2p bağlantılarını engelleyebilir ve kablosuz ağ üzerinden bağlanmanıza izin vermeyebilir. Kablo veya başka bir kablosuz ağ ile bağlanmayı deneyin.
- Kablosuz üzerinden ADB bazen otomatik olarak kapanır: Bu durum, cihaz kablosuz ağları değiştirirse veya ağla bağlantıyı keserse meydana gelebilir.
RSA güvenlik anahtarı
Android 4.2.2 (API düzeyi 17) veya sonraki sürümleri çalıştıran bir cihazı bilgisayarınıza bağladığınızda sistem, bu bilgisayar üzerinden hata ayıklamaya olanak tanıyan RSA anahtarını kabul edip etmeyeceğinizi soran bir iletişim kutusu gösterir. Bu güvenlik mekanizması, cihazın kilidini açıp iletişim kutusunu onaylamadığınız sürece USB üzerinden hata ayıklama ve diğer adb
komutları yürütülemeyeceği için kullanıcı cihazlarını korur.