AndroidX Test के लिए प्रोजेक्ट सेट अप करना

AndroidX Test, Jetpack लाइब्रेरी का एक कलेक्शन है. इसकी मदद से, Android ऐप्लिकेशन की जांच की जा सकती है. यह आपको इन टेस्ट को लिखने में मदद करने के लिए, कई टूल भी उपलब्ध कराता है.

उदाहरण के लिए, AndroidX Test, JUnit4 टेस्ट में गतिविधियों को शुरू करने और उनके साथ इंटरैक्ट करने के लिए JUnit4 के नियम उपलब्ध कराता है. इसमें यूज़र इंटरफ़ेस (यूआई) टेस्टिंग फ़्रेमवर्क भी शामिल हैं. जैसे, Espresso, UI Automator, और Robolectric सिम्युलेटर.

AndroidX Test लाइब्रेरी जोड़ना

AndroidX Test का इस्तेमाल करने के लिए, आपको अपने ऐप्लिकेशन प्रोजेक्ट की डिपेंडेंसी में बदलाव करना होगा. इसके लिए, आपको डेवलपमेंट एनवायरमेंट में जाकर बदलाव करना होगा.

ग्रेडल डिपेंडेंसी जोड़ना

अपने ऐप्लिकेशन प्रोजेक्ट की डिपेंडेंसी में बदलाव करने के लिए, यह तरीका अपनाएं:

• पहला चरण: अपने Gradle मॉड्यूल के लिए build.gradle फ़ाइल खोलें.
• दूसरा चरण: रिपॉज़िटरी सेक्शन में जाकर देखें कि Google की Maven रिपॉज़िटरी दिख रही है या नहीं:

  allprojects {
    repositories {
      jcenter()
      google()
    }
  }

• तीसरा चरण: आपको जिस AndroidX Test पैकेज का इस्तेमाल करना है उसके लिए, dependencies सेक्शन में पैकेज का नाम जोड़ें. उदाहरण के लिए, espresso-core पैकेज जोड़ने के लिए, यहां दी गई लाइनें जोड़ें:

Groovy

dependencies {
        ...
        androidTestImplementation "androidx.test.espresso:espresso-core:$espressoVersion"
    }

Kotlin

dependencies {
        ...
        androidTestImplementation('androidx.test.espresso:espresso-core:$espressoVersion')
    }

AndroidX Test की ये सबसे आम डिपेंडेंसी उपलब्ध हैं:

Groovy

dependencies {
    // Core library
    androidTestImplementation "androidx.test:core:$androidXTestVersion0"

    // AndroidJUnitRunner and JUnit Rules
    androidTestImplementation "androidx.test:runner:$testRunnerVersion"
    androidTestImplementation "androidx.test:rules:$testRulesVersion"

    // Assertions
    androidTestImplementation "androidx.test.ext:junit:$testJunitVersion"
    androidTestImplementation "androidx.test.ext:truth:$truthVersion"

    // Espresso dependencies
    androidTestImplementation "androidx.test.espresso:espresso-core:$espressoVersion"
    androidTestImplementation "androidx.test.espresso:espresso-contrib:$espressoVersion"
    androidTestImplementation "androidx.test.espresso:espresso-intents:$espressoVersion"
    androidTestImplementation "androidx.test.espresso:espresso-accessibility:$espressoVersion"
    androidTestImplementation "androidx.test.espresso:espresso-web:$espressoVersion"
    androidTestImplementation "androidx.test.espresso.idling:idling-concurrent:$espressoVersion"

    // The following Espresso dependency can be either "implementation",
    // or "androidTestImplementation", depending on whether you want the
    // dependency to appear on your APK’"s compile classpath or the test APK
    // classpath.
    androidTestImplementation "androidx.test.espresso:espresso-idling-resource:$espressoVersion"
}

Kotlin

dependencies {
    // Core library
    androidTestImplementation("androidx.test:core:$androidXTestVersion")

    // AndroidJUnitRunner and JUnit Rules
    androidTestImplementation("androidx.test:runner:$testRunnerVersion")
    androidTestImplementation("androidx.test:rules:$testRulesVersion")

    // Assertions
    androidTestImplementation("androidx.test.ext:junit:$testJunitVersion")
    androidTestImplementation("androidx.test.ext:truth:$truthVersion")

    // Espresso dependencies
    androidTestImplementation( "androidx.test.espresso:espresso-core:$espressoVersion")
    androidTestImplementation( "androidx.test.espresso:espresso-contrib:$espressoVersion")
    androidTestImplementation( "androidx.test.espresso:espresso-intents:$espressoVersion")
    androidTestImplementation( "androidx.test.espresso:espresso-accessibility:$espressoVersion")
    androidTestImplementation( "androidx.test.espresso:espresso-web:$espressoVersion")
    androidTestImplementation( "androidx.test.espresso.idling:idling-concurrent:$espressoVersion")

    // The following Espresso dependency can be either "implementation",
    // or "androidTestImplementation", depending on whether you want the
    // dependency to appear on your APK"s compile classpath or the test APK
    // classpath.
    androidTestImplementation( "androidx.test.espresso:espresso-idling-resource:$espressoVersion")
}

