Einrichtung für die Entwicklung mit dem Cast Application Framework (CAF) für Android
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Vorbereitung
Das Google Cast SDK for Android ist Teil des Google Play Services SDK und muss nicht separat heruntergeladen werden.
Hinweis: Mit Google Play-Diensten haben Sie Zugriff auf eine Reihe von APIs, mit denen Sie unter anderem Anzeigen erstellen, Analysen durchführen, Nutzer authentifizieren und Karten einbinden können. Weitere Informationen finden Sie unter Übersicht über die Google Play-Dienste.
Es ist wichtig, dass Sie dafür sorgen, dass die richtige Google Play-Dienste-APK auf dem Gerät eines Nutzers installiert ist, da Updates möglicherweise nicht sofort alle Nutzer erreichen.
Google Play-Dienste zu Ihrem Projekt hinzufügen
Wählen Sie unten Ihre Entwicklungsumgebung aus und fügen Sie Ihrem Projekt die Google Play-Dienste hinzu, indem Sie der Anleitung folgen.
Android Studio
So stellen Sie die Google Play-Dienste-APIs für Ihre App zur Verfügung:
- Öffnen Sie die Datei
build.gradle im Verzeichnis Ihres Anwendungsmoduls.
Hinweis:Android Studio-Projekte enthalten eine build.gradle-Datei auf oberster Ebene und eine build.gradle-Datei für jedes Modul. Achten Sie darauf, dass Sie die Datei für Ihr Anwendungsmodul bearbeiten. Weitere Informationen zu Gradle finden Sie unter
Ihr Projekt mit Gradle erstellen.
- Prüfen Sie, ob
google() in den aufgeführten repositories enthalten ist.
repositories {
google()
}
- Fügen Sie unter
dependencies eine neue Build-Regel für die aktuelle Version von play-services hinzu. Beispiel:
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.1.0'
}
Aktualisieren Sie diese Versionsnummer jedes Mal, wenn die Google Play-Dienste aktualisiert werden.
Hinweis:Wenn die Anzahl der Methodenreferenzen in Ihrer App das 65.000er-Limit überschreitet, kann die App möglicherweise nicht kompiliert werden. Sie können dieses Problem möglicherweise beim Kompilieren Ihrer App beheben, indem Sie nur die spezifischen Google Play-Dienste-APIs angeben, die Ihre App verwendet, anstatt alle. Informationen dazu finden Sie unter APIs selektiv in Ihre ausführbare Datei kompilieren.
- Speichern Sie die Änderungen und klicken Sie in der Symbolleiste auf Projekt mit Gradle-Dateien synchronisieren.
Andere IDE
So stellen Sie die Google Play-Dienste-APIs für Ihre App zur Verfügung:
- Kopieren Sie das Bibliotheksprojekt unter
<android-sdk>/extras/google/google_play_services/libproject/google-play-services_lib/ an den Speicherort, an dem Sie Ihre Android-App-Projekte verwalten.
- Verweisen Sie in Ihrem App-Projekt auf das Google Play-Dienste-Bibliotheksprojekt. Weitere Informationen dazu finden Sie unter
Bibliotheksprojekt in der Befehlszeile referenzieren.
Hinweis:Sie sollten auf eine Kopie der Bibliothek verweisen, die Sie in Ihren Entwicklerarbeitsbereich kopiert haben. Verweisen Sie nicht direkt auf die Bibliothek im Android SDK-Verzeichnis.
- Nachdem Sie die Google Play Services-Bibliothek als Abhängigkeit für Ihr App-Projekt hinzugefügt haben, öffnen Sie die Manifestdatei Ihrer App und fügen Sie das folgende Tag als untergeordnetes Element des
<application>-Elements hinzu:
<meta-data android:name="com.google.android.gms.version"
android:value="@integer/google_play_services_version" />
Nachdem Sie Ihr Projekt so eingerichtet haben, dass es auf das Bibliotheksprojekt verweist, können Sie mit der Entwicklung von Funktionen mit den
Google Play-Dienste-APIs beginnen.
Proguard-Ausnahme erstellen
Damit ProGuard keine erforderlichen Klassen entfernt, fügen Sie der Datei /proguard-project.txt die folgenden Zeilen hinzu:
-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
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-09-05 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-09-05 (UTC)."],[[["\u003cp\u003eEnsure you have the latest Android SDK, appcompat, mediarouter AndroidX Libraries, and Google Cast SDK installed via the Android SDK Manager.\u003c/p\u003e\n"],["\u003cp\u003eAdd Google Play Services to your project by modifying your \u003ccode\u003ebuild.gradle\u003c/code\u003e file (Android Studio) or referencing the library project and updating the manifest (Other IDEs).\u003c/p\u003e\n"],["\u003cp\u003eIf using ProGuard, include specific exceptions in your configuration file to prevent the removal of necessary Google Play services classes.\u003c/p\u003e\n"]]],[],null,["# Setup for Developing with the Cast Application Framework (CAF) for Android\n\nPrerequisites\n-------------\n\n- Install the latest version of the Android SDK using the [Android SDK\n Manager](//developer.android.com/tools/help/sdk-manager.html).\n- Install the latest version of the appcompat and mediarouter [AndroidX\n Libraries](//developer.android.com/jetpack/androidx) through the [Android SDK\n Manager](//developer.android.com/tools/help/sdk-manager.html).\n- Install the latest [Cast SDK in Google Play\n services](//developer.android.com/google/play-services/setup.html) through the [Android SDK\n Manager](//developer.android.com/tools/help/sdk-manager.html).\n\nThe Google Cast SDK for Android is part of the Google Play services SDK and does\nnot need to be downloaded separately.\n\n**Note** : Google Play services gives you access to a [range of\nAPIs](/android) for building ads, collecting analytics, authenticating users,\nintegrating maps, and much more. For more information, see [Overview of Google Play\nServices](/android/guides/overview).\nIt is important for you to [ensure that the correct Google Play services APK is\ninstalled](/android/guides/setup#ensure_devices_have_the_google_play_services_apk)\non a user's device since updates might not reach all users immediately.\n| **Note:** Since the libraries contribute resources, you cannot simply satisfy the dependencies by including their JAR files; instead you need to [import them as\n| library\n| projects](//developer.android.com/tools/support-library/setup.html#libs-with-res) for your IDE.\n\nAdd Google Play Services to your project\n----------------------------------------\n\n\nSelect your development environment below and add Google Play services to your project by\nfollowing the steps provided. \n\n### Android Studio\n\nTo make the Google Play services APIs available to your app:\n\n1. Open the `build.gradle` file inside your application module directory.\n\n **Note:** Android Studio projects contain a top-level\n `build.gradle` file and a `build.gradle` file for each module. Be sure to\n edit the file for your application module. See\n [Building Your Project with Gradle](//developer.android.com/sdk/installing/studio-build.html) for more information about Gradle.\n2. Verify that `google()` is included in the listed `repositories`. \n\n repositories {\n google()\n }\n\n3. Add a new build rule under `dependencies` for the latest version of `play-services`. For example: \n\n ```carbon\n apply plugin: 'com.android.application'\n ...\n\n dependencies {\n implementation 'androidx.appcompat:appcompat:1.3.1'\n implementation 'androidx.mediarouter:mediarouter:1.2.5'\n implementation 'com.google.android.gms:play-services-cast-framework:22.1.0'\n }\n ```\n\n Be sure you update this version number each time Google Play services is updated.\n\n **Note:** If the number of method references in your app exceeds the\n [65K limit](//developer.android.com/tools/building/multidex.html), your app may fail to\n compile. You may be able to mitigate this problem when compiling your app by specifying only\n the specific Google Play services APIs your app uses, instead of all of them. For information\n on how to do this, see\n [Selectively compiling APIs into your executable](/android/guides/setup#split).\n4. Save the changes and click **Sync Project with Gradle Files** in the toolbar.\n\n### Other IDE\n\nTo make the Google Play services APIs available to your app:\n\n1. Copy the library project at `\u003candroid-sdk\u003e/extras/google/google_play_services/libproject/google-play-services_lib/` to the location where you maintain your Android app projects.\n2. In your app project, reference the Google Play services library project. See [Referencing a Library Project on the Command Line](//developer.android.com/tools/projects/projects-cmdline.html#ReferencingLibraryProject) for more information on how to do this.\n\n **Note:** You should be referencing a copy of the library that you\n copied to your development workspace---you should not reference the library directly from the\n Android SDK directory.\n3. After you've added the Google Play services library as a dependency for your app project, open your app's manifest file and add the following tag as a child of the [`\u003capplication\u003e`](//developer.android.com/guide/topics/manifest/application-element.html) element: \n\n ```transact-sql\n \u003cmeta-data android:name=\"com.google.android.gms.version\"\n android:value=\"@integer/google_play_services_version\" /\u003e\n ```\n\nOnce you've set up your project to reference the library project, you can begin developing\nfeatures with the\n[Google Play services APIs](/android/reference/com/google/android/gms/package-summary).\n\n#### Create a Proguard exception\n\nTo prevent\n[ProGuard](//developer.android.com/tools/help/proguard.html) from stripping away\nrequired classes, add the following lines in the\n/proguard-project.txt file: \n\n```carbon\n-keep public class com.google.android.gms.common.internal.safeparcel.SafeParcelable {\n public static final *** NULL;\n}\n\n-keepnames class * implements android.os.Parcelable\n-keepclassmembers class * implements android.os.Parcelable {\n public static final *** CREATOR;\n}\n\n-keep @interface android.support.annotation.Keep\n-keep @android.support.annotation.Keep class *\n-keepclasseswithmembers class * {\n @android.support.annotation.Keep \u003cfields\u003e;\n}\n-keepclasseswithmembers class * {\n @android.support.annotation.Keep \u003cmethods\u003e;\n}\n\n-keep @interface com.google.android.gms.common.annotation.KeepName\n-keepnames @com.google.android.gms.common.annotation.KeepName class *\n-keepclassmembernames class * {\n @com.google.android.gms.common.annotation.KeepName *;\n}\n\n-keep @interface com.google.android.gms.common.util.DynamiteApi\n-keep public @com.google.android.gms.common.util.DynamiteApi class * {\n public \u003cfields\u003e;\n public \u003cmethods\u003e;\n}\n\n-dontwarn android.security.NetworkSecurityPolicy\n```"]]
