Fastlane का उपयोग करने वाले परीक्षकों को Android ऐप्स वितरित करें

यह मार्गदर्शिका बताती है कि फास्टलेन का उपयोग करके परीक्षकों को एएबी बिल्ड कैसे वितरित करें, एक ओपन सोर्स प्लेटफॉर्म जो आईओएस और एंड्रॉइड ऐप बनाने और जारी करने को स्वचालित करता है। यह Fastfile में परिभाषित सरल निर्देशों का पालन करता है। आपके द्वारा फास्टलेन और अपने Fastfile सेट करने के बाद, आप ऐप वितरण को अपने फास्टलेन कॉन्फ़िगरेशन के साथ एकीकृत कर सकते हैं।

ऐप वितरण Google Play की आंतरिक ऐप साझाकरण सेवा के साथ एकीकृत होता है ताकि आपके द्वारा अपलोड किए जाने वाले AABs को संसाधित किया जा सके और आपके परीक्षकों के डिवाइस कॉन्फ़िगरेशन के लिए अनुकूलित APK की सेवा की जा सके। AAB का वितरण करने से आप निम्न कार्य कर सकते हैं:

• अनुकूलित APK चलाएं (Google Play द्वारा प्रस्तुत) जो आपके परीक्षकों के उपकरणों के लिए अनुकूलित हैं।

• डिवाइस-विशिष्ट समस्याओं को उजागर करें और डीबग करें।

• Play सुविधा वितरण और Play संपत्ति वितरण जैसी ऐप्लिकेशन बंडल सुविधाओं का परीक्षण करें.

• अपने परीक्षकों के लिए डाउनलोड का आकार कम करें।

आवश्यक अनुमतियाँ

ऐप वितरण में AABs अपलोड करने के लिए, आपको अपने Firebase ऐप को Google Play में किसी ऐप से लिंक करना होगा। इन कार्रवाइयों को करने के लिए आपके पास आवश्यक स्तर की पहुंच होनी चाहिए.

यदि आपके पास आवश्यक Firebase एक्सेस नहीं है, तो आप Firebase कंसोल IAM सेटिंग के माध्यम से किसी Firebase प्रोजेक्ट स्वामी से आपको उपयुक्त भूमिका असाइन करने के लिए कह सकते हैं। यदि आपके पास अपने फायरबेस प्रोजेक्ट तक पहुँचने के बारे में प्रश्न हैं, जिसमें एक मालिक को ढूंढना या असाइन करना शामिल है, तो "फायरबेस प्रोजेक्ट की अनुमतियाँ और एक्सेस" अक्सर पूछे जाने वाले प्रश्नों की समीक्षा करें।

निम्न तालिका Google Play में एक Firebase ऐप को ऐप से लिंक करने के साथ-साथ AABs अपलोड करने के लिए लागू होती है।

शुरू करने से पहले

1. यदि आपने पहले से नहीं किया है, तो अपने Android प्रोजेक्ट में Firebase जोड़ें । इस कार्यप्रवाह के अंत में, आपके पास अपने Firebase प्रोजेक्ट में एक Firebase Android ऐप होगा।

   यदि आप किसी अन्य फायरबेस उत्पाद का उपयोग नहीं कर रहे हैं, तो आपको केवल एक प्रोजेक्ट बनाना होगा और अपना ऐप पंजीकृत करना होगा। यदि आप अतिरिक्त उत्पादों का उपयोग करने का निर्णय लेते हैं, तो अपने Android प्रोजेक्ट में Firebase जोड़ें के सभी चरणों को पूरा करना सुनिश्चित करें।

2. Google Play के लिए एक Firebase लिंक बनाने और AABs अपलोड करने के लिए, सुनिश्चित करें कि आपका ऐप निम्नलिखित आवश्यकताओं को पूरा करता है:

   • Google Play में ऐप और Firebase Android ऐप दोनों एक ही पैकेज नाम का उपयोग करके पंजीकृत हैं।

   • Google Play में ऐप को ऐप डैशबोर्ड पर सेट किया गया है और इसे Google Play ट्रैक्स (आंतरिक परीक्षण, बंद परीक्षण, खुला परीक्षण या उत्पादन) में से एक में वितरित किया गया है।

   • Google Play में ऐप की समीक्षा पूरी हो गई है और ऐप प्रकाशित हो गया है। यदि ऐप स्थिति कॉलम निम्न स्थितियों में से एक प्रदर्शित करता है तो आपका ऐप प्रकाशित किया जाता है: आंतरिक परीक्षण (ड्राफ्ट आंतरिक परीक्षण नहीं), बंद परीक्षण, खुला परीक्षण या उत्पादन।

