হেলথ কানেক্ট টেস্টিং লাইব্রেরি ব্যবহার করে ইউনিট পরীক্ষা তৈরি করুন

হেলথ কানেক্ট টেস্টিং লাইব্রেরি ( androidx.health.connect:connect-testing ) স্বয়ংক্রিয় পরীক্ষা তৈরিকে সহজ করে। আপনি এই লাইব্রেরিটি ব্যবহার করে আপনার অ্যাপ্লিকেশনের আচরণ যাচাই করতে পারেন এবং যাচাই করতে পারেন যে এটি অস্বাভাবিক ক্ষেত্রে সঠিকভাবে সাড়া দেয়, যা ম্যানুয়ালি পরীক্ষা করা কঠিন।

আপনি স্থানীয় ইউনিট পরীক্ষা তৈরি করতে লাইব্রেরি ব্যবহার করতে পারেন, যা সাধারণত আপনার অ্যাপের ক্লাসের আচরণ যাচাই করে যা Health Connect ক্লায়েন্টের সাথে ইন্টারঅ্যাক্ট করে।

লাইব্রেরি ব্যবহার শুরু করতে, এটি একটি পরীক্ষা নির্ভরতা হিসাবে যোগ করুন:

 testImplementation("androidx.health.connect:connect-testing:1.0.0-alpha01")

লাইব্রেরির এন্ট্রি পয়েন্টটি হল FakeHealthConnectClient ক্লাস, যা আপনি HealthConnectClient প্রতিস্থাপন করতে পরীক্ষায় ব্যবহার করেন। FakeHealthConnectClient নিম্নলিখিত বৈশিষ্ট্য রয়েছে:

• রেকর্ডগুলির একটি ইন-মেমরি উপস্থাপনা, যাতে আপনি সেগুলি ঢোকাতে, সরাতে, মুছতে এবং পড়তে পারেন৷
• পরিবর্তন টোকেন তৈরি এবং ট্র্যাকিং পরিবর্তন
• রেকর্ড এবং পরিবর্তনের জন্য পৃষ্ঠা সংখ্যা
• একত্রিত প্রতিক্রিয়া স্টাবগুলির সাথে সমর্থিত
• যেকোনো ফাংশনকে ব্যতিক্রম নিক্ষেপ করার অনুমতি দেয়
• একটি FakePermissionController যা অনুমতি চেক অনুকরণ করতে ব্যবহার করা যেতে পারে

পরীক্ষায় নির্ভরতা প্রতিস্থাপন সম্পর্কে আরও জানতে, Android এ নির্ভরতা ইনজেকশন পড়ুন। জাল সম্পর্কে আরও জানতে, অ্যান্ড্রয়েডে টেস্ট ডাবল ব্যবহার করা পড়ুন।

উদাহরণস্বরূপ, যদি ক্লায়েন্টের সাথে ইন্টারঅ্যাক্ট করে এমন ক্লাসটিকে HealthConnectManager বলা হয় এবং এটি নির্ভরতা হিসাবে একটি HealthConnectClient নেয়, তাহলে এটি দেখতে হবে:

class HealthConnectManager(
    private val healthConnectClient: HealthConnectClient,
    ...
) { }

পরীক্ষায়, আপনি পরিবর্তে পরীক্ষার অধীনে আপনার ক্লাসে একটি জাল পাস করতে পারেন:

import androidx.health.connect.client.testing.ExperimentalTestingApi
import androidx.health.connect.client.testing.FakeHealthConnectClient
import kotlinx.coroutines.test.runTest

@OptIn(ExperimentalTestingApi::class)
class HealthConnectManagerTest {

    @Test
    fun readRecords_filterByActivity() = runTest {
        // Create a Fake with 2 running records.
        val fake = FakeHealthConnectClient()
        fake.insertRecords(listOf(fakeRunRecord1, fakeBikeRecord1))

        // Create a manager that depends on the fake.
        val manager = HealthConnectManager(fake)

        // Read running records only.
        val runningRecords = manager.fetchReport(activity = Running)

        // Verify that the records were filtered correctly.
        assertTrue(runningRecords.size == 1)
    }
}

এই পরীক্ষাটি যাচাই করে যে HealthConnectManager এ কাল্পনিক fetchReport ফাংশন কার্যকলাপ দ্বারা রেকর্ডগুলিকে সঠিকভাবে ফিল্টার করে৷

