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

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

• ติดตั้ง Android SDK เวอร์ชันล่าสุดโดยใช้ Android SDK Manager
• ติดตั้งไลบรารี AndroidX เวอร์ชันล่าสุดของ appcompat และ mediarouter ผ่าน Android SDK Manager
• ติดตั้ง Cast SDK ในบริการ Google Play เวอร์ชันล่าสุดผ่าน Android SDK Manager

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

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

หมายเหตุ: เนื่องจากไลบรารีมีส่วนร่วมในการจัดหาทรัพยากร คุณจึงไม่สามารถตอบสนอง การขึ้นต่อกันได้เพียงแค่รวมไฟล์ JAR ของไลบรารี แต่คุณต้องนำเข้าเป็น โปรเจ็กต์ไลบรารี สำหรับ IDE ของคุณแทน

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

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

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