ADB / Android Debug Bridge
Macro Deck ile birlikte gelirBir Android telefonu veya tableti USB ya da Wi-Fi üzerinden kontrol edin: uyandırın, uygulama başlatın, dokunun, yazın ve ekran görüntüsü alın.
ADB / Android Debug Bridge entegrasyonunun Genel bakış sekmesi ve ADB’yi Ayarlar’da açma bildirimi
- Bağlı bir Android cihazı uyandırın, kilitleyin ve yeniden başlatın
- Cihazda uygulamaları başlatın veya zorla durdurun ve bağlantılar açın
- Tuş, dokunma, kaydırma ve metin gönderin
- Cihaz ekranının görüntülerini bir klasöre kaydedin
- Pil, ekran ve ön plandaki uygulama için cihaz olayları ve değişkenleri
ADB entegrasyonu, Android telefonları ve tabletleri Android geliştiricilerinin de kullandığı araç olan Android Debug Bridge (ADB) üzerinden kontrol eder. Macro Deck adb programını bulur, ADB sunucusunu çalıştırır ve USB ile takılı ya da Wi-Fi üzerinden bağlı cihazları takip eder. Resmî Android platform-tools paketini sizin için indirebilir de.
Her eylem, eylemde seçtiğiniz cihazda veya Aygıt alanını boş bıraktığınızda varsayılan cihazda çalışır. Varsayılan cihaz, Ayarlar > ADB bölümünde Varsayılan yap ile seçtiğiniz cihazdır; hiçbirini seçmediyseniz takılı olan tek cihazdır.
Neler yapabilirsiniz
- Ekran ve güç: cihazı uyandırın, ekranı kapatın (Android cihazı bu şekilde kilitler) veya cihazı Android’e, kurtarma moduna ya da bootloader’a yeniden başlatın.
- Uygulamalar ve bağlantılar: bir uygulamayı
com.spotify.musicgibi paket adıyla başlatın veya zorla durdurun ve bir bağlantıyı cihazın bunun için seçtiği uygulamayla açın. - Giriş: Home, Back, Volume Up veya Media Play Pause gibi bir tuş gönderin, ekranda bir noktaya dokunun, bir noktadan diğerine kaydırın veya odaktaki alana metin yazın.
- Ekran görüntüleri: ekranı bilgisayarınızdaki bir klasöre PNG dosyası olarak kaydedin ve isterseniz dosyanın yolunu bir değişkene yazın.
Bazı örnek kurulumlar:
- Masanızdaki bir tableti uyandırıp müzik uygulamanızı başlatan bir düğme.
- Telefonunuza Media Play Pause gönderen bir düğme.
- Bir tableti taktığınız anda üzerinde bir pano sayfası açan, Aygıt bağlandı olayına bağlı bir otomasyon.
Canlı durum
Entegrasyon bir cihaz bağlandığında, bağlantısı kesildiğinde, yetkilendirildiğinde, yetkisi kaldırıldığında, çevrimdışı olduğunda veya yeniden çevrimiçi olduğunda bunu bildirir; böylece akışlar ve düğmeler buna tepki verebilir. Değişkenler bağlı ve yetkilendirilmiş cihaz sayısını, varsayılan cihaz için de modelini, üreticisini, pil seviyesini, ekranın açık olup olmadığını, kilit ekranının görünüp görünmediğini ve önde hangi uygulamanın olduğunu tutar. Yetkilendirilmiş her cihaz, modelinin adını taşıyan kendi değişkenlerini de alır. Entegrasyon açıkken her Android cihazın pili Pil widget’ında da görünür.
Temel eylemler (tuşlar, dokunmalar, kaydırmalar, metin, uygulamalar, bağlantılar, yeniden başlatmalar ve ekran görüntüleri) Macro Deck kilitliyken de çalışmaya devam eder; böylece bunlardan birine bağlı bir düğme kilitli bir bilgisayarda da çalışır.
Gerekenler
- Windows, macOS veya Linux üzerinde Macro Deck 3
- Geliştirici seçeneklerinde USB hata ayıklama açık olan bir Android cihaz
- Veri aktarabilen bir USB kablosu veya Wi-Fi üzerinden bağlantı için kablosuz hata ayıklama
- Android platform-tools (adb); Macro Deck bunları Ayarlar > ADB bölümünden indirebilir
- Linux’ta kullanıcınızın USB cihazına erişim izni, genellikle bir udev kuralı ile
Kurulum
Adım 1: ADB entegrasyonunu açın
Kenar çubuğunda Entegrasyonlar’a ve ardından ADB / Android Debug Bridge’e tıklayın. Sağ üstteki anahtarı açana kadar entegrasyon kapalıdır. Açıldıktan sonra, bir sonraki adımda ADB’yi açana kadar sayfada ADB kapalı görünür.
Adım 2: Macro Deck’te ADB’yi etkinleştirin
Ayarlar > ADB bölümünü açın ve ADB'yi etkinleştir seçeneğini açın. ADB programı Bulunamadı gösteriyorsa platform-tools indir düğmesine tıklayın. Mevcut bir Android SDK veya
PATHiçindeki biradbotomatik olarak bulunur; Çalıştırılabilir dosya yolu ile başka birini gösterebilirsiniz.Adım 3: Cihazda USB hata ayıklamayı açın
Telefonda veya tablette Ayarlar > Telefon hakkında bölümünü açın ve Geliştirici seçenekleri’ni açmak için Derleme numarası’na yedi kez dokunun. Ardından Ayarlar > Geliştirici seçenekleri bölümünde USB hata ayıklama’yı açın. Tam konum üreticiye göre biraz farklılık gösterir.
Adım 4: Cihazı bağlayın ve yetkilendirin
Cihazı bir USB kablosuyla bağlayın ve ekranındaki USB hata ayıklamaya izin verilsin mi? sorusunu onaylayın. Tekrar sormaması için Bu bilgisayardan her zaman izin ver seçeneğini işaretleyin. Cihaz ardından Ayarlar > ADB içindeki Aygıtlar altında Hazır olarak görünür. Bunun yerine Wi-Fi üzerinden bağlanmak için Kablosuz ağ üzerinden bağlan altına cihazın IP adresini ve bağlantı noktasını girin, örneğin
192.168.1.20:5555.Adım 5: Varsayılan bir cihaz seçin
Birden fazla cihaz takılıysa, Aygıt alanını boş bıraktığınızda eylemlerinizin kullanacağı cihazın yanındaki Varsayılan yap düğmesine tıklayın. Tek bir cihaz varsa otomatik olarak o kullanılır.
Adım 6: Bir düğmeye ADB eylemi ekleyin
Deck sayfasında deck’in kilidinin açık olduğundan emin olun (sağ üstteki düğmede Kilitle yazar) ve bir düğmeye tıklayın. Düzenleyici Kısa basma seçili olarak açılır. + Eylem ekle’ye tıklayın, Eylem ekle iletişim kutusunun solunda ADB / Android Debug Bridge’i seçin ve bir eylem seçin, örneğin Aygıtı uyandır veya Uygulamayı başlat. Uygulamayı başlat için Paket gibi alanlarını doldurun ve varsayılan cihazı kullanmak için Aygıt alanını boş bırakın. Kategori yalnızca entegrasyon açıkken görünür.
Adım 7: Düğmeye basın
Kaydet’e tıklayın ve deck’inizdeki düğmeye basın. Hiçbir şey olmazsa Entegrasyonlar bölümünde Bağlı aygıt yok gibi bir bildirim veya yetkilendirilmesi gereken bir cihaz olup olmadığını kontrol edin.
Eylemler11
Bunları bir düğmeye yerleştirin veya bir akıştan çalıştırın.
- Aygıtı uyandır
- Cihazın ekranını uyandırır.
- Uyut / Ekranı kilitle
- Cihazın ekranını kapatır; Android bir cihazı bu şekilde kilitler.
- Uygulamayı başlat
- Bir uygulamayı paket adıyla başlatır veya öne getirir.
- Uygulamayı zorla durdur
- Bir uygulamayı paket adıyla zorla durdurur.
- Bağlantı aç
- Cihazda bir URI açar; bir bağlantıya dokunmakla aynıdır.
- Metin yaz
- Cihazda o anda odaktaki alana metin yazar.
- Tuş gönder
- Home, Back, Volume Up veya Media Next gibi tek bir Android tuş olayı gönderir.
- Dokun
- Ekrana verilen X ve Y koordinatlarında dokunur.
- Kaydır
- Ekranı belirli bir süre içinde bir noktadan diğerine kaydırır.
- Aygıtı yeniden başlat
- Cihazı Normal, Kurtarma veya Bootloader modunda yeniden başlatır.
- Ekran görüntüsü al
- Cihaz ekranını yakalar ve bir klasöre PNG dosyası olarak kaydeder; isterseniz yolunu bir değişkene yazar.
Tetikleyiciler6
Bir düğme veya akış bu olaylara tepki verebilir.
- Aygıt bağlandı
- Bir Android cihaz takıldı veya Macro Deck onu ilk kez gördü.
- Aygıt bağlantısı kesildi
- Bir Android cihaz çıkarıldı veya Macro Deck onu takip edemez oldu.
- Aygıt yetkilendirildi
- Cihazdaki yetkilendirme isteği kabul edildi.
- Aygıtın yetkisi kaldırıldı
- Daha önce yetkilendirilmiş bir cihazda yetkilendirme isteğinin yeniden kabul edilmesi gerekiyor.
- Aygıt çevrimiçi oldu
- Yetkilendirilmiş bir cihaza yeniden ulaşılabiliyor.
- Aygıt çevrimdışı oldu
- Ulaşılabilen bir cihaza artık ulaşılamıyor.
Değişkenler11
Bu değerleri düğmelerde ve widget’larda gösterin veya koşullarda kullanın.
adb_connected_device_count- Takılı Android cihazların sayısı.
adb_authorized_device_count- Çevrimiçi ve yetkilendirilmiş cihazların sayısı.
adb_device_connected- Varsayılan cihazın bağlı olup olmadığı.
adb_device_authorized- Varsayılan cihazın bu bilgisayarı yetkilendirip yetkilendirmediği.
adb_device_model- Varsayılan cihazın modeli.
adb_device_manufacturer- Varsayılan cihazın üreticisi.
adb_device_battery_level- Varsayılan cihazın yüzde olarak pil seviyesi.
adb_device_screen_on- Varsayılan cihazın ekranının açık olup olmadığı.
adb_device_locked- Varsayılan cihazın kilit ekranını gösterip göstermediği.
adb_device_foreground_app- Varsayılan cihazda öndeki uygulamanın paket adı.
adb_device_<device>_connected,adb_device_<device>_authorized,adb_device_<device>_model,adb_device_<device>_battery_level- Yetkilendirilmiş her cihazın bağlantı durumu, yetkisi, modeli ve pil seviyesi.
<device>, cihazın küçük harf, rakam ve alt çizgiyle yazılmış modelidir; aynı modelden başka cihazlar için sona_2,_3vb. eklenir.
Sıkça sorulan sorular
Android Studio’ya veya Android SDK’ya ihtiyacım var mı?
Hayır. Macro Deck yalnızca Android platform-tools içindeki adb programına ihtiyaç duyar. Ayarlar > ADB bölümünde platform-tools indir düğmesine tıklayın; Macro Deck Google’ın yaklaşık 15 MB’lık resmî paketini kendi kullanımı için indirir. Mevcut bir kurulum otomatik olarak bulunur.
Bir cihazı Wi-Fi üzerinden kontrol edebilir miyim?
Evet. Cihazda kablosuz hata ayıklamayı açın ve Ayarlar > ADB içindeki Kablosuz ağ üzerinden bağlan altına IP adresini ve bağlantı noktasını girin. Macro Deck cihazları kendisi eşleştirmez: Android 11 ve sonrasında cihazı önce bu bilgisayarla eşleştirin veya adb tcpip ile USB üzerinden ağ hata ayıklamasına geçirin. Aksi halde cihaz bağlantıyı reddeder.
Bir eylem neden cihaz bulunamadı hatasıyla başarısız oluyor?
Aygıt alanını boş bıraktığınızda eylem varsayılan cihazı kullanır. Hiçbirini seçmediyseniz ve birden fazla cihaz takılıysa varsayılan cihaz yoktur; bu durumda eylemde bir cihaz seçin veya Ayarlar > ADB bölümünde Varsayılan yap düğmesine tıklayın. Cihazda Yetkili değil yerine Hazır yazdığını da kontrol edin.
Ayrı bir kilitleme eylemi var mı?
Hayır. Android’in ayrı bir kilitleme komutu yoktur. Uyut / Ekranı kilitle ekranı kapatır; bu da cihazı güç düğmesiyle aynı şekilde kilitler.
ADB entegrasyonu ADB kullanan diğer programları etkiler mi?
Macro Deck normal ADB sunucusunu kullanır, bu nedenle Android Studio gibi programlar onu paylaşır. Ayarlar > ADB bölümündeki ADB sunucusunu yeniden başlat onların cihazlarının bağlantısını da kısa süreliğine keser. Macro Deck kapanınca ADB sunucusunu durdur seçeneğini açmadığınız sürece Macro Deck kapanırken sunucuyu çalışır durumda bırakır.
Cihazda neden "Bu aygıta erişim izni yok" görünüyor?
Bilgisayarın cihazla USB üzerinden iletişim kurma izni yoktur. Linux’ta platform-tools udev kurallarını kurun; Windows’ta cihaz için üreticinin USB sürücüsünü kurun.
Bilgisayarınız kategorisinde daha fazlası
Sistem
Macro Deck ile birlikte gelirBilgisayarınızı deck’inizden kontrol edin: uygulamalar, ses düzeyi, komutlar, bildirimler, uyku ve kapatma.
Klavye
Macro Deck ile birlikte gelirBir düğmeden bilgisayarınızda kısayollara basın, metin yazın ve tuş dizileri çalıştırın.
Fare
Macro Deck ile birlikte gelirBir düğmeden bilgisayarınızda tıklayın, imleci taşıyın, sürükleyin ve kaydırın.
Steam
Macro Deck ile birlikte gelirSteam oyunlarını başlatın ve kapatın; oynadığınız oyunu, arkadaşlarınızı ve kitaplığınızı deck’inizde gösterin.