ব্যতিক্রম যাচাই করা হচ্ছে

HealthConnectClient এ প্রায় প্রতিটি কল ব্যতিক্রম হতে পারে। উদাহরণস্বরূপ, insertRecords এর ডকুমেন্টেশন এই ব্যতিক্রমগুলি উল্লেখ করে:

• @throws android.os.RemoteException যেকোনো IPC পরিবহন ব্যর্থতার জন্য।
• @অনুমোদিত অ্যাক্সেসের অনুরোধের জন্য @throws SecurityException ।
• যেকোনো ডিস্ক I/O সমস্যার জন্য @throws java.io.IOException ।

এই ব্যতিক্রমগুলি একটি খারাপ সংযোগ বা ডিভাইসে কোনও স্থান অবশিষ্ট না থাকার মতো কেসগুলি কভার করে৷ আপনার অ্যাপকে অবশ্যই এই রানটাইম সমস্যাগুলির জন্য সঠিকভাবে প্রতিক্রিয়া জানাতে হবে, কারণ সেগুলি যেকোনো সময় ঘটতে পারে।

import androidx.health.connect.client.testing.stubs.stub

@Test
fun addRecords_throwsRemoteException_errorIsExposed() {
    // Create Fake that throws a RemoteException
    // when insertRecords is called.
    val fake = FakeHealthConnectClient()
    fake.overrides.insertRecords = stub { throw RemoteException() }

    // Create a manager that depends on the fake.
    val manager = HealthConnectManager(fake)

    // Insert a record.
    manager.addRecords(fakeRunRecord1)

    // Verify that the manager is exposing an error.
    assertTrue(manager.errors.size == 1)
}

সমষ্টি

অ্যাগ্রিগেশন কলের জাল বাস্তবায়ন নেই। পরিবর্তে, একত্রিতকরণ কল স্টাব ব্যবহার করে যা আপনি একটি নির্দিষ্ট উপায়ে আচরণ করার জন্য প্রোগ্রাম করতে পারেন। আপনি FakeHealthConnectClient এর overrides সম্পত্তির মাধ্যমে স্টাবগুলি অ্যাক্সেস করতে পারেন।

উদাহরণস্বরূপ, আপনি একটি নির্দিষ্ট ফলাফল ফেরত দিতে সমষ্টিগত ফাংশন প্রোগ্রাম করতে পারেন:

import androidx.health.connect.client.testing.AggregationResult
import androidx.health.connect.client.records.HeartRateRecord
import androidx.health.connect.client.records.ExerciseSessionRecord
import java.time.Duration

@Test
fun aggregate() {
    // Create a fake result.
    val result =
        AggregationResult(metrics =
            buildMap {
                put(HeartRateRecord.BPM_AVG, 74.0)
                put(
                    ExerciseSessionRecord.EXERCISE_DURATION_TOTAL,
                    Duration.ofMinutes(30)
                )
            }
        )

    // Create a fake that always returns the fake
    // result when aggregate() is called.
    val fake = FakeHealthConnectClient()
    fake.overrides.aggregate = stub(result)

তারপর, আপনি যাচাই করতে পারেন যে পরীক্ষার অধীনে আপনার ক্লাস, এই ক্ষেত্রে HealthConnectManager , ফলাফলটি সঠিকভাবে প্রক্রিয়া করেছে:

// Create a manager that depends on the fake.
val manager = HealthConnectManager(fake)
// Call the function that in turn calls aggregate on the client.
val report = manager.getHeartRateReport()

// Verify that the manager is exposing an error.
assertThat(report.bpmAverage).isEqualTo(74.0)

অনুমতি

টেস্টিং লাইব্রেরিতে একটি FakePermissionController রয়েছে, যা FakeHealthConnectClient এর উপর নির্ভরতা হিসাবে পাস করা যেতে পারে।

পরীক্ষার অধীনে আপনার বিষয় অনুমতি পরীক্ষা করার জন্য — HealthConnectClient ইন্টারফেসের permissionController বৈশিষ্ট্যের PermissionController—through ব্যবহার করতে পারে। এটি সাধারণত ক্লায়েন্টের প্রতি কল করার আগে করা হয়।

এই কার্যকারিতা পরীক্ষা করতে, আপনি FakePermissionController ব্যবহার করে কোন অনুমতিগুলি উপলব্ধ তা সেট করতে পারেন:

import androidx.health.connect.client.testing.FakePermissionController

@Test
fun newRecords_noPermissions_errorIsExposed() {
    // Create a permission controller with no permissions.
    val permissionController = FakePermissionController(grantAll = false)

    // Create a fake client with the permission controller.
    val fake = FakeHealthConnectClient(permissionController = permissionController)

    // Create a manager that depends on the fake.
    val manager = HealthConnectManager(fake)

    // Call addRecords so that the permission check is made.
    manager.addRecords(fakeRunRecord1)

    // Verify that the manager is exposing an error.
    assertThat(manager.errors).hasSize(1)
}

পৃষ্ঠা সংখ্যা

পেজিনেশন হল বাগগুলির একটি খুব সাধারণ উৎস, তাই FakeHealthConnectClient আপনাকে রেকর্ড এবং পরিবর্তনের জন্য আপনার পেজিং বাস্তবায়ন সঠিকভাবে আচরণ করছে কিনা তা যাচাই করতে সাহায্য করার জন্য ব্যবস্থা প্রদান করে।

পরীক্ষার অধীনে আপনার বিষয়, আমাদের উদাহরণে HealthConnectManager , ReadRecordsRequest এ পৃষ্ঠার আকার নির্দিষ্ট করতে পারে:

fun fetchRecordsReport(pageSize: Int = 1000) }
    val pagedRequest =
        ReadRecordsRequest(
            timeRangeFilter = ...,
            recordType = ...,
            pageToken = page1.pageToken,
            pageSize = pageSize,
        )
    val page = client.readRecords(pagedRequest)
    ...