3. अपने Firebase Android ऐप को अपने Google Play डेवलपर खाते से लिंक करें:

   1. फायरबेस कंसोल में, अपनी settings प्रोजेक्ट सेटिंग्स पर जाएं, फिर इंटीग्रेशन टैब चुनें।

   2. Google Play कार्ड पर, लिंक करें क्लिक करें.
      यदि आपके पास पहले से ही Google Play के लिंक हैं, तो इसके बजाय प्रबंधित करें पर क्लिक करें।

   3. ऐप वितरण एकीकरण को सक्षम करने के लिए ऑन-स्क्रीन निर्देशों का पालन करें और Google Play से लिंक करने के लिए कौन से Firebase Android ऐप्स का चयन करें।

   Google Play से लिंक करने के बारे में और जानें।

स्टेप 1. फास्टलेन सेट करें

1. फास्टलेन स्थापित करें और सेट अप करें ।

2. अपने फास्टलेन कॉन्फ़िगरेशन में ऐप डिस्ट्रीब्यूशन जोड़ने के लिए, अपने Android प्रोजेक्ट के रूट से निम्न कमांड चलाएँ:

   fastlane add_plugin firebase_app_distribution

   यदि आदेश आपको एक विकल्प के साथ संकेत देता है, तो Option 3: RubyGems.org ।

चरण 2. फायरबेस के साथ प्रमाणित करें

इससे पहले कि आप फास्टलेन प्लगइन का उपयोग कर सकें, आपको सबसे पहले निम्नलिखित में से किसी एक तरीके से अपने फायरबेस प्रोजेक्ट के साथ प्रमाणित करना होगा। यदि कोई अन्य प्रमाणीकरण विधि का उपयोग नहीं किया जाता है, तो डिफ़ॉल्ट रूप से, फास्टलेन प्लगइन फायरबेस सीएलआई से क्रेडेंशियल्स की तलाश करता है।

स्टेप 3. अपना फास्टफाइल सेट करें और अपने ऐप को वितरित करें

1. एक ./fastlane/Fastfile लेन में, एक firebase_app_distribution ब्लॉक जोड़ें। वितरण को कॉन्फ़िगर करने के लिए निम्न पैरामीटर का उपयोग करें:

   firebase_app_distribution पैरामीटर
   app	आवश्यक : आपके ऐप की फायरबेस ऐप आईडी। आप सामान्य सेटिंग्स पृष्ठ पर, फायरबेस कंसोल में ऐप आईडी पा सकते हैं। app: "1:1234567890:android:0a1b2c3d4e5f67890"
   firebase_cli_token	एक रीफ्रेश टोकन जो तब प्रिंट होता है जब आप फायरबेस सीएलआई के साथ अपने सीआई पर्यावरण को प्रमाणित करते हैं (अधिक जानकारी के लिए सीआई सिस्टम के साथ सीएलआई का उपयोग करें पढ़ें)।
   service_credentials_file	आपकी Google सेवा खाता json फ़ाइल का पथ। सेवा खाता क्रेडेंशियल्स का उपयोग करके प्रमाणित करने के तरीके के लिए ऊपर देखें।
   android_artifact_type	Android फ़ाइल प्रकार (APK या AAB) निर्दिष्ट करता है।
   android_artifact_path	apk_path (बहिष्कृत) को प्रतिस्थापित करता है। आप जिस एपीके या एएबी फ़ाइल को अपलोड करना चाहते हैं, उसका निरपेक्ष पथ। यदि निर्दिष्ट नहीं है, तो फास्टलेन फ़ाइल के स्थान को उस लेन से निर्धारित करता है जिसमें फ़ाइल उत्पन्न हुई थी।
   release_notes release_notes_file	इस बिल्ड के लिए रिलीज़ नोट। आप या तो सीधे रिलीज़ नोट निर्दिष्ट कर सकते हैं: release_notes: "Text of release notes" या, सादा पाठ फ़ाइल का पथ निर्दिष्ट करें: release_notes_file: "/path/to/release-notes.txt"
   testers testers_file	उन परीक्षकों के ईमेल पते जिन्हें आप आमंत्रित करना चाहते हैं। आप परीक्षकों को ईमेल पतों की अल्पविराम से अलग की गई सूची के रूप में निर्दिष्ट कर सकते हैं: testers: "ali@example.com, bri@example.com, cal@example.com" या, आप ईमेल पतों की अल्पविराम से अलग की गई सूची वाली सादा पाठ फ़ाइल का पथ निर्दिष्ट कर सकते हैं: testers_file: "/path/to/testers.txt"
   groups groups_file	वे परीक्षक समूह जिन्हें आप आमंत्रित करना चाहते हैं ( परीक्षकों को प्रबंधित करें देखें)। समूहों का उपयोग करके निर्दिष्ट किया गया है समूह उपनाम , जिसे आप Firebase कंसोल में देख सकते हैं। आप समूहों को अल्पविराम से अलग की गई सूची के रूप में निर्दिष्ट कर सकते हैं: groups: "qa-team, trusted-testers" या, आप अल्पविराम से अलग की गई समूह नामों की सूची वाली सादा पाठ फ़ाइल का पथ निर्दिष्ट कर सकते हैं: groups_file: "/path/to/groups.txt"
   debug	एक बूलियन झंडा। वर्बोज़ डिबग आउटपुट प्रिंट करने के लिए आप इसे true पर सेट कर सकते हैं।

