یک برنامه Wear OS را اشکال زدایی کنید

برای رفع اشکال برنامه Wear OS خود در ساعت فیزیکی، دستگاه توسعه خود را با استفاده از Wi-Fi یا بلوتوث به ساعت متصل کنید. از طرف دیگر، اگر ساعت شما دارای درگاه USB است، با استفاده از USB وصل کنید .

اگر برنامه شما به این پشتیبانی نیاز دارد، می‌توانید گردش‌های کاری را که چندین دستگاه مانند ساعت و تلفن را در بر می‌گیرد، آزمایش کنید. برای کسب اطلاعات بیشتر در مورد نحوه تنظیم اتصال برای آزمایش، از اتصال ساعت به تلفن دیدن کنید.

توجه: اگر ساعت فیزیکی ندارید، می توانید برنامه خود را روی شبیه ساز اندروید استودیو نیز تست و اجرا کنید .

به آخرین نسخه Wear OS به روز رسانی کنید

برای کمک به تأیید اینکه برنامه‌تان مطابق با آخرین نرم‌افزار مطابق انتظار عمل می‌کند، بررسی کنید که دستگاه آزمایشی شما از به‌روزترین نسخه Wear OS که دستگاهتان پشتیبانی می‌کند استفاده می‌کند.

برای بررسی به‌روزرسانی سیستم در دستگاه آزمایشی خود، این مراحل را کامل کنید:

1. دستگاه را به یک شبکه Wi-Fi وصل کنید.
2. شروع به شارژ دستگاه کنید.
3. صبر کنید تا باتری دستگاه تا 50 درصد یا بیشتر شارژ شود.

4. در دستگاه آزمایشی خود، به تنظیمات > سیستم > به‌روزرسانی‌های سیستم بروید.

   اگر به‌روزرسانی سیستم در دسترس باشد، بارگیری و در دستگاه آزمایشی شما نصب می‌شود.

نصب یک نسخه خاص از Wear OS (اختیاری)

اگر مورد آزمایشی برنامه شما به نسخه خاصی از Wear OS بستگی دارد، می‌توانید یک تصویر نرم‌افزاری را روی ساعت‌هایی فلش کنید که از اتصال داده USB پشتیبانی می‌کنند. به عنوان مثال، می‌توانید یک تصویر کارخانه یا یک تصویر کامل OTA را روی دستگاه Google Pixel Watch 3 یا Google Pixel Watch 2 فلش کنید.

گزینه های توسعه دهنده را در ساعت خود فعال کنید

قبل از اینکه بتوانید در ساعت خود اشکال زدایی کنید، گزینه های توسعه دهنده را فعال کنید. فقط یک بار باید این کار را انجام دهید. گزینه های برنامه نویس تا زمانی که آنها را غیرفعال نکنید فعال می مانند. برای فعال کردن گزینه های توسعه دهنده، موارد زیر را انجام دهید:

1. تنظیمات ساعت را باز کنید.
2. روی System > About > Versions ضربه بزنید.
3. هفت بار روی آیتم Build number ضربه بزنید.
4. پیامی ظاهر می شود که تأیید می کند شما اکنون یک توسعه دهنده هستید.

اشکال زدایی از طریق Wi-Fi

قبل از شروع، گزینه‌های برنامه‌نویس را روی ساعت فعال کنید، همانطور که قبلاً توضیح داده شد.

ساعت را به شبکه Wi-Fi وصل کنید

1. تنظیمات ساعت را باز کنید.
2. روی اتصال > Wi-Fi ضربه بزنید.
3. یک شبکه را انتخاب کنید و در صورت لزوم رمز عبور آن را وارد کنید.

   توجه: ساعت و دستگاه توسعه شما باید به یک شبکه متصل باشند. همه نقاط دسترسی مناسب نیستند. ممکن است لازم باشد از یک نقطه دسترسی استفاده کنید که فایروال آن به درستی برای پشتیبانی از adb پیکربندی شده است.

اشکال زدایی Wi-Fi را فعال کنید

1. تنظیمات ساعت را باز کنید.
2. روی گزینه‌های برنامه‌نویس > اشکال‌زدایی از طریق Wi-Fi ضربه بزنید.
3. پس از مدتی، صفحه نشانی IP ساعت مانند 192.168.1.100 را نشان می دهد. برای مرحله بعدی به این نیاز دارید، پس آن را یادداشت کنید.

دیباگر را با ساعت جفت کنید

1. در دستگاه Wear OS خود، گزینه های اشکال زدایی بی سیم را در تنظیمات سیستم پیدا کنید. جفت کردن دستگاه جدید را انتخاب کنید.
2. به کد جفت شدن Wi-Fi و آدرس IP و پورت توجه کنید.
3. در یک پنجره ترمینال در ماشین توسعه خود، دستور زیر را تایپ کنید:

   adb pair IP_ADDRESS:PORT
   

4. هنگامی که از شما خواسته شد، کد جفت شدن Wi-Fi را از مرحله 2 وارد کنید. ترمینال خروجی می دهد که آیا جفت شدن موفقیت آمیز بوده است یا خیر. به عنوان نمونه:

   Enter pairing code: 123456
   Successfully paired to 192.168.1.100:5555
   

پس از جفت شدن، رایانه میزبان در لیست دستگاه های جفت شده در صفحه اشکال زدایی بی سیم دستگاه Wear OS شما ظاهر می شود.

دیباگر را به ساعت وصل کنید

