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 API उपलब्ध कराने के लिए:

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

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

  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:21.5.0'
        }
    

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

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

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

अन्य IDE

अपने ऐप्लिकेशन में Google Play services API उपलब्ध कराने के लिए:

  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 API की मदद से सुविधाएं डेवलप की जा सकती हैं.

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