توفّر WorkManager واجهات برمجة تطبيقات لاختبار Worker وListenableWorker وأنواع ListenableWorker (CoroutineWorker وRxWorker).
اختبار العاملين
لنفترض أنّ لدينا Worker على النحو التالي:
class SleepWorker(context: Context, parameters: WorkerParameters) : Worker(context, parameters) { override fun doWork(): Result { // Sleep on a background thread. Thread.sleep(1000) return Result.success() } }
لاختبار Worker، يمكنك استخدام
TestWorkerBuilder. تساعد أداة الإنشاء هذه في إنشاء نُسخ من Worker يمكن استخدامها لاختبار منطق النشاط التجاري.
// Kotlin code uses the TestWorkerBuilder extension to build // the Worker @RunWith(AndroidJUnit4::class) class SleepWorkerTest { private lateinit var context: Context private lateinit var executor: Executor @Before fun setUp() { context = ApplicationProvider.getApplicationContext() executor = Executors.newSingleThreadExecutor() } @Test fun testSleepWorker() { val worker = TestWorkerBuilder<SleepWorker>( context = context, executor = executor ).build() val result = worker.doWork() assertThat(result, `is`(Result.success())) } }
يمكن أيضًا استخدام TestWorkerBuilder لضبط العلامات، مثل inputData أو runAttemptCount، لكي تتمكّن من التحقّق من حالة العامل بشكل منفصل. لنفترض أنّ SleepWorker يتلقّى مدة النوم كبيانات إدخال بدلاً من أن تكون ثابتة ومحدّدة في العامل:
class SleepWorker(context: Context, parameters: WorkerParameters) : Worker(context, parameters) { override fun doWork(): Result { // Sleep on a background thread. val sleepDuration = inputData.getLong(SLEEP_DURATION, 1000) Thread.sleep(sleepDuration) return Result.success() } companion object { const val SLEEP_DURATION = "SLEEP_DURATION" } }
في SleepWorkerTest، يمكنك تقديم بيانات الإدخال هذه إلى
TestWorkerBuilder لتلبية احتياجات SleepWorker.
// Kotlin code uses the TestWorkerBuilder extension to build // the Worker @RunWith(AndroidJUnit4::class) class SleepWorkerTest { private lateinit var context: Context private lateinit var executor: Executor @Before fun setUp() { context = ApplicationProvider.getApplicationContext() executor = Executors.newSingleThreadExecutor() } @Test fun testSleepWorker() { val worker = TestWorkerBuilder<SleepWorker>( context = context, executor = executor, inputData = workDataOf("SLEEP_DURATION" to 1000L) ).build() val result = worker.doWork() assertThat(result, `is`(Result.success())) } }
لمزيد من التفاصيل حول واجهة برمجة التطبيقات TestWorkerBuilder، يُرجى الاطّلاع على الصفحة المرجعية لـ TestListenableWorkerBuilder، وهي الفئة الفائقة لـ TestWorkerBuilder.
اختبار ListenableWorker ومتغيّراته
لاختبار ListenableWorker أو صيغه (CoroutineWorker وRxWorker)، استخدِم TestListenableWorkerBuilder.
يتمثّل الاختلاف الرئيسي بين TestWorkerBuilder وTestListenableWorkerBuilder في أنّ TestWorkerBuilder يتيح لك تحديد Executor في الخلفية المستخدَم لتشغيل Worker، بينما يعتمد TestListenableWorkerBuilder على منطق سلسلة التعليمات لتنفيذ ListenableWorker.
على سبيل المثال، لنفترض أنّنا بحاجة إلى اختبار CoroutineWorker على النحو التالي:
class SleepWorker(context: Context, parameters: WorkerParameters) : CoroutineWorker(context, parameters) { override suspend fun doWork(): Result { delay(1000L) // milliseconds return Result.success() } }
لاختبار SleepWorker، ننشئ أولاً مثيلاً من Worker باستخدام
TestListenableWorkerBuilder ثم نستدعي دالة doWork ضمن
روتين مشترك.
@RunWith(AndroidJUnit4::class) class SleepWorkerTest { private lateinit var context: Context @Before fun setUp() { context = ApplicationProvider.getApplicationContext() } @Test fun testSleepWorker() { val worker = TestListenableWorkerBuilder<SleepWorker>(context).build() runBlocking { val result = worker.doWork() assertThat(result, `is`(Result.success())) } } }
يُعدّ runBlocking مناسبًا كأداة إنشاء دالة كوروتين للاختبارات، بحيث يتم تشغيل أي رمز برمجي
يتم تنفيذه بشكل غير متزامن بالتوازي بدلاً من ذلك.
يشبه اختبار تنفيذ RxWorker اختبار CoroutineWorker، لأنّ TestListenableWorkerBuilder يمكنه التعامل مع أي فئة فرعية من ListenableWorker.
لنفترض أنّ هناك إصدارًا من SleepWorker يستخدم RxJava بدلاً من الروتينات المشتركة.
class SleepWorker( context: Context, parameters: WorkerParameters ) : RxWorker(context, parameters) { override fun createWork(): Single<Result> { return Single.just(Result.success()) .delay(1000L, TimeUnit.MILLISECONDS) } }
قد يبدو إصدار SleepWorkerTest الذي يختبر RxWorker مشابهًا للإصدار الذي اختبر CoroutineWorker. يمكنك استخدام
TestListenableWorkerBuilder نفسه، ولكن يمكنك الآن استدعاء دالة createWork في RxWorker. تعرض الدالة createWork قيمة من النوع Single يمكنك استخدامها للتحقّق من
سلوك العامل. يتولّى TestListenableWorkerBuilder معالجة أي تعقيدات في سلاسل المحادثات وينفّذ رمز العامل بشكل متوازٍ.
@RunWith(AndroidJUnit4::class) class SleepWorkerTest { private lateinit var context: Context @Before fun setUp() { context = ApplicationProvider.getApplicationContext() } @Test fun testSleepWorker() { val worker = TestListenableWorkerBuilder<SleepWorker>(context).build() worker.createWork().subscribe { result -> assertThat(result, `is`(Result.success())) } } }