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

Android uygulamanızı kullanıcılara sunmadan önce daima gerçek bir cihazda test edin. Bu sayfada, Android Debug Bridge (ADB) bağlantısı üzerinden test ve hata ayıklama için geliştirme ortamınızın ve Android cihazınızın nasıl ayarlanacağı açıklanmaktadır.

Geliştirme için cihaz kurma

Cihazınızda hata ayıklama işlemine başlamadan önce, cihaza USB kablosuyla mı yoksa kablosuz ağ üzerinden mi bağlanacağınıza karar verin. Ardından şunları yapın:

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

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 bir USB sürücüsü yükleyin (varsa). Kurulum kılavuzu ve OEM sürücü 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ının plugdev grubunda olması gerekir. 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 oturumunuzu kapatmanız gerekir. Tekrar giriş yaptığınızda id'ü kullanarak plugdev grubunda olduğunuzu kontrol edebilirsiniz.

     • Sistemde, cihazı kapsayan udev kuralı yüklü olmalıdır. android-sdk-platform-tools-common paketi, Android cihazlar için topluluk tarafından yönetilen udev kural grubunu içerir. 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 tamamlayıp USB üzerinden bağladığınızda, Android Studio'da uygulamanızı derleyip çalıştırmak için Çalıştır'ı tıklayın.

Komut vermek için adb simgesini de kullanabilirsiniz.

• android_sdk/platform-tools/ dizininizden adb devices komutunu çalıştırarak cihazınızın bağlı olduğunu doğrulayın. Cihaz bağlıysa listede gösterilir.
• Cihazınızı hedeflemek için -d işaretiyle herhangi bir adb komutu verin.

Kablosuz bağlantı kullanarak cihazınıza bağlanma

Android 11 ve sonraki sürümler, Android Debug Bridge (ADB) aracılığıyla uygulamanızı iş istasyonunuzdan kablosuz olarak dağıtmayı ve uygulamanızda hata ayıklamayı destekler. Örneğin, hata ayıklama yapılabilir uygulamanızı USB üzerinden fiziksel olarak bağlamadan ve sürücü yükleme gibi yaygın USB bağlantı sorunlarıyla uğraşmadan birden fazla uzak cihaza dağıtabilirsiniz.

Kablosuz hata ayıklama özelliğini kullanmak için cihazınızı bir eşleme kodu kullanarak iş istasyonunuzla eşlemeniz gerekir. 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.
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ün yüklü olduğundan emin olun. Buradan indirin.
4. İş istasyonunuzda, SDK Platform Araçları'nı en son sürümüne 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 yapılandırmaları menüsünden Kablosuz Ağı Kullanarak Cihaz Eşleme'yi seçin.

   

   
   
   Şekil 2'de gösterildiği gibi Kablosuz ağ üzerinden cihaz eşleme iletişim kutusu görünür.

   

2. Cihazınızda geliştirici seçeneklerini etkinleştirin.
3. Cihazınızda kablosuz ağ üzerinden hata ayıklama özelliğini etkinleştirin.

   

4. Kablosuz hata ayıklama'ya dokunup cihazınızı eşleyin:
   1. Cihazınızı bir QR koduyla eşlemek için Cihazı QR koduyla eşle'yi seçin ve şekil 2'de gösterilen QR kodunu tarayın.
   2. Cihazınızı eşleme koduyla eşlemek için Yeni cihazları kablosuz ağ üzerinden eşle iletişim kutusunda Eşleme kodu ile cihaz eşle'yi seçin. Cihazınızda Eşleme kodunu kullanarak eşle'yi seçin. Altı haneli bir kod görünür. 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 .

      

5. Eşlemeden 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. Unutma'yı seçin.

Cihaz yansıtma

Fiziksel cihazınızı Android Studio'daki Çalışmakta Olan Cihazlar penceresinde yansıtabilirsiniz. Cihazınızın ekranını doğrudan Android Studio'ya aktararak uygulamaları başlatma ve onlarla etkileşim kurma, ekranı döndürme, telefonu katlama ve açma, sesi değiştirme gibi yaygın işlemleri gerçekleştirmek için Studio IDE'yi kullanabilirsiniz.

Cihaz yansıtma, USB veya kablosuz hata ayıklamanın etkin olduğu bilgisayara bağlı cihazlar olduğunda her zaman kullanılabilir. Yansıtmayı Çalışan Cihazlar penceresini veya Cihaz Yöneticisi'ni kullanarak başlatabilir ve durdurabilirsiniz (Görünüm > Araç Penceresi > Cihaz Yöneticisi). Cihaz yansıtmanın ne zaman etkinleştirileceğini ayarlarından da (Ayarlar > Araçlar > Cihaz Yansıtma) özelleştirebilirsiniz.

Ses yönlendirme

