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

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

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

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

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

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

Android Studio

วิธีทำให้ Google Play services APIs พร้อมใช้งานในแอป

  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 รายการ แอปอาจคอมไพล์ไม่สำเร็จ คุณอาจลดปัญหานี้ได้เมื่อคอมไพล์แอปโดยระบุเฉพาะ Google Play services APIs ที่แอปใช้แทนที่จะระบุทั้งหมด ดูวิธีดำเนินการได้ที่ การคอมไพล์ API ลงในไฟล์ที่เรียกใช้งานได้แบบเลือก

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

IDE อื่นๆ

วิธีทำให้ Google Play services APIs พร้อมใช้งานในแอป

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

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

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

เมื่อตั้งค่าโปรเจ็กต์ให้อ้างอิงโปรเจ็กต์ไลบรารีแล้ว คุณก็เริ่มพัฒนาฟีเจอร์ด้วย บริการ Google Play APIs ได้

สร้างข้อยกเว้น 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