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

  1. Cihazda, Ayarlar uygulamasını açın, Geliştirici seçenekleri'ni seçin ve ardından USB hata ayıklaması'nı (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 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 bu 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 düğmesini kullanabilirsiniz.

      • 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 varsayılan udev kural grubunu içerir. Uzantıyı yüklemek için aşağıdaki komutu kullanın:
      apt-get install android-sdk-platform-tools-common
      

Cihazınıza USB kullanarak bağlayın

Kurulumu gerçekleştirip USB üzerinden taktığınızda, cihazda uygulamanızı oluşturmak ve çalıştırmak için Android Studio'da Çalıştır'ı tıklayın.

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

  • android_sdk/platform-tools/ dizininizden adb devices komutunu çalıştırarak cihazınızın bağlandığını doğrulayın. Bağlandıysa listelenen cihazı 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, Android Debug Bridge (ADB) üzerinden 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ğlamadan ve yaygın USB bağlantısı sorunlarıyla (ör. sürücü yükleme) rekabet etmeden birden fazla uzak cihaza dağıtabilirsiniz.

Kablosuz hata ayıklamayı 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 edinmek için Android sürümünüzü kontrol etme ve güncelleme bölümüne bakın.
  3. Android Studio'nun son sürümünün yüklü olduğundan emin olun. Buradan indirin.
  4. İş istasyonunuzda SDK Platform Araçları'nın en son sürümüne güncelleyin.

Cihazınıza bağlanmak için aşağıdaki adımları izleyin:

  1. Android Studio'yu açın ve yapılandırmalar menüsünden Kablosuz Ağ Kullanan Cihazları Eşleyin'i seçin.
    Yapılandırmaları çalıştır açılır menüsü
    Şekil 1. Yapılandırmaları çalıştır menüsü.

    Cihazları kablosuz ağ üzerinden eşle iletişim kutusu Şekil 2'de gösterildiği gibi görünür.
    Kablosuz bağlantı pop-up penceresi üzerinden cihazları eşle gösteren ekran görüntüsü
    Şekil 2. Cihazları QR kodu veya eşleme kodu kullanarak eşlemeye yarayan iletişim kutusu.
  2. Cihazınızda geliştirici seçeneklerini etkinleştirin.
  3. Cihazınızda kablosuz ağ üzerinden hata ayıklama'yı etkinleştirin.
    Kablosuz hata ayıklama sistemleri ayarını gösteren piksel telefonun ekran görüntüsü.
    Şekil 3. Google Pixel telefonda Kablosuz hata ayıklama ayarı.
  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çip Şekil 2'de gösterilen QR kodunu tarayın.
    2. 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'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 Cihazları kablosuz ağ üzerinden eşle penceresinde göründüğünde cihazınızda gösterilen altı basamaklı kodu girin ve Eşle'yi seçin .
      Eşleme kodu girişi örneğinin ekran görüntüsü
      Şekil 4. Altı haneli eşleme kodu girişi örneği.
  5. Eşleme sonrasında uygulamanızı cihazınıza dağıtmayı deneyebilirsiniz.

Farklı bir cihazı eşlemek veya bu cihazı iş istasyonunuzda 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. Unut'u seçin.

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

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.

Bağlantı Asistanı; talimatlar, bağlam içi kontroller ve bağlı cihazların listesini Asistan panelinde bir dizi sayfada sunar. 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 hata ayıklamasını etkinleştir: Bağlantı Asistanı, 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ı hâlâ kullanılabilir cihazlar listesinde görmüyorsanız Connection Assistant'ın son sayfasındaki Yeniden 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ö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 etme

Sorunun nedeninin Android Studio ile Android Emülatör 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 yoksa yeni bir ortalama görüntüleme süresi oluşturun.
  3. Ortalama görüntüleme sürenizi kullanarak emülatörü çalıştırın.
  4. Aşağıdakilerden birini yapın:
    • Android Studio emülatöre bağlanamıyorsa en yeni 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ığı 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. İ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ığı 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 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, cihazdaki ayarlardan kaynaklanıp kaynaklanmadığını kontrol etmek için şu adımları uygulayın:

  1. Geliştirme için cihaz kurma bölümündeki adımları uygulayın.
  2. Bu işlem sorunu çözmezse yardım için cihazın OEM 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ıklama ön koşullarını karşılamak için şunlardan emin olun:

Bilinen diğer sorunları kontrol edin

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

  • 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 ağ ü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ı

Bilgisayarınıza Android 4.2.2 (API düzeyi 17) veya sonraki sürümleri çalıştıran bir cihazı bağladığınızda sistem, bu bilgisayar üzerinden hata ayıklamaya olanak tanıyan bir 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 hata ayıklaması ve diğer adb komutları yürütülemeyeceği için kullanıcı cihazlarını korur.