ADB: mga batayan ng pagtatrabaho sa Android Debug Bridge at mga sikat na utos

Ano ang ADB at para saan ito

Android Debug Bridge (ADB) — ay isang client-server application na binubuo ng tatlong bahagi: client (tumatakbo sa computer), server (background process sa computer), at daemon na adbd (tumatakbo sa Android device mismo). Kapag ang isang developer o engineer ay nagkonekta ng smartphone sa PC, ang ADB ay lumilikha ng maaasahang channel ng komunikasyon kung saan maaaring magpadala ng mga utos, file, at data.

Ang mga pangunahing sitwasyon ng paggamit ng ADB ay kinabibilangan ng pag-debug ng mga app sa isang tunay na device nang hindi kailangang i-publish ang APK sa tindahan, pagkuha ng logs para sa pagsusuri ng error, automation ng pagsubok, backup ng data, pag-flash ng recovery images, at pagkuha ng root access. Kahit hindi ka nagsusulat ng code, maaaring maging kapaki-pakinabang ang ADB para sa pagkuha ng mga screenshot mula sa mga app, pag-record ng video guide mula sa screen ng telepono, o pag-restore ng device pagkatapos ng nabigong pag-flash.

Ang suporta sa ADB ay naka-embed sa lahat ng opisyal na Android build simula sa bersyon 2.1 (API 7). Para sa pagpapatakbo, kinakailangan ang naka-enable na opsyon na 'USB Debugging' sa mga setting ng developer. Simula sa Android 4.2, sa unang pagkonekta, humihingi ang device ng kumpirmasyon: kailangan mong payagan ang debugging para sa partikular na computer batay sa RSA key nito.

Pag-install ng ADB sa computer

Para sa Windows — i-download ang Platform Tools mula sa opisyal na website ng Google Developers, i-extract ang archive sa folder na C:\adb at idagdag ang path na ito sa environment variable na PATH. Pagkatapos i-restart ang terminal, ang utos na adb ay magiging available sa buong system.

Para sa macOS — ang pinakamadaling paraan ay i-install ang ADB sa pamamagitan ng package manager na Homebrew: patakbuhin ang brew install android-platform-tools. Lahat ng dependencies ay awtomatikong malulutas.

Para sa Linux — sa mga distribusyon na batay sa Debian / Ubuntu: sudo apt install adb. Pagkatapos ng pag-install, idagdag ang user sa grupong plugdev: sudo usermod -aG plugdev $USER at mag-login muli upang magkaroon ng access ang ADB sa mga USB device.

Maaaring suriin ang tamang pag-install gamit ang utos na adb version. Kung ang numero ng bersyon ng Android Debug Bridge ay ipinapakita, ang tool ay handa nang gamitin.

Pagkonekta ng device at mga pangunahing utos

Unang pagkonekta ay palaging nagsisimula sa utos na adb devices. Ipinapakita nito ang listahan ng mga nakakonektang device at ang kanilang status. Kung ang device ay lumilitaw bilang unauthorized, i-unlock ang screen at kumpirmahin ang debugging sa telepono.

adb devices
List of devices attached
emulator-5554   device
0123456789ABCD  device

Pag-install ng app — isa sa mga pinakakaraniwang operasyon. Sapat na itukoy ang path sa APK file:

adb install C:\apps\myapp.apk

Kung ang app ay naka-install na ngunit kailangang palitan ng na-update na bersyon, idagdag ang flag na -r (replace):

adb install -r C:\apps\myapp-v2.apk

Pag-uninstall ng app ay ginagawa sa pangalan ng package:

adb uninstall com.example.myapp

Pagkopya ng mga file — ang adb pull ay kumukuha ng file mula sa device papunta sa computer, ang adb push ay nag-upload ng file sa device:

adb pull /sdcard/DCIM/screenshot.png .
adb push myfile.txt /sdcard/Documents/

Interactive shell — ang utos na adb shell ay nagbubukas ng command shell ng device. Sa loob nito, maaaring magpatakbo ng mga karaniwang Linux command: ls, ps, top, dumpsys, pm, am, at iba pa.

adb shell
tissot_sprout:/ $ ls -la /sdcard/
tissot_sprout:/ $ ps | grep com.android.chrome

Pagsisimula ng aktibidad sa pamamagitan ng ADB ay nagpapahintulot sa iyo na buksan ang anumang app o screen nang hindi manu-manong naghahanap ng icon:

adb shell am start -n com.android.chrome/com.google.android.apps.chrome.Main

Paggawa gamit ang logs: Logcat

Logcat — ay ang logging system ng Android na kumukolekta ng mga mensahe mula sa mga app, system services, at kernel. Ang tool ay kailangang-kailangan sa pag-debug: mula sa logs ay mauunawaan mo kung bakit nag-crash ang app, aling method ang nagdulot ng exception, o gaano katagal ang isang partikular na operasyon.

Simpleng pagpapatakbo nang walang filter — adb logcat. Ang daloy ng log ay walang katapusan, pindutin ang Ctrl+C upang huminto. Upang i-filter ang mga mensahe ayon sa tag, gamitin ang parameter na -s:

adb logcat -s MainActivity:V

Mga antas ng kahalagahan ng logging (mula sa pinakadetalyado hanggang kritikal): V (Verbose), D (Debug), I (Info), W (Warning), E (Error), F (Fatal). Ang kombinasyon ng tag at antas ay nagbibigay-daan upang kunin lamang ang mga kinakailangang mensahe.

