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 kurallarının yüklü olması gerekir. android-sdk-platform-tools-common paketi, Android cihazlar için topluluk tarafından yönetilen varsayılan bir udev kuralı grubu içerir. Yüklemek için aşağıdaki komutu kullanın:
      apt-get install android-sdk-platform-tools-common

USB kullanarak cihazınıza bağlanma

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ızda Android 11 veya sonraki bir sürümün yüklü olduğundan 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ü yüklediğinizden emin olun. Buradan indirin.
  4. İş istasyonunuzda SDK Platform Araçları'nı en son sürüme 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.
    Çalıştırma yapılandırmaları açılır menüsü
    Şekil 1. Yapılandırmaları çalıştır menüsüne gidin.

    Şekil 2'de gösterildiği gibi Kablosuz ağ üzerinden cihaz eşleme iletişim kutusu görünür.
    Kablosuz ağ üzerinden cihaz eşleme pop-up penceresinin ekran görüntüsü
    Şekil 2. QR kodu veya eşleme kodunu kullanarak cihazları eşlemek için iletişim kutusu.
  2. Cihazınızda geliştirici seçeneklerini etkinleştirin.
  3. Cihazınızda Kablosuz üzerinden hata ayıklamayı etkinleştirin.
    Kablosuz hata ayıklama sistem ayarını gösteren bir Pixel telefonun ekran görüntüsü.
    Şekil 3. Google Pixel telefondaki Kablosuz hata ayıklama ayarı.
  4. Kablosuz hata ayıklama'ya dokunup cihazınızı eşleyin:
    1. Cihazınızı 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 .
      Örnek eşleme kodu girişinin ekran görüntüsü
      Şekil 4. Altı basamaklı eşleme kodu girişi örneği.
  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ünde 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.

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

Çalışan Cihazlar kullanıcı arayüzü

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 cihazlardan gelen sesi 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ı desteklemek için yeterli bit hızında kodlama yapamaz. 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ği için 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 sorun 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ıları 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ı, ADB'nin cihazları tekrar taramasına da 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ı giderme

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ş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:

  1. Cihazı ikincil kabloyu kullanarak 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ılanmıyorsa sorunun cihazdan kaynaklandığını varsayın ve aşağıdaki bölümde açıklandığı gibi 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. Cihazın ADB kullanarak Android Studio'ya bağlanmadığını müşteri desteği temsilcisine bildirin.

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:

Bilinen diğer sorunları kontrol etme

Android Studio'da kablosuz hata ayıklamayla ilgili bilinen sorunların listesi ve bunların nasıl çözüleceği aşağıda verilmiştir:

  • 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 üzerinden ADB bazen otomatik olarak kapanır: Bu durum, cihaz kablosuz ağları değiştirirse veya ağ bağlantısını keserse 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ı, USB hata ayıklama ve diğer adb komutları cihazın kilidini açmadan ve iletişim kutusunu onaylamadan çalıştırılamaması nedeniyle kullanıcı cihazlarını korur.