1. ساعت و دستگاه توسعه خود را به یک شبکه متصل کنید.

2. دیباگر را با استفاده از آدرس IP ساعت و شماره پورت به ساعت وصل کنید. به عنوان مثال، اگر آدرس IP 192.168.1.100 و شماره پورت 5555 باشد، دستور adb connect و پاسخ آن به این صورت است:

   adb connect 192.168.1.100:5555
   connected to 192.168.1.100:5555
   

اکنون ساعت به دیباگر متصل است و شما آماده شروع اشکال زدایی هستید. دستورات adb را با استفاده از پرچم -s به ساعت ارسال کنید و آدرس IP ساعت و شماره پورت را مشخص کنید:

adb -s 192.168.1.100:5555 <command>

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

adb <command>

اشکال زدایی از طریق بلوتوث

توجه : اشکال‌زدایی بلوتوث فقط برای ساعت‌های جفت‌شده با Android دارای سیستم عامل Wear OS 2 کار می‌کند.

قبل از شروع، ساعت و تلفن را جفت کنید و گزینه‌های برنامه‌نویس را در ساعت فعال کنید، همانطور که قبلا توضیح داده شد. با باز کردن منوی تنظیمات گوشی و جستجوی گزینه‌های برنامه‌نویس ، بررسی کنید که گزینه‌های برنامه‌نویس در تلفن فعال هستند. در صورت لزوم، گزینه های توسعه دهنده را در تلفن فعال کنید .

اشکال زدایی USB را در تلفن فعال کنید

1. منوی تنظیمات گوشی را باز کنید.
2. Developer Options را انتخاب کنید و اشکال زدایی USB را فعال کنید.

اشکال زدایی ADB یا بلوتوث را در ساعت فعال کنید

1. منوی تنظیمات ساعت را باز کنید.
2. به گزینه های برنامه نویس بروید.
3. تأیید کنید که اشکال زدایی ADB فعال است.
4. Debug از طریق بلوتوث را فعال کنید.

اشکال زدایی بلوتوث را در گوشی فعال کنید

1. در تلفن، برنامه همراه Wear OS را باز کنید.
2. به تنظیمات پیشرفته بروید و برای مشاهده گزینه های تنظیمات پیشرفته ضربه بزنید.
3. اشکال زدایی از طریق بلوتوث را فعال کنید. پیام وضعیت زیر زیر گزینه ظاهر می شود:

   Host: disconnected
   Target: connected
   

در این مرحله ماشین توسعه - میزبان - با ساعت - هدف ارتباط برقرار نمی کند. باید لینک را کامل کنید.

توجه : هر بار فقط می توانید با یک دستگاه اشکال زدایی کنید. اگر چندین ساعت جفت شده‌اید، اشکال‌زدایی بلوتوث فقط با دستگاهی که در صفحه اصلی انتخاب شده است فعال می‌شود.

دیباگر را به ساعت وصل کنید

در این مرحله نهایی، از همه چیز استفاده می کنید: اشکال زدا، تلفن و ساعت.

1. تلفن را با کابل USB به دستگاه توسعه خود وصل کنید.
2. این دو دستور را در دیباگر اجرا کنید:

   adb forward tcp:4444 localabstract:/adb-hub
   adb connect 127.0.0.1:4444
   

   توجه : باید از آدرس IP 127.0.0.1 استفاده کنید. از هر پورت موجود در ماشین توسعه خود استفاده کنید و از همان پورت در هر دو دستور استفاده کنید. در این مثال، پورت 4444 است.

3. پس از وارد کردن فرمان اتصال، ساعت از شما می‌خواهد تأیید کنید که به ADB Debugging اجازه می‌دهید.
4. در تلفن، نمایش وضعیت را در برنامه همراه Wear OS برای موارد زیر بررسی کنید:

   Host: connected
   Target: connected
   

اکنون ساعت به دیباگر متصل است و شما آماده شروع اشکال زدایی هستید.

وقتی ساعتی را با استفاده از بلوتوث اشکال زدایی می کنید، adb همیشه از آدرس IP 127.0.0.1 به اضافه پورتی که شما اختصاص می دهید استفاده می کند. در این مثال، پورت 4444 است. همه دستورات adb از فرمت زیر استفاده می کنند:

adb -s 127.0.0.1:4444 <command> 

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

adb <command>

از رکورد صفحه برای Wear OS استفاده کنید

اگر روی macOS توسعه می‌دهید، می‌توانید از ابزار اندروید پروژه GitHub برای مک برای ضبط ویدیو از دستگاه Wear OS خود استفاده کنید.

از طرف دیگر، با استفاده از مراحل زیر، یک ویدیو از دستگاه Wear OS خود ضبط کنید:

1. قاب های خام را روی ساعت ضبط کنید:

   adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw

2. فایل خام را در دستگاه توسعه خود کپی کنید:

   adb pull /sdcard/video.raw video.raw

3. برای تبدیل فایل خام به MP4 از ffmpeg استفاده کنید:

   ffmpeg -f rawvideo -vcodec rawvideo -s 400x400 -pix_fmt rgb24 -r 10 -i video.raw -an -c:v libx264 -pix_fmt yuv420p video.mp4

   توجه: برای دانلود و آموزش نصب به وب سایت FFmpeg مراجعه کنید.

به منابع مرتبط زیر مراجعه کنید:

• پل اشکال زدایی اندروید (adb)
• برنامه خود را اشکال زدایی کنید
• اصول طراحی
• از صفحات رابط کاربری Wear عکس بگیرید