platform :android do
    desc "My awesome app"
    lane :distribute do
        build_android_app(task: "bundle", ...)
        # build_android_app is a built-in fastlane action.
        release = firebase_app_distribution(
            app: "1:123456789:android:abcd1234",
            testers: "tester1@company.com, tester2@company.com",
            release_notes: "Lots of amazing new features to test out!",
            android_artifact_type: "AAB"
        )
    end
end

परीक्षकों को बिल्ड उपलब्ध कराने के लिए, अपनी लेन चलाएँ:

fastlane <lane>

कार्रवाई का वापसी मूल्य अपलोड की गई रिलीज का प्रतिनिधित्व करने वाला एक हैश है। यह हैश lane_context[SharedValues::FIREBASE_APP_DISTRO_RELEASE] का उपयोग करके भी उपलब्ध है। इस हैश में उपलब्ध फ़ील्ड के बारे में अधिक जानकारी के लिए, REST API दस्तावेज़ीकरण देखें।

फास्टलेन प्लगइन रिलीज़ अपलोड के बाद निम्न लिंक को आउटपुट करता है। ये लिंक आपको बायनेरिज़ प्रबंधित करने में मदद करते हैं और यह सुनिश्चित करते हैं कि परीक्षकों और अन्य डेवलपर्स के पास सही रिलीज़ है:

• एकल रिलीज प्रदर्शित करने वाले फायरबेस कंसोल का लिंक। आप इस लिंक को अपने संगठन में अन्य डेवलपर्स के साथ साझा कर सकते हैं।
• टेस्टर एक्सपीरियंस (एंड्रॉइड नेटिव ऐप) में रिलीज़ का एक लिंक जो परीक्षकों को रिलीज़ नोट देखने और ऐप को अपने डिवाइस पर इंस्टॉल करने देता है। लिंक का उपयोग करने के लिए परीक्षक को रिलीज़ तक पहुंच की आवश्यकता होती है।
• एक हस्ताक्षरित लिंक जो ऐप बाइनरी (APK या AAB फ़ाइल) को सीधे डाउनलोड और इंस्टॉल करता है। लिंक एक घंटे के बाद समाप्त हो जाता है।

आपके बिल्ड को वितरित करने के बाद, यह 150 दिनों के लिए Firebase कंसोल के ऐप डिस्ट्रीब्यूशन डैशबोर्ड में उपलब्ध रहता है। जब बिल्ड समाप्त होने के 30 दिन बाद होता है, तो कंसोल में और उनके टेस्ट डिवाइस पर टेस्टर की सूची में एक समाप्ति नोटिस दिखाई देता है।

जिन परीक्षकों को पहले ऐप का परीक्षण करने के लिए आमंत्रित नहीं किया गया था, उन्हें आरंभ करने के लिए ईमेल आमंत्रण प्राप्त होते हैं। मौजूदा परीक्षकों को ईमेल सूचनाएँ प्राप्त होती हैं कि एक नया निर्माण परीक्षण के लिए तैयार है। परीक्षण ऐप इंस्टॉल करने का तरीका जानने के लिए, परीक्षक सेट अप मार्गदर्शिका देखें. आप यह निर्धारित करने के लिए प्रत्येक परीक्षक की स्थिति की निगरानी कर सकते हैं कि उन्होंने आमंत्रण स्वीकार किया है या नहीं और उन्होंने फायरबेस कंसोल में ऐप डाउनलोड किया है या नहीं।

(वैकल्पिक) हर बार जब आप ऐप वितरण में एक नई रिलीज़ बनाते हैं तो अपनी बिल्ड संख्या को स्वचालित रूप से बढ़ाने के लिए, आप firebase_app_distribution_get_latest_release कार्रवाई का उपयोग कर सकते हैं और, उदाहरण के लिए, increment_version_code फास्टलेन प्लगइन । निम्न कोड एक उदाहरण प्रदान करता है कि आपकी बिल्ड संख्या को स्वचालित रूप से कैसे बढ़ाया जाए:

