ADB از طریق وای‌فای و اترنت

توسعه‌دهندگان اندروید باید برنامه‌های خود را روی دستگاه‌های واقعی آزمایش کنند. Android Debug Bridge (ADB) ابزار انتخابی برای ارسال برنامه‌ها و اشکال‌زدایی است. سه روش اصلی برای استفاده از ADB وجود دارد:

1. ADB از طریق USB
2. ADB از طریق وای‌فای
3. ADB از طریق اترنت

برای اکثر تلفن‌ها و تبلت‌ها، می‌توانید یک دستگاه اندروید را با استفاده از کابل USB-C به دستگاه توسعه خود متصل کنید و ADB «به‌راحتی کار خواهد کرد.» از آگوست 2023، اکثر کروم‌بوک‌ها از ADB از طریق USB پشتیبانی نمی‌کنند و دو روش دیگر باقی مانده است: Wi-Fi و Ethernet.

توجه: همچنین می‌توانید از ADB از طریق بلوتوث برای دستگاه‌های WearOS استفاده کنید.

ADB از طریق وای‌فای

اگر دستگاه شما اندروید ۱۱ (API 30) یا بالاتر را اجرا می‌کند، می‌توانید از قابلیت Pair Devices Using Wi-Fi که همراه با اندروید استودیو ارائه می‌شود، استفاده کنید.

برای دستگاه‌هایی که اندروید ۱۰ یا پایین‌تر دارند، یا اگر در جفت‌سازی از طریق اندروید استودیو مشکل دارید، می‌توانید با استفاده از یک دستگاه IP و ترمینال به صورت دستی متصل شوید.

1. مطمئن شوید که دستگاه توسعه‌دهنده و دستگاه اندروید شما به یک شبکه بی‌سیم یکسان متصل هستند.
2. مطمئن شوید که شبکه شما اجازه عبور ترافیک از پورت 5555 (یا پورت دیگری که به صورت دستی انتخاب شده است) را می‌دهد. برخی از شبکه‌های سازمانی و خانگی دارای فایروال‌هایی هستند که از عملکرد ADB جلوگیری می‌کنند. همچنین می‌توانید از تلفن همراه به عنوان هاب شبکه بی‌سیم برای ایجاد شبکه‌ای که امکان عبور ترافیک از پورت 5555 را فراهم می‌کند، استفاده کنید، اگرچه این کار ممکن است منجر به حجم زیادی از ترافیک شبکه و تخلیه باتری تلفن شود.
3. برای تلفن‌ها و تبلت‌های غیر ChromeOS، باید حالت TCP/IP را فعال کنید. برای انجام این کار، دستگاه اندروید خود را از طریق USB به دستگاه توسعه خود متصل کنید و دستور adb tcpip 5555 را روی دستگاه توسعه اجرا کنید. این کار دستگاه را در حالت TCP/IP قرار می‌دهد و به پورت ۵۵۵۵ گوش می‌دهد. پس از فعال کردن، می‌توانید کابل USB را جدا کنید.
4. آدرس IP دستگاه خود را تعیین کنید. آدرس‌های IPv4 رایج‌ترین نوع آدرس‌ها هستند و چیزی شبیه به این هستند: 192.168.1.4 . آدرس‌های IPv6 رایج‌تر شده‌اند و چیزی شبیه به این هستند: 2001:0db8:3c4d:0015:0000:0000:1a2f:1a2b . اگر دستگاه شما هر دو را فهرست می‌کند، از آدرس IPv۴ استفاده کنید.
   1. در تلفن‌ها/تبلت‌ها، به تنظیمات اندروید، اطلاعات بروید و به پایین بروید تا آدرس IP خود را ببینید.
   2. در ChromeOS، روی ساعت در پایین سمت راست کلیک کنید، روی منوی کشویی زیر آیکون شبکه کلیک کنید و سپس روی شبکه‌ای که در حال حاضر به آن متصل هستید کلیک کنید. در زیر عنوان Network ، آدرس IP اختصاص داده شده به Chromebook خود را مشاهده خواهید کرد.
5. در دستگاه توسعه خود، عبارت adb connect IP_ADDRESS_FROM_STEP4 را تایپ کنید، مثلاً adb connect 192.168.1.4 . همچنین می‌توانید پورت را به صورت دستی مشخص کنید، مانند adb connect 192.168.1.4:5555 .
6. طبق معمول از ADB یا اندروید استودیو استفاده کنید. می‌توانید با اجرای دستور adb devices اتصال را تأیید کنید.

نکته: برای اطلاعات بیشتر، به بخش «اتصال به دستگاه از طریق Wi-Fi» مراجعه کنید.

ADB از طریق اترنت