،

برای رفع اشکال برنامه Wear OS خود در ساعت فیزیکی، دستگاه توسعه خود را با استفاده از Wi-Fi یا بلوتوث به ساعت متصل کنید. از طرف دیگر، اگر ساعت شما دارای درگاه USB است، با استفاده از USB وصل کنید .

اگر برنامه شما به این پشتیبانی نیاز دارد، می‌توانید گردش‌های کاری را که چندین دستگاه مانند ساعت و تلفن را در بر می‌گیرد، آزمایش کنید. برای کسب اطلاعات بیشتر در مورد نحوه تنظیم اتصال برای آزمایش، از اتصال ساعت به تلفن دیدن کنید.

توجه: اگر ساعت فیزیکی ندارید، می توانید برنامه خود را روی شبیه ساز اندروید استودیو نیز تست و اجرا کنید .

به آخرین نسخه Wear OS به روز رسانی کنید

برای کمک به تأیید اینکه برنامه‌تان مطابق با آخرین نرم‌افزار مطابق انتظار عمل می‌کند، بررسی کنید که دستگاه آزمایشی شما از به‌روزترین نسخه Wear OS که دستگاهتان پشتیبانی می‌کند استفاده می‌کند.

برای بررسی به‌روزرسانی سیستم در دستگاه آزمایشی خود، این مراحل را کامل کنید:

1. دستگاه را به یک شبکه Wi-Fi وصل کنید.
2. شروع به شارژ دستگاه کنید.
3. صبر کنید تا باتری دستگاه تا 50 درصد یا بیشتر شارژ شود.

4. در دستگاه آزمایشی خود، به تنظیمات > سیستم > به‌روزرسانی‌های سیستم بروید.

   اگر به‌روزرسانی سیستم در دسترس باشد، بارگیری و در دستگاه آزمایشی شما نصب می‌شود.

نصب یک نسخه خاص از Wear OS (اختیاری)

اگر مورد آزمایشی برنامه شما به نسخه خاصی از Wear OS بستگی دارد، می‌توانید یک تصویر نرم‌افزاری را روی ساعت‌هایی فلش کنید که از اتصال داده USB پشتیبانی می‌کنند. به عنوان مثال، می‌توانید یک تصویر کارخانه یا یک تصویر کامل OTA را روی دستگاه Google Pixel Watch 3 یا Google Pixel Watch 2 فلش کنید.

گزینه های توسعه دهنده را در ساعت خود فعال کنید

قبل از اینکه بتوانید در ساعت خود اشکال زدایی کنید، گزینه های توسعه دهنده را فعال کنید. فقط یک بار باید این کار را انجام دهید. گزینه های برنامه نویس تا زمانی که آنها را غیرفعال نکنید فعال می مانند. برای فعال کردن گزینه های توسعه دهنده، موارد زیر را انجام دهید:

1. تنظیمات ساعت را باز کنید.
2. روی System > About > Versions ضربه بزنید.
3. هفت بار روی آیتم Build number ضربه بزنید.
4. پیامی ظاهر می شود که تأیید می کند شما اکنون یک توسعه دهنده هستید.

اشکال زدایی از طریق Wi-Fi

قبل از شروع، گزینه‌های برنامه‌نویس را روی ساعت فعال کنید، همانطور که قبلاً توضیح داده شد.

ساعت را به شبکه Wi-Fi وصل کنید

1. تنظیمات ساعت را باز کنید.
2. روی اتصال > Wi-Fi ضربه بزنید.
3. یک شبکه را انتخاب کنید و در صورت لزوم رمز عبور آن را وارد کنید.

   توجه: ساعت و دستگاه توسعه شما باید به یک شبکه متصل باشند. همه نقاط دسترسی مناسب نیستند. ممکن است لازم باشد از یک نقطه دسترسی استفاده کنید که فایروال آن به درستی برای پشتیبانی از adb پیکربندی شده است.

اشکال زدایی Wi-Fi را فعال کنید

1. تنظیمات ساعت را باز کنید.
2. روی گزینه‌های برنامه‌نویس > اشکال‌زدایی از طریق Wi-Fi ضربه بزنید.
3. پس از مدتی، صفحه نشانی IP ساعت مانند 192.168.1.100 را نشان می دهد. برای مرحله بعدی به این نیاز دارید، پس آن را یادداشت کنید.

دیباگر را با ساعت جفت کنید

1. در دستگاه Wear OS خود، گزینه های اشکال زدایی بی سیم را در تنظیمات سیستم پیدا کنید. جفت کردن دستگاه جدید را انتخاب کنید.
2. به کد جفت شدن Wi-Fi و آدرس IP و پورت توجه کنید.
3. در یک پنجره ترمینال در ماشین توسعه خود، دستور زیر را تایپ کنید:

   adb pair IP_ADDRESS:PORT
   

4. هنگامی که از شما خواسته شد، کد جفت شدن Wi-Fi را از مرحله 2 وارد کنید. ترمینال خروجی می دهد که آیا جفت شدن موفقیت آمیز بوده است یا خیر. به عنوان نمونه:

   Enter pairing code: 123456
   Successfully paired to 192.168.1.100:5555
   

پس از جفت شدن، رایانه میزبان در لیست دستگاه های جفت شده در صفحه اشکال زدایی بی سیم دستگاه Wear OS شما ظاهر می شود.

دیباگر را به ساعت وصل کنید

