रनटाइम की सुविधा के साथ काम करने वाला SDK टूल बनाना और उसका इस्तेमाल करना

टेस्ट ऐप्लिकेशन बनाना और उसे कॉन्फ़िगर करना

इस सेक्शन में, रनटाइम के साथ काम करने वाले ऐप्लिकेशन का इस्तेमाल करने के लिए, ऐप्लिकेशन को सेट अप करने और उसे तैयार करने का तरीका बताया गया है स्थानीय जांच के लिए SDK टूल.

अपना ऐप्लिकेशन तैयार करना

सबसे पहले, एक अलग स्टैंडअलोन प्रोजेक्ट या मॉड्यूल बनाएं.

ऐसे मामले में, ऐप्लिकेशन में SDK टूल का कोड शामिल नहीं होता; यह बताता है कि इसके बजाय, Maven डिपेंडेंसी देता है.

रनटाइम चालू SDK टूल का इस्तेमाल करने वाले ऐप्लिकेशन को बनाने के लिए Android Studio की ज़रूरत होती है लेडीबग कैनरी 1 या उसके बाद के वर्शन, और Android Gradle प्लग इन (AGP) 8.7.0-alpha01 या उसके बाद का वर्शन.

1. डेवलपमेंट एनवायरमेंट और टेस्टिंग के लिए डिवाइस/एम्युलेटर सेट अप करने के लिए, पहले बताए गए तरीके का ही इस्तेमाल करें.

2. इसमें बताए गए फ़्लैग का इस्तेमाल करके, SDK टूल का रनटाइम चालू करें तीसरा चरण: SDK टूल वाला सेक्शन तैयार करें.

   # This enables the Privacy Sandbox for your project on Android Studio.
   android.experimental.privacysandboxsdk.enable=true
   android.experimental.privacysandboxsdk.requireServices=false
   

3. अपने प्रोजेक्ट के टॉप-लेवल बिल्ड.gradle में Privacy Sandbox का Maven यूआरएल जोड़ें फ़ाइल से लिए जाते हैं.

       allprojects {
           repositories {
               google()
               maven {
                   url "https://maven.privacysandbox.com/v1/repository"
                   }
               }
           }
   

4. मौजूदा विज्ञापन लाइब्रेरी (आपके रनटाइम की जानकारी वाले SDK टूल) के Maven टारगेट पर, Maven डिपेंडेंसी को बनाए रखें.

5. प्रोजेक्ट के build.gradle में privacySandbox ब्लॉक जोड़ें. साथ ही, SDK लाइब्रेरी पर डिपेंडेंसी जोड़ें और 'चालू करें' को 'सही' पर सेट करें

   plugins {
       id 'com.android.application'
       id 'org.jetbrains.kotlin.android'
   }
   
   android {
       //...
       privacySandbox {
           enable true
       }
       //...
   }
   
   dependencies {
       // SDK library dependency
       implementation(<maven coordinates to SDK library>)
   }
   

6. ऐप्लिकेशन अब SDK टूल के एपीआई का इस्तेमाल उसी तरह कर सकता है जैसे इस बारे में ज़्यादा जानकारी, एपीआई के इस्तेमाल सेक्शन में दी गई है.

अपना ऐप्लिकेशन बनाएं

अपने ऐप्लिकेशन को Android App Bundle (AAB) के तौर पर सामान्य तरीके से बनाया जा सकता है.

अपने SDK टूल की स्थानीय जांच करें

टेस्ट ऐप्लिकेशन चलाने के लिए, रनटाइम में चालू होने वाला SDK टूल और अपने टेस्ट में ऐप्लिकेशन इंस्टॉल करें या एम्युलेटर का इस्तेमाल करें.

1. अपने टेस्ट ऐप्लिकेशन के लिए Android Studio प्रोजेक्ट खोलें.
2. Run > कॉन्फ़िगरेशन में बदलाव करना. "रन/डीबग" कॉन्फ़िगरेशन विंडो दिखती है. आप "डिफ़ॉल्ट APK" के तौर पर डिप्लॉय कर सकते हैं या "बंडल से APK" के तौर पर इंस्टॉल करता है.
3. लॉन्च विकल्प में, लॉन्च को बताई गई गतिविधि पर सेट करें.
4. गतिविधि के बगल में मौजूद तीन बिंदु वाले मेन्यू पर क्लिक करें और 'मुख्य' चुनें आपके क्लाइंट के लिए गतिविधि.
5. लागू करें पर क्लिक करें. इसके बाद, ठीक है पर क्लिक करें.
6. अपने टेस्ट डिवाइस पर क्लाइंट ऐप्लिकेशन और SDK टूल इंस्टॉल करने के लिए, Run पर क्लिक करें.

