اشکال‌زدایی با استفاده از Chrome DevTools

شما می‌توانید از DevTools تعبیه‌شده در مرورگر کروم که روی دستگاه توسعه شما اجرا می‌شود، برای بررسی و اشکال‌زدایی از راه دور WebViewهای در حال اجرا در برنامه خود استفاده کنید. برای راهنمای دقیق در مورد اشکال‌زدایی از راه دور برای WebViewها، به بخش اشکال‌زدایی از راه دور WebViewها مراجعه کنید.

برای کسب اطلاعات بیشتر در مورد DevTools، به «مروری بر Chrome DevTools» مراجعه کنید.

فعال کردن اتصال از Chrome DevTools

WebView برنامه شما به طور پیش‌فرض اتصالات از Chrome DevTools را فعال نمی‌کند. شما باید اشکال‌زدایی WebView را در کد برنامه خود فعال کنید.

  1. مطمئن شوید که برای اجرای برنامه خود روی یک دستگاه سخت‌افزاری یا مجازی آماده هستید.
  2. با فراخوانی setWebContentsDebuggingEnabled اشکال‌زدایی WebView را در کد برنامه خود فعال کنید. این کار معمولاً در کلاس Activity یا Application که WebView در آن مقداردهی اولیه شده است، انجام می‌شود.

توصیه می‌کنیم setWebContentsDebuggingEnabled در یک بررسی شرطی قرار دهید تا اشکال‌زدایی فقط در نسخه‌های توسعه فعال باشد، نه در نسخه‌های عملیاتی. این تنظیم برای همه WebViewهای برنامه شما اعمال می‌شود.

اشکال‌زدایی WebView تحت تأثیر وضعیت پرچم debuggable در مانیفست برنامه قرار نمی‌گیرد. اگر می‌خواهید اشکال‌زدایی WebView را فقط زمانی فعال کنید که پرچم debuggable روی true تنظیم شده باشد، این پرچم را در زمان اجرا، همانطور که در مثال زیر نشان داده شده است، آزمایش کنید:

کاتلین

if (applicationInfo.flags and ApplicationInfo.FLAG_DEBUGGABLE != 0) {
     WebView.setWebContentsDebuggingEnabled(true)
}

جاوا

if (0 != (getApplicationInfo().flags & ApplicationInfo.FLAG_DEBUGGABLE)) {
     WebView.setWebContentsDebuggingEnabled(true);
}

اشکال‌زدایی وب‌ویو خود را شروع کنید

بعد از اینکه اشکال‌زدایی WebView را در کد برنامه خود فعال کردید و برنامه شما روی یک دستگاه فیزیکی یا شبیه‌ساز اندروید اجرا شد، Chrome DevTools را به WebView خود متصل کنید:

  1. کروم را روی دستگاه توسعه‌دهنده خود باز کنید.
  2. به chrome://inspect بروید.
  3. در صفحه chrome://inspect ، مطمئن شوید که گزینه Discover USB devices تیک خورده باشد. دستگاه خود را در بخش Remote Target پیدا کنید.

    ابزار توسعه کروم (Chrome DevTools) صفحه‌ای را بررسی می‌کند که اهداف از راه دور موجود برای اشکال‌زدایی را نشان می‌دهد.
    شکل ۱. صفحه بازرسی Chrome DevTools که اهداف از راه دور موجود برای اشکال‌زدایی را نشان می‌دهد.
  4. کروم زیر نام دستگاه شما، تمام وب‌ویوهای دارای قابلیت اشکال‌زدایی که روی آن دستگاه اجرا می‌شوند را فهرست می‌کند که معمولاً با WebView در و به دنبال آن نام بسته برنامه مشخص می‌شوند. وب‌ویو مورد نظر برای اشکال‌زدایی را پیدا کنید و روی پیوند بازرسی کلیک کنید.

خواهید دید که یک نمونه جدید DevTools باز می‌شود که می‌توانید از آن برای بررسی WebView خود استفاده کنید.

اگر محتوا را از یک وب سرور محلی در دستگاه توسعه خود ارائه می‌دهید، برای یادگیری نحوه اتصال به آن از دستگاه یا شبیه‌ساز خود، به بخش دسترسی به یک سرور توسعه محلی از WebView مراجعه کنید. برای عیب‌یابی، به Remote debug دستگاه‌های اندروید و Remote debugging WebViews مراجعه کنید.