lane :increment_version do
  latest_release = firebase_app_distribution_get_latest_release(
    app: "<your Firebase app ID>"
  )
  increment_version_code({ version_code: latest_release[:buildVersion].to_i + 1 })
end

firebase_app_distribution_get_latest_release क्रिया के बारे में अधिक जानने के लिए, अपने ऐप की नवीनतम रिलीज़ के बारे में जानकारी प्राप्त करें देखें।

चरण 4 (वैकल्पिक)। वितरण के लिए परीक्षकों का प्रबंध करना

आप अपनी Fastfile फ़ाइल का उपयोग करके या सीधे फास्टलेन क्रियाओं को चलाकर अपने ऐप रिलीज़ से परीक्षकों को जोड़ या हटा सकते हैं। चल रही क्रियाएं सीधे आपके Fastfile में सेट मानों को ओवरराइड करती हैं।

एक बार आपके Firebase प्रोजेक्ट में परीक्षक जुड़ जाने के बाद, आप उन्हें अलग-अलग रिलीज़ में जोड़ सकते हैं। जिन परीक्षकों को आपके Firebase प्रोजेक्ट से हटा दिया गया है, उनके पास अब आपके प्रोजेक्ट में रिलीज़ तक पहुंच नहीं है, लेकिन वे कुछ समय के लिए आपकी रिलीज़ तक पहुंच बनाए रख सकते हैं।

Fastfile प्रयोग करें

# Use lanes to add or remove testers from an app release.
lane(:add_testers) do
  firebase_app_distribution_add_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
  )
end

lane(:remove_testers) do
  firebase_app_distribution_remove_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
  )
end

# Add or remove testers with the terminal
$ fastlane add_testers
$ fastlane remove_testers

फास्टलेन क्रियाएं चलाएं

fastlane run firebase_app_distribution_add_testers emails:"foo@google.com,bar@google.com"

fastlane run firebase_app_distribution_remove_testers emails:"foo@google.com,bar@google.com"

आप --file="/path/to/testers.txt --emails के बजाय --file="/path/to/testers.txt उपयोग करके परीक्षकों को भी निर्दिष्ट कर सकते हैं।

firebase_app_distribution_add_testers और firebase_app_distribution_remove_testers कार्य भी निम्नलिखित तर्कों को स्वीकार करते हैं:

• project_name : आपका फायरबेस प्रोजेक्ट नंबर।
• service_credentials_file : आपकी Google सेवा क्रेडेंशियल फ़ाइल का पथ।
• firebase_cli_token : फायरबेस सीएलआई के लिए प्रामाणिक टोकन।

service_credentials_file और firebase_cli_token वही तर्क हैं जिनका उपयोग अपलोड क्रिया द्वारा किया जाता है।

चरण 5 (वैकल्पिक)। अपने ऐप की नवीनतम रिलीज़ के बारे में जानकारी प्राप्त करें

आप ऐप वितरण में अपने ऐप की नवीनतम रिलीज़ के बारे में जानकारी प्राप्त करने के लिए firebase_app_distribution_get_latest_release क्रिया का उपयोग कर सकते हैं, जिसमें ऐप संस्करण की जानकारी, रिलीज़ नोट और निर्माण समय शामिल है। उपयोग के मामलों में स्वचालित रूप से संस्करण को बढ़ाना और पिछले रिलीज़ से रिलीज़ नोट्स को ले जाना शामिल है।

कार्रवाई का वापसी मूल्य एक हैश है जो नवीनतम रिलीज का प्रतिनिधित्व करता है। यह हैश lane_context[SharedValues::FIREBASE_APP_DISTRO_LATEST_RELEASE] का उपयोग करके भी उपलब्ध है। इस हैश में उपलब्ध फ़ील्ड के बारे में अधिक जानकारी के लिए, REST API दस्तावेज़ीकरण देखें।

पैरामीटर

app: "1:1234567890:android:0a1b2c3d4e5f67890"

अगले कदम

• परीक्षकों के लिए आपके ऐप (स्क्रीनशॉट सहित) के बारे में फ़ीडबैक भेजना आसान बनाने के लिए इन-ऐप फ़ीडबैक लागू करें।

• अपने ऐप के नए बिल्ड इंस्टॉल करने के लिए उपलब्ध होने पर अपने परीक्षकों को इन-ऐप अलर्ट प्रदर्शित करने का तरीका जानें।

• CI/CD का उपयोग करके QA परीक्षकों को Android ऐप्स वितरित करने के सर्वोत्तम अभ्यास सीखें।