পৃষ্ঠার আকারকে একটি ছোট মান, যেমন 2 সেট করা, আপনাকে সহজেই পৃষ্ঠা সংখ্যা পরীক্ষা করতে দেয়। উদাহরণস্বরূপ, আপনি 5টি রেকর্ড সন্নিবেশ করতে পারেন যাতে readRecords 3টি ভিন্ন পৃষ্ঠা প্রদান করে:

@Test
fun readRecords_multiplePages() = runTest {

    // Create a Fake with 2 running records.
    val fake = FakeHealthConnectClient()
    fake.insertRecords(generateRunningRecords(5))

    // Create a manager that depends on the fake.
    val manager = HealthConnectManager(fake)

    // Read records with a page size of 2.
    val report = manager.generateReport(pageSize = 2)

    // Verify that all the pages were processed correctly.
    assertTrue(report.records.size == 5)
}

টেস্ট ডেটা

লাইব্রেরিতে এখনও জাল ডেটা জেনারেট করার জন্য API গুলি অন্তর্ভুক্ত করে না, তবে আপনি Android কোড অনুসন্ধানে লাইব্রেরির দ্বারা ব্যবহৃত ডেটা এবং জেনারেটরগুলি ব্যবহার করতে পারেন৷

স্টাবস

FakeHealthConnectClient এর overrides প্রপার্টি আপনাকে এর যেকোন ফাংশন প্রোগ্রাম (বা স্টাব আউট ) করতে দেয় যাতে কল করার সময় তারা ব্যতিক্রমগুলি ফেলে দেয়। অ্যাগ্রিগেশন কলগুলিও নির্বিচারে ডেটা ফেরত দিতে পারে এবং এটি একাধিক প্রতিক্রিয়া সারিবদ্ধ করা সমর্থন করে। আরও তথ্যের জন্য Stub এবং MutableStub দেখুন।

প্রান্ত ক্ষেত্রে সারাংশ

• ক্লায়েন্ট ব্যতিক্রমগুলি ছুঁড়ে দিলে আপনার অ্যাপটি প্রত্যাশা অনুযায়ী আচরণ করে কিনা তা যাচাই করুন। আপনার কোন ব্যতিক্রমগুলি পরীক্ষা করা উচিত তা নির্ধারণ করতে প্রতিটি ফাংশনের ডকুমেন্টেশন পরীক্ষা করুন।
• যাচাই করুন যে ক্লায়েন্টকে আপনি যে প্রতিটি কল করেন তার আগে যথাযথ অনুমতি চেক করা হয়।
• আপনার পেজিনেশন বাস্তবায়ন যাচাই করুন.
• আপনি যখন একাধিক পৃষ্ঠা আনেন কিন্তু একটি মেয়াদোত্তীর্ণ টোকেন আছে তখন কি হবে তা যাচাই করুন।