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

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

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

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

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

इस उदाहरण में, ऐप्लिकेशन में एसडीके कोड शामिल नहीं है. इसके बजाय, इसे Maven डिपेंडेंसी के तौर पर घोषित किया गया है.

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

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

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

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

3. अपने प्रोजेक्ट के टॉप-लेवल build.gradle फ़ाइल में, Privacy Sandbox Maven का यूआरएल जोड़ें.

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

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

5. एसडीके लाइब्रेरी पर डिपेंडेंसी के साथ, प्रोजेक्ट build.gradle में privacySandbox ब्लॉक जोड़ें और enable को true पर सेट करें

   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. अब ऐप्लिकेशन, एसडीके के एपीआई का इस्तेमाल उसी तरह कर सकता है जैसा कि एपीआई इस्तेमाल करने के सेक्शन में बताया गया है.

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

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

एसडीके को स्थानीय तौर पर टेस्ट करना

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

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

डिस्ट्रिब्यूशन के लिए एसडीके टूल बनाना

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

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

Bundletool एक AAB और एक ASB लेता है. साथ ही, APK वैरिएंट का एक सेट आउटपुट कर सकता है:

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

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

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

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

यहां दिए गए चरणों में, ASB पर हस्ताक्षर करने के तरीके की खास जानकारी दी गई है:

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

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

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

arrow_back_iosचौथा चरण: रनटाइम के साथ काम करने वाले एसडीके का इस्तेमाल करना