بیدار شدن بیش از حد

Wakeups مکانیزمی در AlarmManager API است که به توسعه دهندگان اجازه می دهد زنگ هشداری را برای بیدار کردن دستگاه در یک زمان مشخص تنظیم کنند. برنامه شما با فراخوانی یکی از متدهای set() در AlarmManager با پرچم RTC_WAKEUP یا ELAPSED_REALTIME_WAKEUP ، زنگ بیداری تنظیم می کند. هنگامی که زنگ بیداری راه اندازی می شود، دستگاه از حالت کم مصرف خارج می شود و در حین اجرای روش onReceive() یا onAlarm() زنگ، یک قفل بیدار جزئی را نگه می دارد. اگر هشدارهای بیداری بیش از حد فعال شوند، می توانند باتری دستگاه را تخلیه کنند.

برای کمک به بهبود کیفیت برنامه، Android به‌طور خودکار برنامه‌ها را برای هشدارهای بیش از حد بیدار شدن کنترل می‌کند و اطلاعات موجود در Android vitals را نمایش می‌دهد. برای اطلاعات در مورد نحوه جمع‌آوری داده‌ها، به اسناد کنسول Play مراجعه کنید.

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

مشکل را برطرف کنید

AlarmManager در نسخه‌های اولیه پلتفرم اندروید معرفی شد، اما با گذشت زمان، بسیاری از موارد استفاده که قبلاً به AlarmManager نیاز داشتند، اکنون توسط ویژگی‌های جدیدتری مانند WorkManager بهتر ارائه می‌شوند. این بخش حاوی نکاتی برای کاهش هشدارهای بیدار شدن است، اما در دراز مدت، برنامه خود را برای پیروی از توصیه‌های بخش بهترین شیوه‌ها مهاجرت کنید.

مکان‌هایی را در برنامه‌تان شناسایی کنید که در آن‌ها زنگ‌های بیداری را برنامه‌ریزی می‌کنید و فرکانس فعال شدن آن زنگ‌ها را کاهش دهید. در اینجا چند نکته وجود دارد:

• به دنبال فراخوانی متدهای مختلف set() در AlarmManager باشید که شامل پرچم RTC_WAKEUP یا ELAPSED_REALTIME_WAKEUP است.

• توصیه می کنیم نام بسته، کلاس یا روش خود را در نام برچسب زنگ هشدار خود وارد کنید تا بتوانید به راحتی مکان را در منبع خود که زنگ تنظیم شده است شناسایی کنید. در اینجا چند نکته اضافی وجود دارد:

  • هرگونه اطلاعات شناسایی شخصی (PII) را در نام، مانند آدرس ایمیل، کنار بگذارید. در غیر این صورت، دستگاه به جای نام زنگ هشدار _UNKNOWN را ثبت می کند.
  • نام کلاس یا متد را به صورت برنامه‌نویسی دریافت نکنید، برای مثال با فراخوانی getName() زیرا ممکن است توسط Proguard مبهم شود. به جای آن از یک رشته رمزگذاری شده استفاده کنید.
  • شمارنده یا شناسه‌های منحصربه‌فرد را به برچسب‌های هشدار اضافه نکنید. این سیستم نمی تواند آلارم هایی را که به این صورت تنظیم شده اند جمع کند زیرا همه آنها دارای شناسه های منحصر به فرد هستند.

پس از رفع مشکل، با اجرای دستور ADB زیر بررسی کنید که آلارم‌های بیدارباش مطابق انتظار کار می‌کنند:

adb shell dumpsys alarm

این دستور اطلاعاتی در مورد وضعیت سرویس سیستم دزدگیر در دستگاه ارائه می دهد. برای اطلاعات بیشتر، dumpsys را ببینید.

بهترین شیوه ها

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

از AlarmManager برای برنامه‌ریزی وظایف پس‌زمینه، به‌ویژه کارهای تکراری یا پس‌زمینه شبکه استفاده نکنید. از WorkManager برای برنامه‌ریزی وظایف پس‌زمینه استفاده کنید زیرا مزایای زیر را ارائه می‌کند:

• بچینگ - کارها با هم ترکیب می شوند تا مصرف باتری کاهش یابد
• پایداری - اگر دستگاه راه اندازی مجدد شود، کارهای برنامه ریزی شده WorkManager پس از اتمام راه اندازی مجدد اجرا می شوند.
• معیارها - مشاغل می توانند بر اساس شرایط اجرا شوند، مانند اینکه آیا دستگاه شارژ می شود یا نه یا WiFi در دسترس است

برای اطلاعات بیشتر، به راهنمای پردازش پس‌زمینه مراجعه کنید.

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