การตั้งค่าสำหรับการพัฒนาด้วย Cast Application Framework (CAF) สำหรับ Android

ข้อกำหนดเบื้องต้น

Google Cast SDK สำหรับ Android เป็นส่วนหนึ่งของ SDK บริการ Google Play และไม่จำเป็นต้องดาวน์โหลดแยกต่างหาก

หมายเหตุ: บริการ Google Play ช่วยให้คุณเข้าถึงช่วงของ API เพื่อสร้างโฆษณา รวบรวมข้อมูลวิเคราะห์ ตรวจสอบสิทธิ์ผู้ใช้ ผสานรวม Maps และอื่นๆ อีกมากมาย ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของบริการ Google Play คุณต้องตรวจสอบว่าได้ติดตั้ง APK ของบริการ Google Play ที่ถูกต้องในอุปกรณ์ของผู้ใช้ เนื่องจากผู้ใช้บางรายอาจไม่ได้รับการอัปเดตทันที

เพิ่มบริการ Google Play ลงในโปรเจ็กต์

เลือกสภาพแวดล้อมในการพัฒนาซอฟต์แวร์ด้านล่างและเพิ่มบริการ Google Play ลงในโปรเจ็กต์โดยทำตามขั้นตอนที่ระบุ

Android Studio

วิธีทำให้ API ของบริการ Google Play พร้อมใช้งานในแอป

  1. เปิดไฟล์ build.gradle ในไดเรกทอรีโมดูลแอปพลิเคชัน

    หมายเหตุ: โปรเจ็กต์ Android Studio มีไฟล์ build.gradle ระดับบนสุดและไฟล์ build.gradle สำหรับแต่ละโมดูล อย่าลืม แก้ไขไฟล์สำหรับโมดูลแอปพลิเคชัน ดูข้อมูลเพิ่มเติมเกี่ยวกับ Gradle ได้ที่ สร้างโปรเจ็กต์ด้วย Gradle

  2. ตรวจสอบว่า google() รวมอยู่ใน repositories ที่แสดง
    repositories {
        google()
    }
  3. เพิ่มกฎการสร้างใหม่ในส่วน dependencies สำหรับ play-services เวอร์ชันล่าสุด เช่น
    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.3.1'
        }

    โปรดอัปเดตหมายเลขเวอร์ชันนี้ทุกครั้งที่มีการอัปเดตบริการ Google Play

    หมายเหตุ: หากจำนวนการอ้างอิงเมธอดในแอปเกินขีดจำกัด 65, 000 รายการ แอปอาจคอมไพล์ไม่สำเร็จ คุณอาจลดปัญหานี้ได้เมื่อคอมไพล์แอปโดยการระบุเฉพาะ API ของบริการ Google Play ที่แอปของคุณใช้แทนที่จะระบุทั้งหมด ดูข้อมูล เกี่ยวกับวิธีดำเนินการนี้ได้ที่ คอมไพล์ API ลงในไฟล์ที่เรียกใช้งานได้แบบเลือก

  4. บันทึกการเปลี่ยนแปลง แล้วคลิกซิงค์โปรเจ็กต์กับไฟล์ Gradle ในแถบเครื่องมือ

IDE อื่นๆ

วิธีทำให้ API ของบริการ Google Play พร้อมใช้งานในแอป

  1. คัดลอกโปรเจ็กต์ไลบรารีที่ <android-sdk>/extras/google/google_play_services/libproject/google-play-services_lib/ ไปยังตำแหน่งที่คุณดูแลโปรเจ็กต์แอป Android
  2. ในโปรเจ็กต์แอป ให้อ้างอิงโปรเจ็กต์ไลบรารีของบริการ Google Play ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีดำเนินการได้ที่ การอ้างอิงโครงการห้องสมุดในบรรทัดคำสั่ง

    หมายเหตุ: คุณควรอ้างอิงสำเนาของไลบรารีที่คุณคัดลอกไปยังพื้นที่ทํางานสําหรับการพัฒนา ไม่ควรอ้างอิงไลบรารีจากไดเรกทอรี Android SDK โดยตรง

  3. หลังจากเพิ่มไลบรารีบริการ Google Play เป็นทรัพยากร Dependency สำหรับโปรเจ็กต์แอปแล้ว ให้เปิดไฟล์ Manifest ของแอป แล้วเพิ่มแท็กต่อไปนี้เป็นองค์ประกอบย่อยขององค์ประกอบ <application>
    <meta-data android:name="com.google.android.gms.version"
        android:value="@integer/google_play_services_version" />

เมื่อตั้งค่าโปรเจ็กต์ให้ใช้อ้างอิงโปรเจ็กต์ไลบรารีแล้ว คุณจะเริ่มพัฒนาฟีเจอร์ด้วย บริการ Google Play 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