1. ساعت و دستگاه توسعه خود را به یک شبکه متصل کنید.

2. دیباگر را با استفاده از آدرس IP ساعت و شماره پورت به ساعت وصل کنید. به عنوان مثال، اگر آدرس IP 192.168.1.100 و شماره پورت 5555 باشد، دستور adb connect و پاسخ آن به این صورت است:

   adb connect 192.168.1.100:5555
   connected to 192.168.1.100:5555
   

اکنون ساعت به دیباگر متصل است و شما آماده شروع اشکال زدایی هستید. دستورات adb را با استفاده از پرچم -s به ساعت ارسال کنید و آدرس IP ساعت و شماره پورت را مشخص کنید:

adb -s 192.168.1.100:5555 <command>

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

adb <command>

اشکال زدایی از طریق بلوتوث

توجه : اشکال‌زدایی بلوتوث فقط برای ساعت‌های جفت‌شده با Android دارای سیستم عامل Wear OS 2 کار می‌کند.

قبل از شروع، ساعت و تلفن را جفت کنید و گزینه‌های برنامه‌نویس را در ساعت فعال کنید، همانطور که قبلا توضیح داده شد. با باز کردن منوی تنظیمات گوشی و جستجوی گزینه‌های برنامه‌نویس ، بررسی کنید که گزینه‌های برنامه‌نویس در تلفن فعال هستند. در صورت لزوم، گزینه های توسعه دهنده را در تلفن فعال کنید .

اشکال زدایی USB را در تلفن فعال کنید

1. منوی تنظیمات گوشی را باز کنید.
2. Developer Options را انتخاب کنید و اشکال زدایی USB را فعال کنید.

اشکال زدایی ADB یا بلوتوث را در ساعت فعال کنید

1. منوی تنظیمات ساعت را باز کنید.
2. به گزینه های برنامه نویس بروید.
3. تأیید کنید که اشکال زدایی ADB فعال است.
4. Debug از طریق بلوتوث را فعال کنید.

اشکال زدایی بلوتوث را در گوشی فعال کنید

1. در تلفن، برنامه همراه Wear OS را باز کنید.
2. به تنظیمات پیشرفته بروید و برای مشاهده گزینه های تنظیمات پیشرفته ضربه بزنید.
3. اشکال زدایی از طریق بلوتوث را فعال کنید. پیام وضعیت زیر زیر گزینه ظاهر می شود:

   Host: disconnected
   Target: connected
   

در این مرحله ماشین توسعه - میزبان - با ساعت - هدف ارتباط برقرار نمی کند. باید لینک را کامل کنید.

توجه : هر بار فقط می توانید با یک دستگاه اشکال زدایی کنید. اگر چندین ساعت جفت شده‌اید، اشکال‌زدایی بلوتوث فقط با دستگاهی که در صفحه اصلی انتخاب شده است فعال می‌شود.

دیباگر را به ساعت وصل کنید

در این مرحله نهایی، از همه چیز استفاده می کنید: اشکال زدا، تلفن و ساعت.

1. تلفن را با کابل USB به دستگاه توسعه خود وصل کنید.
2. این دو دستور را در دیباگر اجرا کنید:

   adb forward tcp:4444 localabstract:/adb-hub
   adb connect 127.0.0.1:4444
   

   توجه : باید از آدرس IP 127.0.0.1 استفاده کنید. از هر پورت موجود در ماشین توسعه خود استفاده کنید و از همان پورت در هر دو دستور استفاده کنید. در این مثال، پورت 4444 است.

3. پس از وارد کردن فرمان اتصال، ساعت از شما می‌خواهد تأیید کنید که به ADB Debugging اجازه می‌دهید.
4. در تلفن، نمایش وضعیت را در برنامه همراه Wear OS برای موارد زیر بررسی کنید:

   Host: connected
   Target: connected
   

اکنون ساعت به دیباگر متصل است و شما آماده شروع اشکال زدایی هستید.

وقتی ساعتی را با استفاده از بلوتوث اشکال زدایی می کنید، adb همیشه از آدرس IP 127.0.0.1 به اضافه پورتی که شما اختصاص می دهید استفاده می کند. در این مثال، پورت 4444 است. همه دستورات adb از فرمت زیر استفاده می کنند:

adb -s 127.0.0.1:4444 <command> 

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

adb <command>

از رکورد صفحه برای Wear OS استفاده کنید

اگر روی macOS توسعه می‌دهید، می‌توانید از ابزار اندروید پروژه GitHub برای مک برای ضبط ویدیو از دستگاه Wear OS خود استفاده کنید.

از طرف دیگر، با استفاده از مراحل زیر، یک ویدیو از دستگاه Wear OS خود ضبط کنید:

1. قاب های خام را روی ساعت ضبط کنید:

   adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw

2. فایل خام را در دستگاه توسعه خود کپی کنید:

   adb pull /sdcard/video.raw video.raw

3. برای تبدیل فایل خام به MP4 از ffmpeg استفاده کنید:

   ffmpeg -f rawvideo -vcodec rawvideo -s 400x400 -pix_fmt rgb24 -r 10 -i video.raw -an -c:v libx264 -pix_fmt yuv420p video.mp4

   توجه: برای دانلود و آموزش نصب به وب سایت FFmpeg مراجعه کنید.

به منابع مرتبط زیر مراجعه کنید:

• پل اشکال زدایی اندروید (adb)
• برنامه خود را اشکال زدایی کنید
• اصول طراحی
• از صفحات رابط کاربری Wear عکس بگیرید