در برخی موارد، ممکن است به دلیل محدودیت‌های فایروال، استفاده از شبکه Wi-Fi امکان‌پذیر نباشد، یا ممکن است یک راه حل سیمی ترجیح داده شود. در این موارد، می‌توانید از طریق کابل اترنت متصل شوید. مراحل مشابه ADB از طریق Wi-Fi است، اما با استفاده از کابل اترنت.

پیش‌نیازها

قبل از شروع، باید مطمئن شوید که دستگاه شما از اتصال اترنت پشتیبانی می‌کند:

• کابل اترنت: یک کابل فیزیکی برای اتصال بین دستگاه‌های شما. انواع اترنت Cat 5/5e/6/6a همگی مناسب هستند.
• پورت اترنت: یک پورت اترنت برای دستگاه تست و دستگاه توسعه شما.

نکته: اگر دستگاه شما پورت اترنت ندارد، می‌توانید از یک دانگل اترنت استفاده کنید که از طریق USB به دستگاه شما متصل می‌شود و قابلیت اترنت را فراهم می‌کند.

اتصال ADB از طریق اترنت

پس از اینکه دستگاه‌های خود را به صورت فیزیکی با کابل اترنت متصل کردید، می‌توانید ADB را از طریق اتصال فعال کنید.

توجه: این دستورالعمل‌ها فرض می‌کنند که شبکه محلی شما روی فضای آدرس 192.168.1.x اجرا می‌شود.

هشدار: برای تلفن‌ها و تبلت‌های غیر ChromeOS، ممکن است لازم باشد حالت TCP/IP را فعال کنید. برای انجام این کار، دستگاه اندروید خود را از طریق USB به دستگاه توسعه خود متصل کنید و دستور adb tcpip 5555 را روی دستگاه توسعه اجرا کنید. این کار دستگاه را در حالت TCP/IP قرار می‌دهد و به پورت ۵۵۵۵ گوش می‌دهد. پس از فعال کردن، می‌توانید کابل USB را جدا کنید.

1. در دستگاه توسعه خود، آدرس IP اختصاص داده شده به آداپتور اترنت را یادداشت کنید. اگر هیچ آدرسی اختصاص داده نشده است، ممکن است لازم باشد این آدرس را به صورت دستی تنظیم کنید، یا روی چیزی در محدوده 192.168.1.x مانند 192.168.1.3 ، یا آداپتور خود را طوری پیکربندی کنید که فقط به شبکه محلی متصل شود و از DHCP استفاده نکند:
   1. برای ویندوز، به بخش «تغییر تنظیمات TCP/IP» ، بخش «تعیین دستی تنظیمات IPv4» مراجعه کنید. آدرس IP را روی 192.168.1.3 تنظیم کنید.
   2. برای مک، به بخش «استفاده از DHCP یا آدرس IP دستی در مک» مراجعه کنید و دستورالعمل‌های مربوط به آدرس IP دستی را دنبال کنید. آدرس IP را روی 192.168.1.3 تنظیم کنید.
   3. برای لینوکس، از ابزار گرافیکی توزیع خود برای تنظیم دستی آدرس IP استفاده کنید یا آن را از ترمینال به صورت زیر تنظیم کنید: ifconfig اجرا کنید تا شناسه آداپتور خود را پیدا کنید، سپس هنگام اجرای sudo ifconfig enx00eXXXXXXXXX 192.168.1.3 broadcast 192.168.255.255 netmask 255.255.0.0 آن به جای enx00eXXXXXXXXX استفاده کنید. این کار آدرس IP را به 192.168.1.3.
2. در کروم‌بوکی که قرار است اشکال‌زدایی کنید، آدرس اترنت را طوری تنظیم کنید که در همان محدوده شبکه دستگاه توسعه شما باشد:
   1. برای باز کردن crosh، پوسته ChromeOS، ctrl + alt + t را فشار دهید.
   2. عبارت shell را تایپ کرده و Enter را بزنید.
   3. دستور ssh root@localhost را تایپ کنید.
   4. برای پذیرش اثر انگشت SSH (پروتکل پوسته امن) در صورت درخواست، yes را تایپ کنید.
   5. رمز عبور پیش‌فرض test0000 است.
   6. دستور ifconfig eth0 192.168.1.2 را تایپ کنید. این دستور اولین دستگاه اترنت را روی آدرس 192.168.1.2 تنظیم می‌کند (این را بعداً به خاطر داشته باشید). اگر eth0 وجود ندارد، ifconfig برای فهرست کردن تمام دستگاه‌های شبکه و تعیین شناسه صحیح برای پورت اترنت یا دانگل خود استفاده کنید.
3. در دستگاه توسعه خود، adbconnect 192.168.1.2 تایپ کنید. همچنین می‌توانید پورت را به صورت دستی با adb connect 192.168.1.2:5555 مشخص کنید.
4. طبق معمول از ADB یا اندروید استودیو استفاده کنید. می‌توانید با اجرای دستور adb devices اتصال را تأیید کنید.