Android girişi

Kullanıcı arayüzü öğelerinde hareketler ve önemli etkinlikler gerçekleştirerek Android uygulamalarıyla etkileşim kurma

Kullanım

android input [-h] [--device=PARAM]

Seçenekler

  • --device=PARAM - Cihaz seri numarası veya emülatör kimliği ("adb devices" tarafından bildirildiği şekilde).
  • -h,--help: Belirtilen komutla ilgili yardım mesajını gösterir.

android seçenekleri:

  • --sdk=PARAM: Android SDK'sının yolu.
  • -v,--verbose: Sorun giderme için ayrıntılı çıkışı etkinleştirir.
  • -V,--version - Sürüm bilgilerini yazdırıp çıkın.

Alt komutlar

  • key - Bir donanım düğmesine, gezinme tuşuna veya Android tuş koduna basın.
  • scroll: Bir kapsayıcı öğeyi, isteğe bağlı olarak hedef öğe görünene kadar kaydırın.
  • swipe: Belirli bir yönde seçiciyle eşleşen kullanıcı arayüzü öğesinden kaydırın.
  • tap: Seçiciyle eşleşen bir kullanıcı arayüzü öğesine dokunun.
  • text: Bir seçiciyle eşleşen kullanıcı arayüzü öğesine metin yazın.

Açıklama

android input, bağlı bir Android cihazda veya emülatörde kullanıcı etkileşimlerini ve donanım girişlerini gerçekleştirir.

Yapay zeka ajanları ve test komut dosyaları, kullanıcı arayüzü öğelerini keşfetmek ve hareketler ya da tuş vuruşları kullanarak bunlarla etkileşim kurmak için android input ile birlikte android layout veya android screen kullanabilir.

Kullanıcı arayüzü öğesi seçiciler

Çoğu input alt komutu, seçici ifadesi kullanarak kullanıcı arayüzü öğelerini hedefler. Seçici, hedef öğenin karşılaması gereken özellikleri belirten, virgülle ayrılmış key=value veya key:value çiftleri listesidir. Boşlukların, virgüllerin veya özel karakterlerin kabuk tarafından yorumlanmasını önlemek için seçicileri tek tırnak içine alın.

Seçiciler, uygulamanın canlı erişilebilirlik düğümü hiyerarşisiyle eşleşir:

  • Dize özellikleri: Varsayılan olarak büyük/küçük harfe duyarlı olmayan alt dizeler olarak eşleştirilir (örneğin, text=submit, "Siparişi gönder" ile eşleşir). Bu özellik için boş olmayan bir değere sahip herhangi bir öğeyle eşleştirmek üzere * değerini iletin. Değerin herhangi bir bölümüyle eşleşebilen, büyük/küçük harfe duyarlı bir normal ifade olarak eşleştirmek için değeri eğik çizgi içine alın (ör. text=/^Submit$/). Büyük/küçük harfe duyarlı olmayan bir normal ifade için kapanış eğik çizgisinden sonra i işaretini ekleyin (ör. text=/^submit$/i). Normal ifade içindeki virgüller seçiciyi bölmez. / ile başlayan düz metinle eşleştirmek için text=/^\/help/ gibi bir normal ifade kullanın.
    • text (eş anlamlısı: txt): Öğe üzerinde gösterilen görünür metin.
    • id (eş anlamlı: res): Görüntüleme kaynağı kimlik adı (ör. id=submit_button veya tam kaynak adı com.example.app:id/submit_button).
    • class (eş anlamlılar: clazz, cls, clz): Öğe sınıfı adı veya basit sınıf adı (ör. class=Button veya android.widget.Button).
    • desc (eş anlamlı: content): Erişilebilirlik içerik açıklaması.
  • Etkileşim özellikleri: Boole değerleri (true veya false) olarak eşleştirilir.
    • clickable (eş anlamlısı: click): Öğenin tıklanabilir olup olmadığı.
    • checkable: Öğenin işaretlenip işaretlenemeyeceği veya açılıp kapatılamayacağı.
    • scrollable (eş anlamlısı: scroll): Öğenin kaydırılabilir bir kapsayıcı olup olmadığı.
    • focusable: Öğeye odaklanılıp odaklanılamayacağı.
    • longclickable (eş anlamlısı: longclick): Öğenin uzun tıklamaları destekleyip desteklemediği.
  • Durum özellikleri: Boole değerleri (true veya false) olarak eşleştirilir.
    • checked: Öğenin şu anda işaretli olup olmadığı.
    • focused: Öğeye odaklanılıp odaklanılmadığı.
    • selected: Öğenin şu anda seçili olup olmadığı.

Eşleşme davranışı (--match)

Bir seçici, ekrandaki birden fazla öğeyle eşleştiğinde:

  • --match=single (varsayılan): Bir hatayla başarısız olur ve eşleşen tüm öğeleri listeler. Böylece etkileşimlerin yanlış kullanıcı arayüzü bileşenini tetiklemediğinden emin olunur.
  • --match=first: Kullanıcı arayüzü hiyerarşisinde karşılaşılan ilk eşleşen öğeyle etkileşim kurar.

Kullanılabilir hareketler ve komutlar

  • tap <target>: Hedeflenen öğenin ortasını tıklar.
  • text <string> <target>: Mevcut metni temizler ve hedeflenen öğeye <string> yazar. Yazdıktan sonra Enter/Tamam tuş etkinliği göndermek için --submit değerini iletin.
  • scroll <target>: Bir kapsayıcı öğeyi belirtilen yönde (--dir=up|down|left|right) kaydırır. Eşleşen bir öğe görünene kadar kaydırmaya devam etmek için --until=<selector> kullanın.
  • swipe <target>: <target> noktasından başlayarak bir yönde (--dir=up|down|left|right) kaydırma hareketi gerçekleştirir. İsteğe bağlı olarak --distance (ekranın kesri) ve --speed (saniyedeki piksel sayısı) parametreleri kullanılabilir.
  • key <key>: Bir donanım düğmesi veya tuş etkinliği (ör. back, home, recents, power, volume-up, volume-down, enter, tab, esc veya tam sayı Android tuş kodu) gönderir. --shift, --alt ve --ctrl değiştirici işaretlerini destekler.

Hedef cihaz belirtin (--device)

Birden fazla cihaz veya emülatör bağlıysa giriş etkinliklerini belirli bir cihaza yönlendirmek için --device=<serial-number> (adb devices tarafından bildirildiği şekilde) parametresini iletin.

Örnekler

Görünür metnine göre bir düğmeye dokunma:

android input tap 'text=Submit'

Birden fazla özellikle eşleşen bir öğeye dokunun:

android input tap 'id=submit_btn,class=Button,clickable=true'

Birden fazla eşleşme olduğunda eşleşen ilk öğeye dokunma:

android input tap --match=first 'class=android.widget.TextView'

Giriş alanına metin yazıp gönderme:

android input text 'user@example.com' 'id=email_input' --submit

Bir öğe görünene kadar kapsayıcıyı aşağı kaydırma:

android input scroll 'id=recycler_view' --dir=down --until='text=Settings'

Kart öğesini sola kaydırın:

android input swipe 'id=card_view' --dir=left

Cihazın geri düğmesine basın:

android input key back