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

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çin geliştirme ortamınızı ve Android cihazınızı nasıl ayarlayacağınız açıklanmaktadır.

Geliştirme için cihaz kurulumu

Cihazınızda hata ayıklamaya başlamadan önce, cihaza USB kablosuyla mı yoksa kablosuz ağ üzerinden mi bağlanmak istediğinize karar verin. Daha sonra şunları yapın:

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

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). Yükleme kılavuzu ve OEM sürücülerinin bağlantıları için OEM USB sürücülerini yükleme bölümüne bakın.

   • Ubuntu Linux: Aşağıdakileri kurun:

     • 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 çıkış yapmanız gerekir. Tekrar giriş yaptığınızda, plugdev grubunda olup olmadığınızı kontrol etmek için id adresini kullanabilirsiniz.

     • Sistemde, cihazı kapsayan udev kuralları 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. 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

Kurulumunuzu yapıp USB üzerinden fişe taktığınızda, Android Studio'da Çalıştır'ı tıklayarak cihazda uygulamanızı oluşturup çalıştırın.

Komut vermek için adb aracını da aşağıdaki şekilde kullanabilirsiniz:

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

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

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

Kablosuz hata ayıklama özelliğini kullanmak için bir eşleme kodu kullanarak cihazınızı 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 bölümüne bakın.
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 şu adımları uygulayın:

1. Android Studio'yu açın ve çalıştırma yapılandırmaları menüsünden Kablosuz Ağı Kullanarak Cihazları Eşle'yi seçin.

   

   
   
   Şekil 2'de gösterildiği gibi Cihazları kablosuz ağ üzerinden eşle 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 dokunun ve 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ı bir eşleme koduyla eşlemek için Kablosuz ağ üzerinden yeni cihazları eşle iletişim kutusundan Cihazı eşleme koduyla eşle'yi seçin. Cihazınızda Eşleme kodunu kullanarak eşle'yi seçin. Altı basamaklı bir kod görünür. Cihazınız Kablosuz ağ üzerinden cihaz eşle penceresinde göründüğünde, cihazınızda gösterilen altı haneli kodu girin 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 Studio'daki Çalışan Cihazlar penceresinden yansıtabilirsiniz. Cihazınızın ekranını doğrudan Android Studio'ya aktararak Studio IDE'sini kullanarak uygulamaları başlatma ve uygulamalarla etkileşimde bulunma, ekranı döndürme, telefonu katlayıp açma ve ses seviyesini değiştirme gibi yaygın işlemleri gerçekleştirebilirsiniz.

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). Ayrıca cihaz yansıtmanın ne zaman etkinleştirileceğini cihazın ayarlarından özelleştirebilirsiniz (Ayarlar > Araçlar > Cihaz Yansıtma).

Sesi yönlendir

Cihaz yansıtma özelliğini kullanırken bağlı fiziksel cihazlardan gelen sesi bilgisayarınızın hoparlörlerine veya kulaklığınıza yönlendirebilirsiniz. Ses yönlendirme özelliğini kullanarak kulaklığınızı bilgisayarınıza bağlı tutun ve bir cihaza daha sonra 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 cihazlardan sesi yönlendir'i seçin. Sesin, ayarlardan bağımsız olarak Android 12 veya sonraki sürümleri çalıştıran Firebase Test Lab cihazlarında her zaman yönlendirildiğini unutmayın.

Bilinen sorunlar

Bazı cihazlar, cihaz yansıtmayı desteklemeye yetecek kadar bit hızında kodlama yapamayabilir. Bu tür durumlarda, Çalışan Cihazlar penceresinde hatanın yanı sıra aşağıdakine benzer günlükler de 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ı

Cihaz yansıtma ayarlarına bağlı olarak Android Studio, bağlı ve eşlenmiş tüm cihazlar için cihaz yansıtmayı otomatik olarak başlatabilir. Yansıtılan bilgiler ve komutlar şifrelenmemiş bir kanal üzerinden geçirildiğinden bu durum, adb tcpip komutuna bağlı cihazlar için bilgilerin ifşa edilmesine neden olabilir. Ayrıca, Android Studio adb sunucusuyla iletişim kurmak için şifrelenmemiş bir kanal kullanır. Böylece, yansıtılan bilgiler ana makinenizdeki diğer kullanıcılar tarafından ele geçirilebilir.

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ı Yardımcısı, ADB bağlantısı üzerinden bir cihaz kurup kullanmanıza yardımcı olacak adım adım talimatlar sunar.

Asistanı başlatmak için Araçlar > Cihaz Bağlantı Sorunlarını Giderme'yi seçin.

Bağlantı Asistanı; talimatlar, bağlam içi denetimler ve Asistan panelindeki bir dizi sayfada bağlı cihazların listesini sağlar. Gerektiğinde sayfalar üzerinde ç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 bağlı cihazlar için yeni bir tarama başlatabileceğiniz USB cihazları yeniden tara düğmesi sağlar.
• USB üzerinden hata ayıklamayı etkinleştirme: Bağlantı Asistanı daha sonra cihaz üzerinde geliştirici seçeneklerinde USB üzerinden hata ayıklamayı nasıl etkinleştireceğinizi gösterir.
• ADB sunucusunu yeniden başlatın: Cihazınızı kullanılabilir cihazlar listesinde hâlâ 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öremiyorsanı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 edin

Sorunun nedeninin Android Studio ile Android Emulator arasındaki bir bağlantı sorunu olup olmadığını kontrol etmek için aşağıdaki adımları uygulayın:

1. Cihaz Yöneticisi'ni açın.
2. Henüz edinmediyseniz 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 Platformu 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ılanmazsa 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ılanmazsa sorun USB kablosunda 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. Sorununuz çözülmediyse yardım almak için cihazın OEM'inin 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ğlanma konusunda 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ı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 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ü bulunmalıdır.

Diğer bilinen 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, 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, cihazın kablosuz ağlar arasında geçiş yapması veya ağ ile bağlantısının kesilmesi durumunda gerçekleşebilir.

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 izin veren bir RSA anahtarının kabul edilip edilmeyeceğini soran bir iletişim kutusu gösterir. 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 bu güvenlik mekanizması kullanıcı cihazlarını korur.