،

برای رفع اشکال برنامه Wear OS خود در ساعت فیزیکی، دستگاه توسعه خود را با استفاده از Wi-Fi یا بلوتوث به ساعت متصل کنید. از طرف دیگر، اگر ساعت شما دارای درگاه USB است، با استفاده از USB وصل کنید .

اگر برنامه شما به این پشتیبانی نیاز دارد، می‌توانید گردش‌های کاری را که چندین دستگاه مانند ساعت و تلفن را در بر می‌گیرد، آزمایش کنید. برای کسب اطلاعات بیشتر در مورد نحوه تنظیم اتصال برای آزمایش، از اتصال ساعت به تلفن دیدن کنید.

توجه: اگر ساعت فیزیکی ندارید، می توانید برنامه خود را روی شبیه ساز اندروید استودیو نیز تست و اجرا کنید .

به آخرین نسخه Wear OS به روز رسانی کنید

برای کمک به تأیید اینکه برنامه‌تان مطابق با آخرین نرم‌افزار مطابق انتظار عمل می‌کند، بررسی کنید که دستگاه آزمایشی شما از به‌روزترین نسخه Wear OS که دستگاهتان پشتیبانی می‌کند استفاده می‌کند.

برای بررسی به‌روزرسانی سیستم در دستگاه آزمایشی خود، این مراحل را کامل کنید:

1. دستگاه را به یک شبکه Wi-Fi وصل کنید.
2. شروع به شارژ دستگاه کنید.
3. صبر کنید تا باتری دستگاه تا 50 درصد یا بیشتر شارژ شود.

4. در دستگاه آزمایشی خود، به تنظیمات > سیستم > به‌روزرسانی‌های سیستم بروید.

   اگر به‌روزرسانی سیستم در دسترس باشد، بارگیری و در دستگاه آزمایشی شما نصب می‌شود.

نصب یک نسخه خاص از Wear OS (اختیاری)

اگر مورد آزمایشی برنامه شما به نسخه خاصی از Wear OS بستگی دارد، می‌توانید یک تصویر نرم‌افزاری را روی ساعت‌هایی فلش کنید که از اتصال داده USB پشتیبانی می‌کنند. به عنوان مثال، می‌توانید یک تصویر کارخانه یا یک تصویر کامل OTA را روی دستگاه Google Pixel Watch 3 یا Google Pixel Watch 2 فلش کنید.

گزینه های برنامه نویس را در ساعت خود فعال کنید

قبل از اینکه بتوانید در ساعت خود اشکال زدایی کنید، گزینه های توسعه دهنده را فعال کنید. فقط یک بار باید این کار را انجام دهید. گزینه های برنامه نویس تا زمانی که آنها را غیرفعال نکنید فعال می مانند. برای فعال کردن گزینه های توسعه دهنده، موارد زیر را انجام دهید:

1. تنظیمات ساعت را باز کنید.
2. روی System > About > Versions ضربه بزنید.
3. هفت بار روی آیتم Build number ضربه بزنید.
4. پیامی ظاهر می شود که تأیید می کند شما اکنون یک توسعه دهنده هستید.

اشکال زدایی از طریق Wi-Fi

قبل از شروع، گزینه‌های برنامه‌نویس را روی ساعت فعال کنید، همانطور که قبلاً توضیح داده شد.

ساعت را به شبکه Wi-Fi وصل کنید

1. تنظیمات ساعت را باز کنید.
2. روی اتصال > Wi-Fi ضربه بزنید.
3. یک شبکه را انتخاب کنید و در صورت لزوم رمز عبور آن را وارد کنید.

   توجه: ساعت و دستگاه توسعه شما باید به یک شبکه متصل باشند. همه نقاط دسترسی مناسب نیستند. ممکن است لازم باشد از یک نقطه دسترسی استفاده کنید که فایروال آن به درستی برای پشتیبانی از adb پیکربندی شده است.

اشکال زدایی Wi-Fi را فعال کنید

1. تنظیمات ساعت را باز کنید.
2. روی گزینه‌های برنامه‌نویس > اشکال‌زدایی از طریق Wi-Fi ضربه بزنید.
3. پس از مدتی، صفحه نشانی IP ساعت مانند 192.168.1.100 را نشان می دهد. برای مرحله بعدی به این نیاز دارید، پس آن را یادداشت کنید.

دیباگر را با ساعت جفت کنید

1. در دستگاه Wear OS خود، گزینه های اشکال زدایی بی سیم را در تنظیمات سیستم پیدا کنید. جفت کردن دستگاه جدید را انتخاب کنید.
2. به کد جفت شدن Wi-Fi و آدرس IP و پورت توجه کنید.
3. در یک پنجره ترمینال در ماشین توسعه خود، دستور زیر را تایپ کنید:

   adb pair IP_ADDRESS:PORT
   

4. هنگامی که از شما خواسته شد، کد جفت شدن Wi-Fi را از مرحله 2 وارد کنید. ترمینال خروجی می دهد که آیا جفت شدن موفقیت آمیز بوده است یا خیر. به عنوان نمونه:

   Enter pairing code: 123456
   Successfully paired to 192.168.1.100:5555
   

پس از جفت شدن، رایانه میزبان در لیست دستگاه های جفت شده در صفحه اشکال زدایی بی سیم دستگاه Wear OS شما ظاهر می شود.

دیباگر را به ساعت وصل کنید

1. ساعت و دستگاه توسعه خود را به یک شبکه متصل کنید.

