.\adb -s 0123456789ABCDEF shell <الأداة> <الأمر الفرعي> <المعاملات>
الصيغة العامة لاختيار شاشة محددة وتنفيذ أمر داخل Android.
الأوامر العملية اليومية لشاشات Android: الاتصال، التطبيقات، اللمس، الصور والفيديو، الملفات، النظام، الشبكة، السجلات وتحليل الواجهة. أدخل رقم شاشتك مرة واحدة ليُطبّق على جميع الأمثلة.
.\adb devices -lالجزء الأول في السطر قبل كلمة device هو Serial. مثال: 0123456789ABCDEF. إذا كتبت رقمك في الخانة أعلاه، يتغير كل مثال في هذه الصفحة فورًا، وزر النسخ ينسخ النسخة المعدلة.
192.168.1.50:5555 عند استخدام ADB عبر الشبكة.C:\platform-tools. رقم الشاشة الذي تكتبه في الأعلى يُطبّق تلقائيًا على أوامر ADB وFastboot التي تحتوي Serial.كل ما بعد shell يعمل داخل Android.
.\adb -s 0123456789ABCDEF shell <الأداة> <الأمر الفرعي> <المعاملات>
الصيغة العامة لاختيار شاشة محددة وتنفيذ أمر داخل Android.
.\adb -s 0123456789ABCDEF shell
يفتح Shell تفاعلي داخل Android.
exit
يخرج من Shell التفاعلي ويعيدك إلى PowerShell.
يتضمن الأوامر الموجودة سابقًا وإضافات حديثة من ADB الرسمي.
.\adb devices
يعرض الأجهزة المتصلة وحالة كل جهاز.
.\adb devices -l
يعرض الأجهزة مع معلومات إضافية مثل الموديل ومسار النقل.
.\adb version
يعرض إصدار ADB المثبت على الكمبيوتر.
.\adb help
يعرض قائمة أوامر ADB المتاحة في نسختك.
.\adb start-server
يضمن تشغيل خادم ADB على Windows.
.\adb kill-server
يوقف خادم ADB؛ مفيد لإعادة تشغيل الاتصال.
.\adb wait-for-device
ينتظر حتى يتصل جهاز ADB قبل متابعة السكربت.
.\adb -s 0123456789ABCDEF get-state
يعرض حالة الجهاز المختار: device أو offline أو bootloader.
.\adb -s 0123456789ABCDEF get-serialno
يعرض Serial للجهاز المختار.
.\adb -s 0123456789ABCDEF get-devpath
يعرض مسار الجهاز من منظور ADB على الكمبيوتر.
.\adb server-status
يعرض إعدادات خادم ADB مثل backend وmDNS ومسار السجل.
.\adb reconnect
يفرض إعادة اتصال ADB من جهة الكمبيوتر.
.\adb reconnect device
يطلب إغلاق الاتصال من جهة الجهاز لإجبار إعادة الاتصال.
.\adb reconnect offline
يعيد محاولة الأجهزة offline أو unauthorized.
.\adb host-features
يعرض المزايا المدعومة في خادم ADB على الكمبيوتر.
.\adb -s 0123456789ABCDEF features
يعرض المزايا المشتركة المدعومة بين ADB والجهاز.
.\adb -s 0123456789ABCDEF tcpip 5555
يطلب من adbd الاستماع على TCP 5555؛ طريقة قديمة مفيدة لبعض الشاشات.
.\adb connect 192.168.1.50:5555
يتصل بعنوان IP ومنفذ ADB على الشبكة.
.\adb disconnect 192.168.1.50:5555
يفصل اتصال ADB اللاسلكي المحدد.
.\adb disconnect
يفصل جميع اتصالات ADB عبر الشبكة.
.\adb -s 0123456789ABCDEF usb
يعيد adbd إلى وضع USB بدل TCP/IP.
.\adb pair 192.168.1.50:37123
يقترن بجهاز يدعم Wireless debugging باستخدام IP والمنفذ الظاهرين على الشاشة.
.\adb mdns track-services --proto-text
يعرض خدمات ADB المكتشفة عبر mDNS؛ مفيد لتشخيص Wireless debugging.
تثبيت التطبيقات، البحث عن الحزم وتشغيلها وإيقافها.
.\adb -s 0123456789ABCDEF install ".\barg.apk"
يثبت APK جديدًا.
.\adb -s 0123456789ABCDEF install -r ".\barg.apk"
يحدث التطبيق مع محاولة الاحتفاظ ببياناته.
.\adb -s 0123456789ABCDEF install -r -t ".\barg.apk"
يسمح بتثبيت APK تجريبي testOnly عند الحاجة.
.\adb -s 0123456789ABCDEF install-multiple -r ".\base.apk" ".\split_config.apk"
يثبت تطبيقًا مكونًا من عدة APKs.
.\adb -s 0123456789ABCDEF shell pm help
يعرض مساعدة Package Manager.
.\adb -s 0123456789ABCDEF shell am help
يعرض مساعدة Activity Manager.
.\adb -s 0123456789ABCDEF shell pm list packages
يعرض جميع أسماء الحزم.
.\adb -s 0123456789ABCDEF shell pm list packages -3
يعرض تطبيقات الطرف الثالث.
.\adb -s 0123456789ABCDEF shell pm list packages | findstr "youtube"
يبحث عن كلمة youtube في أسماء الحزم باستخدام findstr في Windows.
.\adb -s 0123456789ABCDEF shell pm path com.drbarg.bargyoutube
يعرض مكان APK المثبت للحزمة.
.\adb -s 0123456789ABCDEF shell dumpsys package com.drbarg.bargyoutube
يعرض معلومات الحزمة والإصدار والصلاحيات والأنشطة.
.\adb -s 0123456789ABCDEF shell monkey -p com.drbarg.bargyoutube -c android.intent.category.LAUNCHER 1
يشغل Barg YouTube عبر Launcher.
.\adb -s 0123456789ABCDEF shell am start -n com.drbarg.bargyoutube/.MainActivity
يشغل Activity محددًا؛ يجب أن يكون الاسم صحيحًا.
.\adb -s 0123456789ABCDEF shell am force-stop com.drbarg.bargyoutube
يوقف التطبيق وعملياته دون حذف بياناته.
.\adb -s 0123456789ABCDEF shell am start -a android.intent.action.VIEW -d "https://example.com"
يفتح رابطًا في التطبيق المناسب أو المتصفح.
.\adb -s 0123456789ABCDEF shell am broadcast -a com.example.ACTION_TEST
يرسل Broadcast؛ قد ترفضه المنظومة إذا كان محميًا.
.\adb -s 0123456789ABCDEF shell pm clear com.drbarg.bargyoutube
يمسح بيانات التطبيق وإعداداته.
.\adb -s 0123456789ABCDEF uninstall com.drbarg.bargyoutube
يلغي تثبيت التطبيق ويحذف بياناته عادةً.
.\adb -s 0123456789ABCDEF uninstall -k com.drbarg.bargyoutube
يلغي APK ويحاول إبقاء بيانات التطبيق.
pm clear وuninstall قد يحذفان بيانات التطبيق. لا يمكن التراجع عن مسح البيانات من دون نسخة احتياطية.أوامر التحكم في الإدخال.
.\adb -s 0123456789ABCDEF shell input --help
يعرض خيارات input المدعومة.
.\adb -s 0123456789ABCDEF shell input tap 500 300
ينقر على الإحداثيات X=500 وY=300.
.\adb -s 0123456789ABCDEF shell input swipe 200 900 200 300
يسحب من نقطة إلى أخرى.
.\adb -s 0123456789ABCDEF shell input swipe 500 500 500 500 1500
ضغط مطول 1500ms في نفس النقطة.
.\adb -s 0123456789ABCDEF shell input text "Hello%sWorld"
يكتب النص؛ %s تستخدم كمسافة في هذا الأسلوب.
.\adb -s 0123456789ABCDEF shell input keyevent KEYCODE_HOME
يرسل زر Home باسمه.
.\adb -s 0123456789ABCDEF shell input keyevent 4
يرسل زر Back بالرقم.
.\adb -s 0123456789ABCDEF shell input keyevent 66
يرسل Enter.
.\adb -s 0123456789ABCDEF shell input keyevent 24
يرفع الصوت.
.\adb -s 0123456789ABCDEF shell input keyevent 25
يخفض الصوت.
.\adb -s 0123456789ABCDEF shell input keyevent 164
يكتم الصوت.
.\adb -s 0123456789ABCDEF shell input keyevent 85
Play/Pause.
.\adb -s 0123456789ABCDEF shell input keyevent 87
المقطع التالي.
.\adb -s 0123456789ABCDEF shell input keyevent 88
المقطع السابق.
| الوظيفة | الاسم | الرقم |
|---|---|---|
| الرئيسية | KEYCODE_HOME | 3 |
| رجوع | KEYCODE_BACK | 4 |
| القائمة | KEYCODE_MENU | 82 |
| التطبيقات الأخيرة | KEYCODE_APP_SWITCH | 187 |
| بحث | KEYCODE_SEARCH | 84 |
| Enter | KEYCODE_ENTER | 66 |
| أعلى/أسفل/يسار/يمين | KEYCODE_DPAD_UP/DOWN/LEFT/RIGHT | 19/20/21/22 |
| رفع/خفض الصوت | KEYCODE_VOLUME_UP/DOWN | 24/25 |
| كتم | KEYCODE_VOLUME_MUTE | 164 |
| تشغيل/إيقاف مؤقت | KEYCODE_MEDIA_PLAY_PAUSE | 85 |
| التالي/السابق | KEYCODE_MEDIA_NEXT/PREVIOUS | 87/88 |
تُنشأ الملفات داخل الشاشة أولًا ثم تُنسخ للكمبيوتر باستخدام pull.
.\adb -s 0123456789ABCDEF shell screencap -p /sdcard/Download/car_screen.png
يلتقط PNG داخل الشاشة.
.\adb -s 0123456789ABCDEF pull /sdcard/Download/car_screen.png ".\car_screen.png"
ينسخ لقطة الشاشة إلى الكمبيوتر.
Start-Process ".\car_screen.png"
يفتح الصورة من PowerShell.
.\adb -s 0123456789ABCDEF shell ls -lh /sdcard/Download/car_screen.png
يتأكد من وجود الصورة وحجمها.
.\adb -s 0123456789ABCDEF shell dumpsys display
يعرض Displays المتاحة.
.\adb -s 0123456789ABCDEF shell screencap -p -d 0 /sdcard/Download/car_screen_0.png
يلتقط Display رقم 0 إذا كان الجهاز يدعم الخيار.
.\adb -s 0123456789ABCDEF shell screenrecord --time-limit 30 --size 864x480 --bit-rate 4000000 /sdcard/Download/car_video.mp4
يسجل فيديو 30 ثانية.
.\adb -s 0123456789ABCDEF shell screenrecord --time-limit 30 --size 864x480 --bit-rate 2000000 /sdcard/Download/car_video_small.mp4
تسجيل بمعدل أقل لتقليل حجم الملف.
.\adb -s 0123456789ABCDEF shell screenrecord --time-limit 30 --size 864x480 --bit-rate 6000000 /sdcard/Download/car_video_high.mp4
تسجيل بمعدل أعلى إذا كان المرمّز يدعمه.
.\adb -s 0123456789ABCDEF pull /sdcard/Download/car_video.mp4 ".\car_video.mp4"
ينسخ الفيديو إلى الكمبيوتر.
Start-Process ".\car_video.mp4"
يفتح الفيديو في Windows.
adb pull قبل فتحه.إدارة الملفات بين Windows والشاشة.
New-Item -ItemType Directory -Force ".\Car_Backup\Download"
ينشئ مجلد نسخة احتياطية على الكمبيوتر.
.\adb -s 0123456789ABCDEF push ".\barg.apk" /sdcard/Download/barg.apk
يدفع ملفًا من الكمبيوتر إلى الشاشة.
.\adb -s 0123456789ABCDEF push --sync ".\MyFolder" /sdcard/Download/
ينقل الملفات الأحدث فقط عند دعم النسخة للخيار --sync.
.\adb -s 0123456789ABCDEF pull /sdcard/Download/file.txt ".\file.txt"
يسحب ملفًا من الشاشة.
.\adb -s 0123456789ABCDEF pull -a /sdcard/Download/file.txt ".\file.txt"
يسحب الملف مع محاولة حفظ timestamp وmode.
.\adb -s 0123456789ABCDEF pull /sdcard/Download ".\Car_Backup\Download"
ينسخ مجلد Download.
.\adb -s 0123456789ABCDEF shell ls -lah /sdcard/Download
يعرض الملفات بالتفاصيل.
.\adb -s 0123456789ABCDEF shell mkdir -p /sdcard/MyFolder/SubFolder
ينشئ مجلدًا ومساره الفرعي.
.\adb -s 0123456789ABCDEF shell cp /sdcard/source.txt /sdcard/destination.txt
ينسخ ملفًا داخل Android.
.\adb -s 0123456789ABCDEF shell mv /sdcard/old.txt /sdcard/new.txt
ينقل أو يعيد تسمية ملف.
.\adb -s 0123456789ABCDEF shell cat /sdcard/Download/file.txt
يعرض محتوى ملف نصي.
.\adb -s 0123456789ABCDEF shell grep -n "text" /sdcard/Download/file.txt
يبحث عن نص ويعرض أرقام الأسطر إذا كانت grep متاحة.
.\adb -s 0123456789ABCDEF shell find /sdcard -iname "*.apk"
يبحث عن APKs داخل /sdcard.
.\adb -s 0123456789ABCDEF shell du -sh /sdcard/Download
يعرض حجم مجلد.
.\adb -s 0123456789ABCDEF shell df -h
يعرض مساحة التخزين.
.\adb -s 0123456789ABCDEF shell rm /sdcard/Download/file.txt
يحذف ملفًا.
.\adb -s 0123456789ABCDEF shell rmdir /sdcard/EmptyFolder
يحذف مجلدًا فارغًا فقط.
.\adb -s 0123456789ABCDEF shell rm -rf /sdcard/MyFolder
يحذف المجلد وكل محتوياته.
rm -rf لأن المسار الخاطئ قد يحذف مجلدًا كاملًا.استعلامات تشخيص النظام والذاكرة والطاقة.
.\adb -s 0123456789ABCDEF shell id
يعرض UID والمجموعات.
.\adb -s 0123456789ABCDEF shell whoami
يعرض اسم المستخدم الحالي.
.\adb -s 0123456789ABCDEF shell getprop
يعرض جميع خصائص Android.
.\adb -s 0123456789ABCDEF shell getprop ro.product.model
يعرض موديل الشاشة.
.\adb -s 0123456789ABCDEF shell getprop ro.product.manufacturer
يعرض الشركة المصنعة.
.\adb -s 0123456789ABCDEF shell getprop ro.build.version.release
يعرض إصدار Android.
.\adb -s 0123456789ABCDEF shell getprop ro.build.version.sdk
يعرض API level.
.\adb -s 0123456789ABCDEF shell getprop ro.product.cpu.abi
يعرض معمارية المعالج.
.\adb -s 0123456789ABCDEF shell ps -A
يعرض العمليات.
.\adb -s 0123456789ABCDEF shell ps -A | findstr "drbarg"
يبحث عن عملية تحتوي drbarg.
.\adb -s 0123456789ABCDEF shell top -n 1
لقطة واحدة لاستخدام CPU والذاكرة.
.\adb -s 0123456789ABCDEF shell free -h
يعرض RAM.
.\adb -s 0123456789ABCDEF shell dumpsys battery
يعرض حالة البطارية والطاقة.
.\adb -s 0123456789ABCDEF shell dumpsys battery unplug
يحاكي فصل الطاقة لأغراض الاختبار حتى reset.
.\adb -s 0123456789ABCDEF shell dumpsys battery reset
يلغي محاكاة battery ويعيد القراءات الفعلية.
.\adb -s 0123456789ABCDEF shell dumpsys diskstats
يعرض إحصاءات التخزين.
.\adb -s 0123456789ABCDEF shell service list
يعرض خدمات Android المسجلة.
.\adb -s 0123456789ABCDEF shell pm list users
يعرض المستخدمين.
.\adb -s 0123456789ABCDEF shell am get-current-user
يعرض المستخدم النشط.
.\adb -s 0123456789ABCDEF shell dumpsys power
يعرض حالة الطاقة وWakeLocks ومعلومات متعلقة بها حسب الإصدار.
.\adb -s 0123456789ABCDEF reboot
يعيد تشغيل Android.
استعلامات الشبكة وPort forwarding.
.\adb -s 0123456789ABCDEF shell ip addr
يعرض عناوين IP والواجهات.
.\adb -s 0123456789ABCDEF shell ip route
يعرض مسارات الشبكة والبوابة.
.\adb -s 0123456789ABCDEF shell ping -c 4 8.8.8.8
يختبر الوصول للإنترنت بدون DNS.
.\adb -s 0123456789ABCDEF shell ping -c 4 google.com
يختبر الشبكة وDNS معًا.
.\adb -s 0123456789ABCDEF shell dumpsys wifi
يعرض معلومات Wi‑Fi حسب إصدار النظام.
.\adb -s 0123456789ABCDEF shell dumpsys connectivity
يعرض حالة الاتصال والشبكات.
.\adb -s 0123456789ABCDEF shell netstat
يعرض اتصالات ومنافذ الشبكة إذا كانت الأداة موجودة.
.\adb -s 0123456789ABCDEF shell settings get global http_proxy
يعرض إعداد HTTP proxy العام.
.\adb -s 0123456789ABCDEF forward tcp:8080 tcp:8080
يوجه منفذًا من الكمبيوتر إلى الجهاز.
.\adb -s 0123456789ABCDEF forward --list
يعرض تحويلات forward.
.\adb -s 0123456789ABCDEF forward --remove tcp:8080
يحذف تحويل forward.
.\adb -s 0123456789ABCDEF reverse tcp:8080 tcp:8080
يجعل اتصال الجهاز بالمنفذ يصل إلى منفذ على الكمبيوتر.
.\adb -s 0123456789ABCDEF reverse --list
يعرض تحويلات reverse.
.\adb -s 0123456789ABCDEF reverse --remove tcp:8080
يحذف تحويل reverse المحدد.
Logcat وbugreport وdumpsys.
.\adb -s 0123456789ABCDEF logcat
يعرض Logcat باستمرار.
.\adb -s 0123456789ABCDEF logcat -c
يمسح Logcat الحالي.
.\adb -s 0123456789ABCDEF logcat -d > logcat.txt
يحفظ السجل الحالي في ملف على الكمبيوتر.
.\adb -s 0123456789ABCDEF logcat *:E
يعرض مستوى Error عادةً.
.\adb -s 0123456789ABCDEF logcat | findstr "com.drbarg.bargyoutube"
يصفي السجل عبر findstr في Windows.
.\adb -s 0123456789ABCDEF bugreport ".\bugreport.zip"
ينشئ تقريرًا تشخيصيًا شاملاً.
.\adb -s 0123456789ABCDEF shell dumpsys
يعرض تفريغًا واسعًا لخدمات النظام؛ النتيجة كبيرة.
.\adb -s 0123456789ABCDEF shell dumpsys activity
يعرض حالة Activity Manager.
.\adb -s 0123456789ABCDEF shell dumpsys window
يعرض حالة النوافذ.
.\adb -s 0123456789ABCDEF shell dumpsys audio
يعرض معلومات Audio Service.
.\adb -s 0123456789ABCDEF shell dumpsys media_session
يعرض جلسات الوسائط النشطة حسب دعم النظام.
.\adb -s 0123456789ABCDEF shell getevent -l
يعرض أحداث أجهزة الإدخال مباشرة.
bugreport قد يحتوي معلومات حساسة عن الجهاز والتطبيقات والشبكة. راجعه قبل مشاركته.إحداثيات اللمس والدقة وUI Automator.
.\adb -s 0123456789ABCDEF shell settings put system show_touches 1
يظهر علامة عند كل لمس إذا سمح النظام بتعديل الإعداد.
.\adb -s 0123456789ABCDEF shell settings put system pointer_location 1
يظهر مسار وإحداثيات المؤشر إذا كان مسموحًا.
.\adb -s 0123456789ABCDEF shell settings put system show_touches 0
يعطل علامات اللمس.
.\adb -s 0123456789ABCDEF shell settings put system pointer_location 0
يعطل عرض إحداثيات المؤشر.
.\adb -s 0123456789ABCDEF shell wm size
يعرض دقة الشاشة.
.\adb -s 0123456789ABCDEF shell wm density
يعرض كثافة الشاشة.
.\adb -s 0123456789ABCDEF shell wm size 864x480
يغير دقة العرض مؤقتًا.
.\adb -s 0123456789ABCDEF shell wm density 240
يغير كثافة العرض.
.\adb -s 0123456789ABCDEF shell wm size reset
يعيد دقة العرض الافتراضية.
.\adb -s 0123456789ABCDEF shell wm density reset
يعيد كثافة العرض الافتراضية.
.\adb -s 0123456789ABCDEF shell dumpsys window | findstr "mCurrentFocus"
يعرض التطبيق/النافذة الحالية.
.\adb -s 0123456789ABCDEF shell uiautomator dump /sdcard/Download/window.xml
يحفظ شجرة عناصر الواجهة في XML داخل الجهاز.
.\adb -s 0123456789ABCDEF pull /sdcard/Download/window.xml ".\window.xml"
يسحب XML إلى الكمبيوتر.
.\adb -s 0123456789ABCDEF exec-out uiautomator dump /dev/tty > window.xml
يحاول إخراج شجرة الواجهة مباشرة إلى ملف على الكمبيوتر دون خطوة pull.
wm size وwm density حتى تستطيع استعادتهما إذا لم يناسبك التعديل.أفضل طريقة لمعرفة ما تدعمه شاشتك تحديدًا.
.\adb -s 0123456789ABCDEF shell screencap -h
يعرض مساعدة screencap.
.\adb -s 0123456789ABCDEF shell screenrecord --help
يعرض خيارات screenrecord.
.\adb -s 0123456789ABCDEF shell cmd -l
يعرض خدمات cmd المتاحة.
.\adb -s 0123456789ABCDEF shell cmd package help
يعرض مساعدة خدمة package عبر cmd.
.\adb -s 0123456789ABCDEF shell pm help
يعرض أوامر Package Manager.
.\adb -s 0123456789ABCDEF shell am help
يعرض أوامر Activity Manager.