Android के लिए कास्ट ऐप्लिकेशन फ़्रेमवर्क (सीएएफ़) के साथ डेवलप करने के लिए सेटअप

ज़रूरी शर्तें

Android के लिए Google Cast SDK टूल, Google Play services SDK टूल का हिस्सा है. इसे अलग से डाउनलोड करने की ज़रूरत नहीं है.

ध्यान दें: Google Play services की मदद से, विज्ञापन बनाने, आंकड़ों को इकट्ठा करने, उपयोगकर्ताओं की पुष्टि करने, मैप को इंटिग्रेट करने वगैरह के लिए, कई तरह के एपीआई का ऐक्सेस मिलता है. ज़्यादा जानकारी के लिए, Google Play services के बारे में खास जानकारी देखें. यह ज़रूरी है कि आप उपयोगकर्ता के डिवाइस पर पक्का करें कि Google Play services का सही APK इंस्टॉल हो, क्योंकि हो सकता है कि अपडेट सभी उपयोगकर्ताओं तक तुरंत न पहुंचें.

अपने प्रोजेक्ट में Google Play services जोड़ना

नीचे दिए गए डेवलपमेंट एनवायरमेंट में से कोई एक चुनें. इसके बाद, दिए गए निर्देशों का पालन करके, अपने प्रोजेक्ट में Google Play services जोड़ें.

Android Studio

अपने ऐप्लिकेशन के लिए Google Play services के एपीआई उपलब्ध कराने के लिए:

  1. अपने ऐप्लिकेशन मॉड्यूल डायरेक्ट्री में build.gradle फ़ाइल खोलें.

    ध्यान दें: Android Studio प्रोजेक्ट में, टॉप लेवल वाली एक build.gradle फ़ाइल और हर मॉड्यूल के लिए एक build.gradle फ़ाइल होती है. अपने ऐप्लिकेशन मॉड्यूल के लिए, फ़ाइल में बदलाव करना न भूलें. Gradle के बारे में ज़्यादा जानकारी के लिए, Gradle की मदद से अपना प्रोजेक्ट बनाना लेख पढ़ें.

  2. पुष्टि करें कि google(), सूची में शामिल repositories में शामिल है.
    repositories {
        google()
    }
  3. play-services के सबसे नए वर्शन के लिए, dependencies में नया बिल्ड नियम जोड़ें. उदाहरण के लिए:
    apply plugin: 'com.android.application'
        ...
    
        dependencies {
            implementation 'androidx.appcompat:appcompat:1.3.1'
            implementation 'androidx.mediarouter:mediarouter:1.2.5'
            implementation 'com.google.android.gms:play-services-cast-framework:22.0.0'
        }

    Google Play services के हर अपडेट के बाद, इस वर्शन नंबर को अपडेट करना न भूलें.

    ध्यान दें: अगर आपके ऐप्लिकेशन में मौजूद तरीकों के रेफ़रंस की संख्या, 65 हज़ार की सीमा से ज़्यादा है, तो हो सकता है कि आपका ऐप्लिकेशन संकलित न हो पाए. अपने ऐप्लिकेशन को कंपाइल करते समय, इस समस्या को कम किया जा सकता है. इसके लिए, आपको Google Play services के सभी एपीआई के बजाय, सिर्फ़ उन एपीआई की जानकारी देनी होगी जिनका इस्तेमाल आपके ऐप्लिकेशन में किया जाता है. ऐसा करने का तरीका जानने के लिए, एपीआई को चुनिंदा तौर पर अपने एक्सीक्यूटेबल में कंपाइल करना लेख पढ़ें.

  4. बदलावों को सेव करें और टूलबार में Gradle फ़ाइलों के साथ प्रोजेक्ट सिंक करें पर क्लिक करें.

अन्य आईडीई

अपने ऐप्लिकेशन के लिए Google Play services के एपीआई उपलब्ध कराने के लिए:

  1. लाइब्रेरी प्रोजेक्ट को <android-sdk>/extras/google/google_play_services/libproject/google-play-services_lib/ से उस जगह पर कॉपी करें जहां आपके Android ऐप्लिकेशन प्रोजेक्ट मौजूद हैं.
  2. अपने ऐप्लिकेशन प्रोजेक्ट में, Google Play services लाइब्रेरी प्रोजेक्ट का रेफ़रंस दें. ऐसा करने का तरीका जानने के लिए, कमांड-लाइन पर लाइब्रेरी प्रोजेक्ट का रेफ़रंस देना लेख पढ़ें.

    ध्यान दें: आपको लाइब्रेरी की उस कॉपी का रेफ़रंस देना चाहिए जिसे आपने अपने डेवलपमेंट वर्कस्पेस में कॉपी किया है. आपको सीधे Android SDK डायरेक्ट्री से लाइब्रेरी का रेफ़रंस नहीं देना चाहिए.

  3. अपने ऐप्लिकेशन प्रोजेक्ट के लिए, Google Play services लाइब्रेरी को डिपेंडेंसी के तौर पर जोड़ने के बाद, अपने ऐप्लिकेशन की मेनिफ़ेस्ट फ़ाइल खोलें और <application> एलिमेंट के चाइल्ड के तौर पर, यह टैग जोड़ें:
    <meta-data android:name="com.google.android.gms.version"
        android:value="@integer/google_play_services_version" />

लाइब्रेरी प्रोजेक्ट का रेफ़रंस देने के लिए प्रोजेक्ट सेट अप करने के बाद, Google Play services के एपीआई की मदद से सुविधाएं डेवलप की जा सकती हैं.

Proguard अपवाद बनाना

ज़रूरी क्लास को हटाने से ProGuard को रोकने के लिए, /proguard-project.txt फ़ाइल में ये लाइनें जोड़ें:

-keep public class com.google.android.gms.common.internal.safeparcel.SafeParcelable {
    public static final *** NULL;
}

-keepnames class * implements android.os.Parcelable
-keepclassmembers class * implements android.os.Parcelable {
  public static final *** CREATOR;
}

-keep @interface android.support.annotation.Keep
-keep @android.support.annotation.Keep class *
-keepclasseswithmembers class * {
  @android.support.annotation.Keep <fields>;
}
-keepclasseswithmembers class * {
  @android.support.annotation.Keep <methods>;
}

-keep @interface com.google.android.gms.common.annotation.KeepName
-keepnames @com.google.android.gms.common.annotation.KeepName class *
-keepclassmembernames class * {
  @com.google.android.gms.common.annotation.KeepName *;
}

-keep @interface com.google.android.gms.common.util.DynamiteApi
-keep public @com.google.android.gms.common.util.DynamiteApi class * {
  public <fields>;
  public <methods>;
}

-dontwarn android.security.NetworkSecurityPolicy