2. دیباگر را با استفاده از آدرس IP ساعت و شماره پورت به ساعت وصل کنید. به عنوان مثال، اگر آدرس IP 192.168.1.100 و شماره پورت 5555 باشد، دستور adb connect و پاسخ آن به این صورت است:

   adb connect 192.168.1.100:5555
   connected to 192.168.1.100:5555
   

اکنون ساعت به دیباگر متصل است و شما آماده شروع اشکال زدایی هستید. دستورات adb را با استفاده از پرچم -s به ساعت ارسال کنید و آدرس IP ساعت و شماره پورت را مشخص کنید:

adb -s 192.168.1.100:5555 <command>

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

adb <command>

اشکال زدایی از طریق بلوتوث

توجه : اشکال‌زدایی بلوتوث فقط برای ساعت‌های جفت‌شده با Android دارای سیستم عامل Wear OS 2 کار می‌کند.

قبل از شروع، ساعت و تلفن را جفت کنید و گزینه‌های برنامه‌نویس را در ساعت فعال کنید، همانطور که قبلا توضیح داده شد. با باز کردن منوی تنظیمات گوشی و جستجوی گزینه‌های برنامه‌نویس ، بررسی کنید که گزینه‌های برنامه‌نویس در تلفن فعال هستند. در صورت لزوم، گزینه های توسعه دهنده را در تلفن فعال کنید .

اشکال زدایی USB را در تلفن فعال کنید

1. منوی تنظیمات گوشی را باز کنید.
2. Developer Options را انتخاب کنید و اشکال زدایی USB را فعال کنید.

اشکال زدایی ADB یا بلوتوث را در ساعت فعال کنید

1. منوی تنظیمات ساعت را باز کنید.
2. به گزینه های برنامه نویس بروید.
3. تأیید کنید که اشکال زدایی ADB فعال است.
4. Debug از طریق بلوتوث را فعال کنید.

اشکال زدایی بلوتوث را در گوشی فعال کنید

1. در تلفن، برنامه همراه Wear OS را باز کنید.
2. به تنظیمات پیشرفته بروید و برای مشاهده گزینه های تنظیمات پیشرفته ضربه بزنید.
3. اشکال زدایی از طریق بلوتوث را فعال کنید. پیام وضعیت زیر زیر گزینه ظاهر می شود:

   Host: disconnected
   Target: connected
   

در این مرحله ماشین توسعه - میزبان - با ساعت - هدف ارتباط برقرار نمی کند. باید لینک را کامل کنید.

توجه : هر بار فقط می توانید با یک دستگاه اشکال زدایی کنید. اگر چندین ساعت جفت شده‌اید، اشکال‌زدایی بلوتوث فقط با دستگاهی که در صفحه اصلی انتخاب شده است فعال می‌شود.

دیباگر را به ساعت وصل کنید

در این مرحله نهایی، از همه چیز استفاده می کنید: اشکال زدا، تلفن و ساعت.

1. تلفن را با کابل USB به دستگاه توسعه خود وصل کنید.
2. این دو دستور را در دیباگر اجرا کنید:

   adb forward tcp:4444 localabstract:/adb-hub
   adb connect 127.0.0.1:4444
   

   توجه : باید از آدرس IP 127.0.0.1 استفاده کنید. از هر پورت موجود در ماشین توسعه خود استفاده کنید و از همان پورت در هر دو دستور استفاده کنید. در این مثال، پورت 4444 است.

3. پس از وارد کردن فرمان اتصال، ساعت از شما می‌خواهد تأیید کنید که به ADB Debugging اجازه می‌دهید.
4. در تلفن، نمایش وضعیت را در برنامه همراه Wear OS برای موارد زیر بررسی کنید:

   Host: connected
   Target: connected
   

اکنون ساعت به دیباگر متصل است و شما آماده شروع اشکال زدایی هستید.

وقتی ساعتی را با استفاده از بلوتوث اشکال زدایی می کنید، adb همیشه از آدرس IP 127.0.0.1 به اضافه پورتی که شما اختصاص می دهید استفاده می کند. در این مثال، پورت 4444 است. همه دستورات adb از فرمت زیر استفاده می کنند:

adb -s 127.0.0.1:4444 <command> 

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

adb <command>

از رکورد صفحه برای Wear OS استفاده کنید

اگر روی macOS توسعه می‌دهید، می‌توانید از ابزار اندروید پروژه GitHub برای مک برای ضبط ویدیو از دستگاه Wear OS خود استفاده کنید.

از طرف دیگر، با استفاده از مراحل زیر، یک ویدیو از دستگاه Wear OS خود ضبط کنید:

1. قاب های خام را روی ساعت ضبط کنید:

   adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw

2. فایل خام را در دستگاه توسعه خود کپی کنید:

   adb pull /sdcard/video.raw video.raw

3. برای تبدیل فایل خام به MP4 از ffmpeg استفاده کنید:

   ffmpeg -f rawvideo -vcodec rawvideo -s 400x400 -pix_fmt rgb24 -r 10 -i video.raw -an -c:v libx264 -pix_fmt yuv420p video.mp4

   توجه: برای دانلود و آموزش نصب به وب سایت FFmpeg مراجعه کنید.

به منابع مرتبط زیر مراجعه کنید:

• پل اشکال زدایی اندروید (adb)
• برنامه خود را اشکال زدایی کنید
• اصول طراحی
• از صفحات رابط کاربری Wear عکس بگیرید