Cihaz yansıtma özelliğini kullanırken bağlı fiziksel cihazlardan gelen sesi bilgisayar hoparlörlerinize veya kulaklığınıza yönlendirebilirsiniz. Ses yönlendirme özelliğiyle kulaklığınızı bilgisayarınıza bağlı tutun ve bir cihaza, ardından diğerine manuel olarak yeniden bağlanmak zorunda kalmadan hem bilgisayarı hem de bağlı telefonu dinleyin. Ses yönlendirmeyi etkinleştirmek için Dosya (macOS'te Android Studio) > Ayarlar > Araçlar > Cihaz Yansıtma'ya gidin ve Yerel cihazlardaki sesleri yönlendir'i seçin. Android 12 veya sonraki sürümleri çalıştıran Firebase Test Lab cihazlarında, ayarlardan bağımsız olarak sesin her zaman yönlendirildiğini unutmayın.

Bilinen sorunlar

Bazı cihazlar, cihaz yansıtmayı desteklemeye yetecek kadar bit hızında kodlama yapamayabilir. Bu durumlarda, Çalışır Cihazlar penceresinde bir hata görebilir ve aşağıdakine benzer günlükler alabilirsiniz.

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 cihazlarda cihaz yansıtmayı otomatik olarak başlatabilir. Yansıtma bilgileri ve komutları şifrelenmemiş bir kanal üzerinden iletildiğinden bu durum, adb tcpip komutuyla bağlı cihazlarda bilginin açığa çıkmasına neden olabilir. Ayrıca Android Studio, adb sunucusuyla iletişim kurmak için şifrelenmemiş bir kanal kullanır. Bu nedenle, yansıtma bilgileri ana makinenizdeki diğer kullanıcılar tarafından yakalanabilir.

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

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

Bağlantı Asistanı ile sorunları giderme

Bağlantı Asistanı, bir cihazı ADB bağlantısı üzerinden kurmanıza ve 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.

Bağlantı Asistanı, Asistan panelindeki bir dizi sayfada talimatlar, bağlam içi kontroller ve bağlı cihazların listesini sağlar. 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ğlayın: Bağlantı Asistanı, önce cihazınızı USB üzerinden bağlamanızı ister ve bağlı cihazlar için yeni bir tarama başlatabileceğiniz bir USB cihazlarını yeniden tara düğmesi sağlar.
• 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ı hâlâ kullanılabilir cihazlar listesinde görmüyorsanız Bağlantı Asistanı'nın son sayfasındaki ADB sunucusunu yeniden başlat düğmesini kullanın. ADB sunucusunun yeniden başlatılması da ADB'nin cihazları tekrar taramasına neden olur. 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ılamıyorsa sorunu çözmek için aşağıdaki sorun giderme adımlarını deneyin:

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

Sorunun Android Studio ile Android Emulator arasındaki bir bağlantı sorunundan kaynaklanıp kaynaklanmadığını kontrol etmek için aşağıdaki adımları uygulayın:

1. Cihaz Yöneticisi'ni açın.
2. Henüz yoksa yeni bir AVD oluşturun.
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 son SDK Platform Araçları'nı indirip tekrar 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 bu bölümdeki adımları uygulayın.

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ılanmıyorsa birincil kabloyu tekrar deneyin.
4. Cihaz hâlâ algılanmazsa sorunun cihazda olduğunu varsayın ve aşağıdaki bölümde açıklandığı ş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:

1. İkincil cihazı bilgisayarınıza bağlayın.

2. Bağlantı Asistanı ikincil cihazı algılayabiliyorsa sorunun birincil cihazda olduğunu varsayın 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 aşağıdaki adımları uygulayın:

1. Geliştirme için cihaz ayarlama bölümündeki adımları uygulayın.
2. Bu işlem sorunu çözmüyorsa yardım için cihazın OEM'sinin müşteri desteğiyle iletişime geçin. Müşteri desteği 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 edin

Kablosuz hata ayıklamayla ilgili ön koşulları karşılamak için aşağıdakilerden emin olun:

• İş istasyonunuz ve cihazınız aynı kablosuz ağa bağlı olmalıdır.
• Cihazınızda Android 11 veya sonraki bir sürüm yüklü olmalıdır. Daha fazla bilgi için Android sürümünüzü kontrol etme ve güncelleme başlıklı makaleyi inceleyin.
• Android Studio'nun en son sürümüne sahip olduğunuzdan emin olun. Ana Android Studio sayfasından indirebilirsiniz.
• İş istasyonunuzda SDK Platform Araçları'nın en son sürümü bulunmalıdır.

Bilinen diğer sorunları kontrol etme

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, eşler arası bağlantıları 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, cihazın kablosuz ağlar arasında geçiş yapması veya ağ ile bağlantısının kesilmesi halinde ortaya çıkabilir.

RSA güvenlik anahtarı

Android 4.2.2 (API düzeyi 17) veya sonraki bir sürümü çalıştıran bir cihazı bilgisayarınıza bağladığınızda sistem, bu bilgisayar üzerinden hata ayıklama yapılmasına olanak tanıyan bir RSA anahtarının kabul edilip edilmeyeceğini soran bir iletişim kutusu gösterir. Bu güvenlik mekanizması, cihazın kilidini açamaz ve iletişim kutusunu onaylamazsanız USB hata ayıklama ve diğer adb komutları yürütülemediği için kullanıcı cihazlarını korur.