Upang i-clear ang naipong buffer bago ang pagsubok:

adb logcat -c

At upang i-save ang logs sa isang file:

adb logcat -d > app_logs.txt

Ang flag na -d (dump) ay nagpapakita ng kasalukuyang buffer at nagtatapos nang hindi hinaharangan ang terminal. Ito ay maginhawa para sa automation scripts.

Screenshot, pag-record ng screen, at kapaki-pakinabang na diagnostic na utos

Screenshot ay ginagawa gamit ang utos na adb shell screencap. Ang resulta ay nai-save sa isang file na pagkatapos ay kukunin sa pamamagitan ng adb pull:

adb shell screencap /sdcard/screen.png
adb pull /sdcard/screen.png

Maaaring pagsamahin ang parehong operasyon sa isang linya gamit ang substitution at pipeline. Sa praktika, pinapabilis nito ang paggawa ng dokumentasyon at mga ulat ng pagsubok.

Pag-record ng screen ay available sa Android 4.4+ (API 19). Default na tagal ng recording — 180 segundo, bitrate — 4 Mbit/s. Pangunahing utos:

adb shell screenrecord /sdcard/demo.mp4

Upang ihinto ang pag-record, pindutin ang Ctrl+C. Ang resolution ng video ay tumutugma sa resolution ng screen ng device, ngunit hindi lalampas sa 1080p. Upang baguhin ang bitrate, tukuyin ang --bit-rate:

adb shell screenrecord --bit-rate 8000000 /sdcard/demo.mp4

Diagnostic na utos: ang adb shell dumpsys ay nagpapakita ng estado ng lahat ng system services. Upang makakuha ng impormasyon tungkol lamang sa baterya:

adb shell dumpsys battery

Ang listahan ng mga naka-install na package ay maaaring makuha sa pamamagitan ng Package Manager:

adb shell pm list packages

Pag-reset ng mga setting ng app (katulad ng pag-clear ng data sa mga setting):

adb shell pm clear com.example.myapp

Mga advanced na kakayahan ng ADB

Wi-Fi debugging ay tinatanggal ang pangangailangan na panatilihing naka-konekta ang device sa pamamagitan ng USB. Tiyaking ang computer at device ay nasa parehong network. Una, patakbuhin ang adb tcpip 5555, tanggalin ang USB, pagkatapos ay kumonekta sa pamamagitan ng IP:

adb tcpip 5555
adb connect 192.168.1.100:5555

Kung hindi alam ang IP address ng device, alamin ito sa pamamagitan ng adb shell ip addr show wlan0 bago tanggalin ang cable.

Backup ng data ng app o ng buong system ay ginagawa nang walang root:

adb backup -apk -shared -all -system -f mybackup.ab

Pag-restore mula sa backup:

adb restore mybackup.ab

Emulation ng input — ang utos na adb shell input ay nagbibigay-daan upang gayahin ang pagpindot, pag-swipe, pagpindot ng key, at pagpasok ng text. Ito ang batayan para sa automation ng UI tests nang walang karagdagang frameworks:

adb shell input tap 500 1000
adb shell input swipe 300 500 800 500
adb shell input text "Hello, ADB!"

Pag-restart sa iba't ibang mode:

adb reboot          # normal na restart
adb reboot recovery # recovery mode
adb reboot bootloader # bootloader (fastboot)

Ang fastboot mode ay nagbubukas ng access sa pag-flash ng images, pag-unlock ng bootloader, at pag-install ng custom na recovery.

Paggawa gamit ang maramihang device

Kapag maraming device o emulator ang nakakonekta nang sabay, ang ADB ay nangangailangan ng pagtukoy ng partikular na serial number. Ang utos na adb devices ay nagpapakita ng lahat ng nakakonektang device kasama ang kanilang mga serial number.

Upang i-address ang utos sa isang partikular na device, gamitin ang flag na -s:

adb -s 0123456789ABCD install myapp.apk

Kung iisa lang ang device, maaari kang gumana nang walang flag. Gayunpaman, sa CI environment kung saan maraming emulator ang sabay na tumatakbo, ang pagtukoy ng serial number ay sapilitan.

Patayin ang ADB server — kung ang device ay tumigil sa pag-detect o nagbibigay ng error, ang pag-restart ng server ay makakatulong:

adb kill-server
adb start-server

Pagkatapos nito, patakbuhin ang adb devices — magre-restart ang server at iruruta ang mga request sa mga device daemon.

Mga pangunahing utos ng ADB: talahanayan ng buod

Konklusyon

ADB (Android Debug Bridge) — ay isang pangunahing tool para sa lahat na nagtatrabaho sa Android sa propesyonal na antas. Mula sa pangunahing pag-install ng apps hanggang sa komplikadong automation ng pagsubok at pag-restore ng device — ang ADB ay sumasaklaw sa halos lahat ng sitwasyon ng interaksyon ng computer sa smartphone o tablet.

Sa pamamagitan ng pag-master ng mga utos na inilarawan sa artikulong ito, magagawa mong may kumpiyansa na pamahalaan ang Android device sa pamamagitan ng terminal, suriin ang logs, kumuha ng screenshot para sa dokumentasyon, magsagawa ng backup, at pabilisin ang proseso ng pag-develop. Ang regular na pagsasanay at pag-aaral ng output ng adb help ay gagawin kang isang bihasang user ng makapangyarihang tool na ito.