रिलीज़ नोट पेज पर, एक टेबल होती है. इसमें हर आर्टफ़ैक्ट के हिसाब से, नए वर्शन की जानकारी होती है.

ध्यान दें: यह पक्का करना ज़रूरी है कि टेस्टिंग की ये डिपेंडेंसी, सही सोर्स सेट की ओर इशारा करती हों. आम तौर पर, AndroidX Test की ज़रूरत सिर्फ़ इंस्ट्रुमेंटेशन टेस्ट में होती है. इसलिए, आपको androidTestImplementation() का इस्तेमाल करना चाहिए. हालांकि, espresso-idling-resource जैसे मामलों में, एपीआई का इस्तेमाल प्रोडक्शन कोड से किया जाता है. इसके लिए, आपको लागू करने वाले फ़ंक्शन का इस्तेमाल करना होगा.

इन लाइब्रेरी के बारे में खास रेफ़रंस दस्तावेज़ देखने के लिए, पैकेज इंडेक्स या क्लास इंडेक्स देखें.

रोकी गई क्लास का इस्तेमाल करने वाले प्रोजेक्ट

चेतावनी: Gradle का इस्तेमाल करके इंस्ट्रुमेंटेशन टेस्ट बनाने पर, आपको अतिरिक्त सहायता मिलती है. टेस्ट मेनिफ़ेस्ट अपने-आप जनरेट होने पर, Android Gradle प्लगिन आपके प्रोजेक्ट में यहां दी गई लाइब्रेरी और मेनिफ़ेस्ट एलिमेंट अपने-आप जोड़ देता है. इसलिए, आपको ये चरण पूरे करने की ज़रूरत नहीं होती.

अगर आपका ऐप्लिकेशन ऐसे टेस्ट का इस्तेमाल करता है जो बंद हो चुकी JUnit3 पर आधारित android.test क्लास पर निर्भर हैं , जैसे कि InstrumentationTestCase और TestSuiteLoader, तो फ़ाइल के android सेक्शन में ये लाइनें जोड़ें:

android {
    ...
    useLibrary 'android.test.runner'

    useLibrary 'android.test.base'
    useLibrary 'android.test.mock'
  }

ध्यान दें: आपको सिर्फ़ उन लाइब्रेरी को शामिल करना होगा जिनमें आपके ऐप्लिकेशन में इस्तेमाल की गई क्लास शामिल हैं. हर लाइब्रेरी में दिखने वाली क्लास की सूची देखने के लिए, JUnit पर आधारित लाइब्रेरी देखें.

मेनिफ़ेस्ट के बारे में जानकारी जोड़ना

अगर आपको ऐसी जांचें करनी हैं जो बंद हो चुकी JUnit3 पर आधारित android.test क्लास पर निर्भर करती हैं, तो अपने टेस्ट ऐप्लिकेशन के मेनिफ़ेस्ट में ज़रूरी <uses-library> एलिमेंट जोड़ें. उदाहरण के लिए, अगर आपको ऐसे टेस्ट जोड़ने हैं जो android.test.runner लाइब्रेरी पर निर्भर करते हैं, तो अपने ऐप्लिकेशन के मेनिफ़ेस्ट में यह एलिमेंट जोड़ें:

<!-- You don't need to include android:required="false" if your app's

   minSdkVersion is 28 or higher. -->

<uses-library android:name="android.test.runner"

       android:required="false" />

किसी दी गई JUnit-आधारित क्लास वाली लाइब्रेरी का पता लगाने के लिए, JUnit-आधारित लाइब्रेरी देखें.

चेतावनी: जहां तक हो सके, ऐसी क्लास इस्तेमाल करने से बचें जिन्हें बंद कर दिया गया है. इनकी जगह, JUnit पर आधारित क्लास का इस्तेमाल करें.

Android 9 या इसके बाद के वर्शन को टारगेट करने के लिए, बंद की गई क्लास का इस्तेमाल करते समय ध्यान रखने वाली बातें

ज़्यादा

इस सेक्शन में दिए गए दिशा-निर्देश सिर्फ़ तब लागू होते हैं, जब आपका ऐप्लिकेशन Android 9 (एपीआई लेवल 28) या इससे बाद के वर्शन को टारगेट करता हो और आपके ऐप्लिकेशन के लिए कम से कम एसडीके वर्शन, Android 9 पर सेट हो.

android.test.runner लाइब्रेरी, android.test.base और android.test.mock लाइब्रेरी पर निर्भर करती है. अगर आपका ऐप्लिकेशन सिर्फ़ android.test.base या android.test.mock से क्लास इस्तेमाल करता है, तो लाइब्रेरी को इस तरह शामिल किया जा सकता है:

<!-- For both of these declarations, you don't need to include
   android:required="false" if your app's minSdkVersion is 28
   or higher. -->

<uses-library android:name="android.test.base"
       android:required="false" />
<uses-library android:name="android.test.mock"
       android:required="false" />