،

برای رفع اشکال برنامه Wear OS خود در ساعت فیزیکی، دستگاه توسعه خود را با استفاده از Wi-Fi یا بلوتوث به ساعت متصل کنید. از طرف دیگر، اگر ساعت شما دارای درگاه USB است، با استفاده از USB وصل کنید .

اگر برنامه شما به این پشتیبانی نیاز دارد، می‌توانید گردش‌های کاری را که چندین دستگاه مانند ساعت و تلفن را در بر می‌گیرد، آزمایش کنید. برای کسب اطلاعات بیشتر در مورد نحوه تنظیم اتصال برای آزمایش، از اتصال ساعت به تلفن دیدن کنید.

توجه: اگر ساعت فیزیکی ندارید، می توانید برنامه خود را روی شبیه ساز اندروید استودیو نیز تست و اجرا کنید .

به آخرین نسخه Wear OS به روز رسانی کنید

برای کمک به تأیید اینکه برنامه‌تان مطابق با آخرین نرم‌افزار مطابق انتظار عمل می‌کند، بررسی کنید که دستگاه آزمایشی شما از به‌روزترین نسخه Wear OS که دستگاهتان پشتیبانی می‌کند استفاده می‌کند.

برای بررسی به‌روزرسانی سیستم در دستگاه آزمایشی خود، این مراحل را کامل کنید:

1. دستگاه را به یک شبکه Wi-Fi وصل کنید.
2. شروع به شارژ دستگاه کنید.
3. صبر کنید تا باتری دستگاه تا 50 درصد یا بیشتر شارژ شود.

4. در دستگاه آزمایشی خود، به تنظیمات > سیستم > به‌روزرسانی‌های سیستم بروید.

   اگر به‌روزرسانی سیستم در دسترس باشد، بارگیری و در دستگاه آزمایشی شما نصب می‌شود.

نصب یک نسخه خاص از Wear OS (اختیاری)

اگر مورد آزمایشی برنامه شما به نسخه خاصی از Wear OS بستگی دارد، می‌توانید یک تصویر نرم‌افزاری را روی ساعت‌هایی فلش کنید که از اتصال داده USB پشتیبانی می‌کنند. به عنوان مثال، می‌توانید یک تصویر کارخانه یا یک تصویر کامل OTA را روی دستگاه Google Pixel Watch 3 یا Google Pixel Watch 2 فلش کنید.

گزینه های توسعه دهنده را در ساعت خود فعال کنید

قبل از اینکه بتوانید در ساعت خود اشکال زدایی کنید، گزینه های توسعه دهنده را فعال کنید. فقط یک بار باید این کار را انجام دهید. گزینه های برنامه نویس تا زمانی که آنها را غیرفعال نکنید فعال می مانند. برای فعال کردن گزینه های توسعه دهنده، موارد زیر را انجام دهید:

1. تنظیمات ساعت را باز کنید.
2. روی System > About > Versions ضربه بزنید.
3. هفت بار روی آیتم Build number ضربه بزنید.
4. پیامی ظاهر می شود که تأیید می کند شما اکنون یک توسعه دهنده هستید.

اشکال زدایی از طریق Wi-Fi

قبل از شروع، گزینه‌های برنامه‌نویس را روی ساعت فعال کنید، همانطور که قبلاً توضیح داده شد.

ساعت را به شبکه Wi-Fi وصل کنید

1. تنظیمات ساعت را باز کنید.
2. روی اتصال > Wi-Fi ضربه بزنید.
3. یک شبکه را انتخاب کنید و در صورت لزوم رمز عبور آن را وارد کنید.

   توجه: ساعت و دستگاه توسعه شما باید به یک شبکه متصل باشند. همه نقاط دسترسی مناسب نیستند. ممکن است لازم باشد از یک نقطه دسترسی استفاده کنید که فایروال آن به درستی برای پشتیبانی از adb پیکربندی شده است.

اشکال زدایی Wi-Fi را فعال کنید

1. تنظیمات ساعت را باز کنید.
2. روی گزینه‌های برنامه‌نویس > اشکال‌زدایی از طریق Wi-Fi ضربه بزنید.
3. پس از مدتی، صفحه نشانی IP ساعت مانند 192.168.1.100 را نشان می دهد. برای مرحله بعدی به این نیاز دارید، پس آن را یادداشت کنید.

دیباگر را با ساعت جفت کنید

1. در دستگاه Wear OS خود، گزینه های اشکال زدایی بی سیم را در تنظیمات سیستم پیدا کنید. جفت کردن دستگاه جدید را انتخاب کنید.
2. به کد جفت شدن Wi-Fi و آدرس IP و پورت توجه کنید.
3. در یک پنجره ترمینال در ماشین توسعه خود، دستور زیر را تایپ کنید:

   adb pair IP_ADDRESS:PORT
   

4. هنگامی که از شما خواسته شد، کد جفت شدن Wi-Fi را از مرحله 2 وارد کنید. ترمینال خروجی می دهد که آیا جفت شدن موفقیت آمیز بوده است یا خیر. به عنوان نمونه:

   Enter pairing code: 123456
   Successfully paired to 192.168.1.100:5555
   

پس از جفت شدن، رایانه میزبان در لیست دستگاه های جفت شده در صفحه اشکال زدایی بی سیم دستگاه Wear OS شما ظاهر می شود.

دیباگر را به ساعت وصل کنید

1. ساعت و دستگاه توسعه خود را به یک شبکه متصل کنید.

