यह गाइड उन पब्लिशर के लिए है जो अपने Android ऐप्लिकेशन में, Google Mobile Ads Android SDK के रिलीज़ होने से पहले इस्तेमाल करने की सुविधा दे रहे हैं. रिलीज़ होने से पहले इस्तेमाल करने की सुविधा देने वाले बिल्ड की मदद से, Google Play services की अगली रिलीज़ का इंतज़ार किए बिना, Google Mobile Ads SDK की नई सुविधाओं का फ़ायदा लिया जा सकता है. साथ ही, यहां दिए गए फ़ायदे भी मिलते हैं:
APK में रिलीज़ होने से पहले इस्तेमाल करने की सुविधा लॉन्च होने पर, ये Google Play services APK से, Google Mobile Ads SDK के नए वर्शन का इस्तेमाल अपने-आप शुरू कर देते हैं.
इन्हें पूरी तरह से टेस्ट किया गया है और ये रिलीज़ के लिए, Google की Maven रिपॉज़िटरी या SDK Manager में उपलब्ध सार्वजनिक बिल्ड की तरह ही हैं.
ये Google Mobile Ads SDK के पूरे वर्शन हैं, जो Lite SDK टूल से बड़े हैं, लेकिन इन पर लाइट SDK टूल की सीमाएं लागू नहीं होती हैं.
उनका इस्तेमाल दुनिया भर में किया जा सकता है, न कि सिर्फ़ Google Play से डिस्ट्रिब्यूट किए जाने वाले ऐप्लिकेशन में.
रिलीज़ होने से पहले इस्तेमाल के लिए उपलब्ध Google Mobile Ads SDK के साथ, एक लोकल Maven रिपॉज़िटरी सेट अप करने के लिए इस पेज पर दिया गया तरीका अपनाएं. साथ ही, इसे अपने Android ऐप्लिकेशन में डिपेंडेंसी के तौर पर देखें.
ज़रूरी शर्तें
- Android Studio 3.0 या इसके बाद का वर्शन इस्तेमाल करें
- Android एपीआई लेवल 16 या उसके बाद के वर्शन को टारगेट करें
- खाता मैनेजर से मिली, रिलीज़ होने से पहले इस्तेमाल करने के लिए Google Mobile Ads SDK की ZIP फ़ाइल
पसंद के मुताबिक बनाई गई Maven रिपॉज़िटरी कॉन्फ़िगर करें
रिलीज़ होने से पहले इस्तेमाल के लिए उपलब्ध Google Mobile Ads SDK ZIP फ़ाइल डाउनलोड करें. अपने प्रोजेक्ट की टॉप-लेवल डायरेक्ट्री में
gma_sdk_repo फ़ोल्डर बनाएं और zip का पूरा कॉन्टेंट उस फ़ोल्डर में रखें. आपकी डायरेक्ट्री का स्ट्रक्चर
<project_root_dir>/gma_sdk_repo/com/google/... जैसा दिखना चाहिए.
अपने ऐप्लिकेशन की प्रोजेक्ट लेवल build.gradle की फ़ाइल खोलें.
allprojects {
repositories {
maven {
url "${project.rootDir}/gma_sdk_repo"
}
google()
jcenter()
}
}
allprojects/repositories सेक्शन में लाइन को बोल्ड करके जोड़ें. इससे, Gradle को डिपेंडेंसी के समाधान के लिए, अभी बनाए गए gma_sdk_repo फ़ोल्डर में Maven रिपॉज़िटरी को खोजने का निर्देश मिलता है.
बिल्ड डिपेंडेंसी जोड़ें
अपने प्रोजेक्ट में Google Mobile Ads SDK के रिलीज़ होने से पहले इस्तेमाल करने का ऐक्सेस देने के लिए, आपको
इसे अपनी ऐप्लिकेशन-लेवल build.gradle फ़ाइल में डिपेंडेंसी के तौर पर रेफ़रंस देना होगा:
ऐप्लिकेशन-लेवल build.gradle फ़ाइल खोलें और स्निपेट में बोल्ड की गई लाइन को
dependencies सेक्शन में जोड़ें.
dependencies {
implementation 'com.google.android.gms:play-services-ads:x.y.z'
}
...
डिपेंडेंसी के वर्शन, पिछले स्निपेट में x.y.z के ज़रिए दिखाए जाते हैं. इस डिपेंडेंसी के वर्शन का पता लगाने के लिए,
com/google/android/gms/play-services-ads/ डायरेक्ट्री में मौजूद सबसे नए वर्शन का पता लगाया जाता है. यह वर्शन, रिलीज़ होने से पहले इस्तेमाल होने वाले Google Mobile Ads की Android SDK की ZIP फ़ाइल के संग्रह से बाहर रखे गए कॉन्टेंट
में मौजूद होता है.
Firebase से जुड़ी समस्याएं हल करना
अगर मोबाइल विज्ञापन SDK टूल के साथ-साथ Firebase लाइब्रेरी का इस्तेमाल किया जा रहा है, तो आपके प्रोजेक्ट में com.google.android.gms:play-services-measurement-api और com.google.android.gms:play-services-measurement-sdk-api, दोनों डिपेंडेंसी शामिल हो सकती हैं. इन दोनों डिपेंडेंसी के अलग-अलग वर्शन होने चाहिए, लेकिन
आपको यह दिख सकता है कि आपके 'मोबाइल विज्ञापन SDK' टूल के रिलीज़ होने से पहले इस्तेमाल करने की सुविधा वाला बिल्ड और Firebase के मौजूदा वर्शन ने इन दोनों डिपेंडेंसी के लिए अलग-अलग वर्शन शामिल किए हैं.
वैकल्पिक हल के तौर पर, अपने ऐप्लिकेशन की build.gradle फ़ाइल में मौजूद, play-services-measurement-sdk-api लाइब्रेरी के किसी खास वर्शन पर डिपेंडेंसी को इस तरह लागू किया जा सकता है:
android {
...
configurations.all {
resolutionStrategy {
force 'com.google.android.gms:play-services-measurement-sdk-api:x.y.z'
}
}
}
...
x.y.z वर्शन, Firebase के आपके वर्शन पर निर्भर करता है. यहां हाल ही के Firebase रिलीज़
के सही वर्शन दिए गए हैं:
firebase-core वर्शन
|
play-services-measurement-sdk-api वर्शन
|
|---|---|
16.0.7
|
16.3.0
|
16.0.6
|
16.0.4
|
16.0.5
|
16.0.3
|
16.0.4
|
16.0.2
|
अन्य Firebase वर्शन का सही वर्शन ढूंढने के लिए, अपने ऐप्लिकेशन के लिए
gradle androidDependencies चलाएं और com.google.android.gms:play-services-measurement-api डिपेंडेंसी के लिए प्रिंट किए गए वर्शन का इस्तेमाल करें.
अब आपका Android ऐप्लिकेशन, Google Mobile Ads Android SDK के रिलीज़ होने से पहले इस्तेमाल करने की सुविधा के साथ इस्तेमाल के लिए तैयार है.