डिस्ट्रिब्यूशन के लिए अपना SDK टूल बनाएं

आपको अपने SDK टूल को Android SDK बंडल (ASB) इससे पहले कि आप उसे किसी ऐप स्टोर पर पब्लिश करें. ASB एक साइन नहीं किया गया पब्लिकेशन है 'Android ऐप्लिकेशन बंडल' के जैसा कोई पैकेज.

ASB या उसका व्युत्पन्न Android SDK संग्रह (ASAR), एक साथ बंडल टूल की मदद से, ऐप्लिकेशन के एएबी को इंस्टॉल किए जा सकने वाले APK के सेट में बदल दिया जाता है. ऐप्स डेवलपर, सीधे Android Studio में BundleTool का इस्तेमाल कर सकते हैं (फ़िलहाल, Canary वर्शन) से तय किया जा सकता है.

बंडलटूल AAB और ASB को लेता है और APK के वैरिएंट के सेट का आउटपुट दे सकता है:

1. SDK टूल के रनटाइम बैकवर्ड के साथ काम करने वाले मोड में चलने के लिए बनाया गया APK, ऐसे डिवाइस जो SDK टूल के रनटाइम के साथ काम नहीं करते (Android 13 और उससे पहले के वर्शन). इस APK में, ऐप्लिकेशन और SDK टूल, दोनों के लिए ज़रूरी सभी कोड शामिल होते हैं.
2. SDK टूल के रनटाइम मोड को चलाने के लिए बनाया गया APK. यह APK, उन डिवाइसों के लिए बनाया गया है जो Android की SDK टूल का रनटाइम (Android 14 और उसके बाद के वर्शन पर उपलब्ध). इस APK में केवल ऐप्लिकेशन कोड, जिसमें रनटाइम के साथ काम करने वाले SDK टूल के लिए एपीआई स्टब शामिल हैं.
3. रनटाइम के साथ काम करने वाले SDK टूल के कोड वाला SDK APK, जिसे पिछले चरण में बताए गए ऐप्लिकेशन के APK से पहले इंस्टॉल किया जाना है.

एएसबी बनाने के दो तरीके हैं:

• Android स्टूडियो
  1. अपना प्रोजेक्ट बनाएं. ऐसा करने के लिए, बिल्ड > प्रोजेक्ट फिर से बनाएं.
  2. ASB फ़ाइल build/outputs/asb/single/<your-asb-module-name>.asb अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
• बंडलटूल की कमांड लाइन - फ़ॉलो करें ये निर्देश पढ़ें.

SDK को पब्लिश करने से पहले, उसे अपलोड पासकोड से साइन करना होगा. SDK Console में अपलोड करने के लिए, अपने ASB पर हस्ताक्षर करने के लिए इस अपलोड पासकोड का इस्तेमाल करें. Google, आपकी पहचान की पुष्टि करने के लिए, अपलोड सर्टिफ़िकेट दिया जा सकता है.

एएसबी पर हस्ताक्षर करने के लिए आपको क्या करना होगा, इस बारे में यहां खास जानकारी दी गई है:

1. कीस्टोर और अपलोड पासकोड जनरेट करें. यह ऐप्लिकेशन के लिए कीस्टोर और अपलोड पासकोड जनरेट करने जैसा ही है.
2. अपने एएसबी पर, अपलोड पासकोड से साइन करें. ऐसा करने के लिए, अपनी build.gradle फ़ाइल में signingConfig ब्लॉक जोड़ें. इसमें, नई बनाई गई कुंजी और पासकोड की जानकारी दें:

android {
  signingConfig {
    storeFile file(path-to-keystore.jks)
    storePassword "keystorePassword"
    keyAlias "UploadKey"
    keyPassword "keyPassword"
  }
}

ऐप्लिकेशन स्टोर, इन कॉम्पोनेंट का इस्तेमाल करने के लिए अलग-अलग रणनीतियां बना सकते हैं, ताकि रनटाइम के दौरान ऐप्लिकेशन उपलब्ध कराने की सुविधा काम कर सके. SDK टूल का रनटाइम, ऐप्लिकेशन के साथ लगातार काम करता रहता है ताकि रनटाइम के साथ काम करने वाले SDK टूल के लिए काम करने की सुविधा बढ़ाई जा सके.

arrow_back_iosचौथा चरण: रनटाइम की सुविधा वाले SDK टूल का इस्तेमाल करना