2. دیباگر را با استفاده از آدرس IP ساعت و شماره پورت به ساعت وصل کنید. به عنوان مثال، اگر آدرس IP 192.168.1.100 و شماره پورت 5555 باشد، دستور adb connect و پاسخ آن به این صورت است:

   adb connect 192.168.1.100:5555
   connected to 192.168.1.100:5555
   

اکنون ساعت به دیباگر متصل است و شما آماده شروع اشکال زدایی هستید. دستورات adb را با استفاده از پرچم -s به ساعت ارسال کنید و آدرس IP ساعت و شماره پورت را مشخص کنید:

adb -s 192.168.1.100:5555 <command>

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

adb <command>

اشکال زدایی از طریق بلوتوث

توجه : اشکال‌زدایی بلوتوث فقط برای ساعت‌های جفت‌شده با Android دارای سیستم عامل Wear OS 2 کار می‌کند.

قبل از شروع، ساعت و تلفن را جفت کنید و گزینه‌های برنامه‌نویس را در ساعت فعال کنید، همانطور که قبلا توضیح داده شد. با باز کردن منوی تنظیمات گوشی و جستجوی گزینه‌های برنامه‌نویس ، بررسی کنید که گزینه‌های برنامه‌نویس در تلفن فعال هستند. در صورت لزوم، گزینه های توسعه دهنده را در تلفن فعال کنید .

اشکال زدایی USB را در تلفن فعال کنید

1. منوی تنظیمات گوشی را باز کنید.
2. Developer Options را انتخاب کنید و اشکال زدایی USB را فعال کنید.

اشکال زدایی ADB یا بلوتوث را در ساعت فعال کنید

1. منوی تنظیمات ساعت را باز کنید.
2. به گزینه های برنامه نویس بروید.
3. تأیید کنید که اشکال زدایی ADB فعال است.
4. Debug از طریق بلوتوث را فعال کنید.

اشکال زدایی بلوتوث را در گوشی فعال کنید

1. در تلفن، برنامه همراه Wear OS را باز کنید.
2. به تنظیمات پیشرفته بروید و برای مشاهده گزینه های تنظیمات پیشرفته ضربه بزنید.
3. اشکال زدایی از طریق بلوتوث را فعال کنید. پیام وضعیت زیر زیر گزینه ظاهر می شود:

   Host: disconnected
   Target: connected
   

در این مرحله ماشین توسعه - میزبان - با ساعت - هدف ارتباط برقرار نمی کند. شما باید لینک را کامل کنید.

توجه : هر بار فقط می توانید با یک دستگاه اشکال زدایی کنید. اگر چندین ساعت جفت شده‌اید، اشکال‌زدایی بلوتوث فقط با دستگاهی که در صفحه اصلی انتخاب شده است فعال می‌شود.

دیباگر را به ساعت وصل کنید

در این مرحله نهایی، از همه چیز استفاده می کنید: اشکال زدا، تلفن و ساعت.

1. تلفن را با کابل USB به دستگاه توسعه خود وصل کنید.
2. این دو دستور را در دیباگر اجرا کنید:

   adb forward tcp:4444 localabstract:/adb-hub
   adb connect 127.0.0.1:4444
   

   توجه : باید از آدرس IP 127.0.0.1 استفاده کنید. از هر پورت موجود در ماشین توسعه خود استفاده کنید و از همان پورت در هر دو دستور استفاده کنید. در این مثال، پورت 4444 است.

3. پس از وارد کردن فرمان اتصال، ساعت از شما می‌خواهد تأیید کنید که به ADB Debugging اجازه می‌دهید.
4. در تلفن، نمایش وضعیت را در برنامه همراه Wear OS برای موارد زیر بررسی کنید:

   Host: connected
   Target: connected
   

اکنون ساعت به دیباگر متصل است و شما آماده شروع اشکال زدایی هستید.

وقتی ساعتی را با استفاده از بلوتوث اشکال زدایی می کنید، adb همیشه از آدرس IP 127.0.0.1 به اضافه پورتی که شما اختصاص می دهید استفاده می کند. در این مثال، پورت 4444 است. همه دستورات adb از فرمت زیر استفاده می کنند:

adb -s 127.0.0.1:4444 <command> 

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

adb <command>

از رکورد صفحه برای Wear OS استفاده کنید

اگر روی macOS توسعه می‌دهید، می‌توانید از ابزار اندروید پروژه GitHub برای مک برای ضبط ویدیو از دستگاه Wear OS خود استفاده کنید.

از طرف دیگر، با استفاده از مراحل زیر، یک ویدیو از دستگاه Wear OS خود ضبط کنید:

1. قاب های خام را روی ساعت ضبط کنید:

   adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw

2. فایل خام را در دستگاه توسعه خود کپی کنید:

   adb pull /sdcard/video.raw video.raw

3. برای تبدیل فایل خام به MP4 از ffmpeg استفاده کنید:

   ffmpeg -f rawvideo -vcodec rawvideo -s 400x400 -pix_fmt rgb24 -r 10 -i video.raw -an -c:v libx264 -pix_fmt yuv420p video.mp4

   توجه: برای دانلود و آموزش نصب به وب سایت FFmpeg مراجعه کنید.

به منابع مرتبط زیر مراجعه کنید:

• پل اشکال زدایی اندروید (adb)
• برنامه خود را اشکال زدایی کنید
• اصول طراحی
• از صفحات رابط کاربری Wear عکس بگیرید