ADB / Android Debug Bridge
Dołączona do Macro DeckSteruj telefonem lub tabletem z Androidem przez USB albo Wi-Fi: wybudzaj go, uruchamiaj aplikacje, dotykaj, wpisuj tekst i rób zrzuty ekranu.
Karta Przegląd integracji ADB / Android Debug Bridge z komunikatem o włączeniu ADB w Ustawieniach
- Wybudzanie, blokowanie i ponowne uruchamianie podłączonego urządzenia z Androidem
- Uruchamianie i wymuszanie zatrzymania aplikacji oraz otwieranie łączy na urządzeniu
- Wysyłanie klawiszy, dotknięć, przesunięć i tekstu
- Zapisywanie zrzutów ekranu urządzenia w folderze
- Zdarzenia urządzenia i zmienne dla baterii, ekranu i aplikacji na pierwszym planie
Integracja ADB steruje telefonami i tabletami z Androidem za pomocą Android Debug Bridge (ADB), tego samego narzędzia, którego używają programiści Androida. Macro Deck odnajduje program adb, uruchamia serwer ADB i śledzi urządzenia podłączone przez USB lub połączone przez Wi-Fi. Może też samodzielnie pobrać oficjalne Android platform-tools.
Każda akcja działa na urządzeniu wybranym w akcji albo na urządzeniu domyślnym, jeśli pole Urządzenie pozostanie puste. Urządzenie domyślne to to, które wybrano przyciskiem Ustaw jako domyślne w sekcji Ustawienia > ADB, a jeśli nie wybrano żadnego, jedyne podłączone urządzenie.
Możliwości
- Ekran i zasilanie: wybudzenie urządzenia, wyłączenie ekranu (w ten sposób Android blokuje urządzenie) lub ponowne uruchomienie w trybie Android, recovery albo bootloader.
- Aplikacje i łącza: uruchomienie aplikacji lub wymuszenie jej zatrzymania według nazwy pakietu, np.
com.spotify.music, oraz otwarcie łącza w aplikacji, którą wybierze dla niego urządzenie. - Wprowadzanie: wysłanie klawisza, np. Home, Back, Volume Up lub Media Play Pause, dotknięcie punktu na ekranie, przesunięcie z jednego punktu do drugiego albo wpisanie tekstu w aktywnym polu.
- Zrzuty ekranu: zapisanie zawartości ekranu jako pliku PNG w folderze na komputerze i opcjonalnie zapisanie ścieżki pliku w zmiennej.
Przykładowe zastosowania:
- Przycisk, który wybudza tablet na biurku i uruchamia aplikację muzyczną.
- Przycisk, który wysyła do telefonu Media Play Pause.
- Automatyzacja na zdarzenie Urządzenie połączone, która otwiera stronę z panelem na tablecie zaraz po jego podłączeniu.
Stan na żywo
Integracja zgłasza, gdy urządzenie zostanie połączone, rozłączone, autoryzowane, utraci autoryzację, przejdzie offline lub wróci online, więc przebiegi i przyciski mogą na to reagować. Zmienne przechowują liczbę połączonych i autoryzowanych urządzeń, a dla urządzenia domyślnego jego model, producenta, poziom baterii, informację, czy ekran jest włączony, czy wyświetla się ekran blokady i która aplikacja jest na pierwszym planie. Każde autoryzowane urządzenie otrzymuje też własne zmienne, nazwane według jego modelu. Gdy integracja jest włączona, bateria każdego urządzenia z Androidem pojawia się również w widżecie Bateria.
Podstawowe akcje (klawisze, dotknięcia, przesunięcia, tekst, aplikacje, łącza, ponowne uruchomienia i zrzuty ekranu) działają także wtedy, gdy Macro Deck jest zablokowany, więc przypisany do nich przycisk działa nawet na zablokowanym komputerze.
Czego potrzebujesz
- Macro Deck 3 w systemie Windows, macOS lub Linux
- Urządzenie z Androidem z włączonym debugowaniem USB w opcjach programisty
- Kabel USB przesyłający dane albo debugowanie bezprzewodowe do połączenia przez Wi-Fi
- Android platform-tools (adb); Macro Deck może je pobrać w sekcji Ustawienia > ADB
- W systemie Linux uprawnienie użytkownika do urządzenia USB, zwykle nadawane regułą udev
Konfiguracja krok po kroku
Krok 1: Włącz integrację ADB
Na pasku bocznym kliknij Integracje, a następnie ADB / Android Debug Bridge. Integracja pozostaje wyłączona do momentu włączenia przełącznika w prawym górnym rogu. Po jej włączeniu strona pokazuje komunikat ADB jest wyłączone, dopóki ADB nie zostanie włączone w następnym kroku.
Krok 2: Włącz ADB w Macro Deck
Otwórz Ustawienia > ADB i włącz Włącz ADB. Jeśli Program ADB pokazuje Nie znaleziono, kliknij Pobierz platform-tools. Istniejący Android SDK lub
adbw zmiennejPATHzostanie wykryty automatycznie, a w polu Ścieżka do pliku wykonywalnego można wskazać inny.Krok 3: Włącz debugowanie USB na urządzeniu
Na telefonie lub tablecie otwórz Ustawienia > Informacje o telefonie i dotknij siedem razy Numer kompilacji, aby włączyć Opcje programisty. Następnie włącz Debugowanie USB w Ustawienia > Opcje programisty. Dokładne położenie tych opcji różni się nieco w zależności od producenta.
Krok 4: Podłącz i autoryzuj urządzenie
Podłącz urządzenie kablem USB i potwierdź na jego ekranie komunikat Zezwolić na debugowanie USB?. Zaznacz Zawsze zezwalaj z tego komputera, aby pytanie się nie powtarzało. Urządzenie pojawi się wtedy w sekcji Urządzenia w Ustawienia > ADB ze stanem Gotowy. Aby zamiast tego połączyć się przez Wi-Fi, wpisz adres IP i port urządzenia w polu Połącz przez Wi-Fi, np.
192.168.1.20:5555.Krok 5: Wybierz urządzenie domyślne
Jeśli podłączonych jest kilka urządzeń, kliknij Ustaw jako domyślne obok tego, którego akcje mają używać, gdy pole Urządzenie pozostaje puste. Pojedyncze urządzenie jest używane automatycznie.
Krok 6: Dodaj akcję ADB do przycisku
Na stronie Deck upewnij się, że deck jest odblokowany (przycisk w prawym górnym rogu ma etykietę Zablokuj), i kliknij przycisk. Otworzy się edytor z zaznaczonym Krótkie naciśnięcie. Kliknij + Dodaj akcję, po lewej stronie okna Dodaj akcję wybierz ADB / Android Debug Bridge i wybierz akcję, np. Wybudź urządzenie lub Uruchom aplikację. Wypełnij jej pola, np. Pakiet dla Uruchom aplikację, i pozostaw pole Urządzenie puste, aby użyć urządzenia domyślnego. Kategoria pojawia się tylko wtedy, gdy integracja jest włączona.
Krok 7: Naciśnij przycisk
Kliknij Zapisz i naciśnij przycisk na decku. Jeśli nic się nie dzieje, sprawdź w Integracje, czy pojawił się komunikat, np. Brak podłączonych urządzeń albo informacja o urządzeniu wymagającym autoryzacji.
Akcje11
Przypisz je do przycisku lub uruchamiaj w przebiegu.
- Wybudź urządzenie
- Wybudza ekran urządzenia.
- Uśpij / zablokuj ekran
- Wyłącza ekran urządzenia, co w Androidzie blokuje urządzenie.
- Uruchom aplikację
- Uruchamia aplikację według nazwy pakietu lub przenosi ją na pierwszy plan.
- Wymuś zatrzymanie aplikacji
- Wymusza zatrzymanie aplikacji według nazwy pakietu.
- Otwórz łącze
- Otwiera identyfikator URI na urządzeniu, tak jak dotknięcie łącza.
- Wpisz tekst
- Wpisuje tekst w aktualnie aktywnym polu na urządzeniu.
- Wyślij klawisz
- Wysyła pojedyncze zdarzenie klawisza Androida, np. Home, Back, Volume Up lub Media Next.
- Dotknięcie
- Dotyka ekranu w podanych współrzędnych X i Y.
- Przesunięcie
- Przesuwa po ekranie z jednego punktu do drugiego w zadanym czasie.
- Uruchom ponownie urządzenie
- Uruchamia ponownie urządzenie w trybie Normal, Recovery lub Bootloader.
- Wykonaj zrzut ekranu
- Przechwytuje ekran urządzenia i zapisuje go jako plik PNG w folderze, opcjonalnie zapisując jego ścieżkę w zmiennej.
Wyzwalacze6
Przycisk lub przebieg może reagować na te zdarzenia.
- Urządzenie połączone
- Urządzenie z Androidem zostało podłączone lub Macro Deck wykrył je po raz pierwszy.
- Urządzenie rozłączone
- Urządzenie z Androidem zostało odłączone lub Macro Deck przestał je śledzić.
- Urządzenie autoryzowane
- Monit autoryzacji na urządzeniu został zaakceptowany.
- Urządzenie utraciło autoryzację
- Wcześniej autoryzowane urządzenie wymaga ponownej akceptacji monitu autoryzacji.
- Urządzenie przeszło online
- Autoryzowane urządzenie znów jest osiągalne.
- Urządzenie przeszło offline
- Urządzenie, które było osiągalne, nie jest już osiągalne.
Zmienne11
Wyświetlaj te wartości na przyciskach i widżetach albo używaj ich w warunkach.
adb_connected_device_count- Liczba podłączonych urządzeń z Androidem.
adb_authorized_device_count- Liczba urządzeń, które są online i autoryzowane.
adb_device_connected- Czy urządzenie domyślne jest połączone.
adb_device_authorized- Czy urządzenie domyślne autoryzowało ten komputer.
adb_device_model- Model urządzenia domyślnego.
adb_device_manufacturer- Producent urządzenia domyślnego.
adb_device_battery_level- Poziom baterii urządzenia domyślnego w procentach.
adb_device_screen_on- Czy ekran urządzenia domyślnego jest włączony.
adb_device_locked- Czy urządzenie domyślne wyświetla ekran blokady.
adb_device_foreground_app- Nazwa pakietu aplikacji na pierwszym planie urządzenia domyślnego.
adb_device_<device>_connected,adb_device_<device>_authorized,adb_device_<device>_model,adb_device_<device>_battery_level- Połączenie, autoryzacja, model i poziom baterii każdego autoryzowanego urządzenia.
<device>to model urządzenia zapisany małymi literami, cyframi i podkreśleniami, a kolejne urządzenia tego samego modelu otrzymują dopisek_2,_3itd.
Najczęściej zadawane pytania
Czy potrzebuję Android Studio lub Android SDK?
Nie. Macro Deck potrzebuje tylko programu adb z Android platform-tools. Kliknij Pobierz platform-tools w sekcji Ustawienia > ADB, a Macro Deck pobierze na własny użytek oficjalny pakiet od Google o rozmiarze około 15 MB. Istniejąca instalacja zostanie wykryta automatycznie.
Czy mogę sterować urządzeniem przez Wi-Fi?
Tak. Włącz debugowanie bezprzewodowe na urządzeniu i wpisz jego adres IP i port w polu Połącz przez Wi-Fi w sekcji Ustawienia > ADB. Macro Deck sam nie paruje urządzeń: w Androidzie 11 i nowszym najpierw sparuj urządzenie z tym komputerem albo przełącz je przez USB na debugowanie sieciowe poleceniem adb tcpip. W przeciwnym razie urządzenie odrzuci połączenie.
Dlaczego akcja kończy się błędem, że nie znaleziono urządzenia?
Gdy pole Urządzenie jest puste, akcja używa urządzenia domyślnego. Jeśli nie wybrano żadnego, a podłączonych jest kilka urządzeń, urządzenia domyślnego nie ma, więc wybierz urządzenie w akcji albo kliknij Ustaw jako domyślne w sekcji Ustawienia > ADB. Sprawdź też, czy urządzenie ma stan Gotowy, a nie Brak autoryzacji.
Czy istnieje osobna akcja blokowania?
Nie. Android nie ma osobnego polecenia blokady. Uśpij / zablokuj ekran wyłącza ekran, co blokuje urządzenie tak samo jak przycisk zasilania.
Czy integracja ADB wpływa na inne programy korzystające z ADB?
Macro Deck używa zwykłego serwera ADB, więc programy takie jak Android Studio korzystają z niego wspólnie. Uruchom ponownie serwer ADB w sekcji Ustawienia > ADB na chwilę rozłącza również ich urządzenia. Po zamknięciu Macro Deck serwer działa dalej, chyba że włączono opcję Zatrzymaj serwer ADB przy zamykaniu Macro Deck.
Dlaczego urządzenie pokazuje „Brak uprawnień do dostępu do tego urządzenia”?
Komputer nie ma uprawnień do komunikacji z urządzeniem przez USB. W systemie Linux zainstaluj reguły udev z platform-tools, a w systemie Windows zainstaluj sterownik USB producenta urządzenia.
Więcej w kategorii Twój komputer
System
Dołączona do Macro DeckSteruj komputerem z decku: aplikacje, głośność, polecenia, powiadomienia, uśpienie i wyłączanie.
Klawiatura
Dołączona do Macro DeckNaciskaj skróty, wpisuj tekst i uruchamiaj sekwencje klawiszy na komputerze z poziomu przycisku.
Mysz
Dołączona do Macro DeckKlikaj, przesuwaj wskaźnik, przeciągaj i przewijaj na komputerze z poziomu przycisku.
Steam
Dołączona do Macro DeckUruchamiaj i zamykaj gry Steam oraz pokazuj na decku bieżącą grę, znajomych i bibliotekę.