Penyiapan untuk Mengembangkan Dengan Framework Aplikasi Cast (CAF) untuk iOS

Framework Cast mendukung iOS 14 dan yang lebih baru, serta tersedia dalam framework statis dan dinamis.

Lihat Referensi Google Cast iOS API untuk mengetahui deskripsi semua class dan metode.

Catatan: Versi baru Cast iOS SDK XCFrameworks kini tersedia, yang mendukung pengembangan di komputer Apple Silicon.

Penyiapan Xcode

Peringatan: Menetapkan tanda Optimization Level Apple Clang - Code Generation ke -Ofast untuk 'Pengoptimalan Agresif Tercepat' akan menyebabkan aplikasi yang menggunakan Cast iOS SDK error karena tidak kompatibel dengan pengoptimalan. SDK mendukung nilai default -Os untuk 'Tercepat, Terkecil'.

iOS 14

Peringatan iOS 14: Perubahan pada izin akses jaringan lokal iOS 14 telah memengaruhi Google Cast iOS SDK dengan beberapa cara. Lihat dokumen Perubahan iOS 14 untuk melihat pengaruhnya terhadap aplikasi Anda.

1. Menambahkan Cast iOS SDK 4.8.3 ke project Anda

   Jika menggunakan CocoaPods, gunakan pod update untuk menambahkan SDK 4.8.3 ke project Anda.

   Jika tidak, ambil SDK secara manual.

   Catatan: Jika Anda mem-build pemilih perangkat kustom di aplikasi, Anda harus memanggil metode startDiscovery secara eksplisit di class GCKDiscoveryManager untuk memulai penemuan perangkat. Pemindaian otomatis dinonaktifkan secara default mulai dari rilis Cast SDK v4.5.0.
2. Tambahkan NSBonjourServices ke Info.plist Anda

   Tentukan NSBonjourServices di Info.plist untuk mengizinkan penemuan jaringan lokal berhasil di iOS 14.

   Anda harus menambahkan _googlecast._tcp dan _<your-app-id>._googlecast._tcp sebagai layanan agar penemuan perangkat berfungsi dengan baik.

   appID adalah receiverID Anda, yang merupakan ID yang sama dengan yang ditentukan di GCKDiscoveryCriteria.

   Perbarui contoh definisi NSBonjourServices berikut dan ganti "ABCD1234" dengan appID Anda.

   <key>NSBonjourServices</key>
   <array>
     <string>_googlecast._tcp</string>
     <string>_ABCD1234._googlecast._tcp</string>
   </array>

3. Tambahkan NSLocalNetworkUsageDescription ke Info.plist

   Sebaiknya sesuaikan pesan yang ditampilkan di perintah Jaringan Lokal dengan menambahkan string izin khusus aplikasi di file Info.plist aplikasi untuk NSLocalNetworkUsageDescription seperti untuk mendeskripsikan penemuan Cast dan layanan penemuan lainnya, seperti DIAL.

   <key>NSLocalNetworkUsageDescription</key>
   <string>${PRODUCT_NAME} uses the local network to discover Cast-enabled devices on your WiFi
   network.</string>

   Pesan ini akan muncul sebagai bagian dari dialog Akses Jaringan Lokal iOS seperti yang ditampilkan dalam tiruan.

   
4. Merilis ulang aplikasi ke Apple App Store

   Sebaiknya rilis ulang aplikasi Anda menggunakan 4.8.3 sesegera mungkin.

iOS 13

Peringatan iOS 13: Perubahan izin Apple ke iOS 13 dan Xcode 11 telah memengaruhi Google Cast iOS SDK dalam sejumlah cara. Lihat dokumen Perubahan iOS 13 untuk melihat pengaruhnya terhadap aplikasi Anda.

iOS 12

Peringatan iOS 12: Jika mengembangkan menggunakan Xcode 10, kemampuan "Akses Informasi Wi-Fi" diperlukan agar dapat menemukan dan terhubung ke perangkat Transmisi.

Pastikan tombol Access WiFi Information di bagian Capabilities target disetel ke "On".

Selain itu, profil penyediaan Anda harus mendukung kemampuan Access WiFi Information. Hal ini dapat ditambahkan di Apple Developer Portal.

Penyiapan CocoaPods

Cara yang disarankan untuk mengintegrasikan Google Cast adalah menggunakan CocoaPods. Untuk integrasi, gunakan CocoaPods google-cast-sdk.

Untuk memulai, ikuti panduan memulai.

Setelah CocoaPods disiapkan, ikuti panduan menggunakan CocoaPods untuk membuat Podfile dan menyiapkan project Anda untuk digunakan dengan Google Cast SDK.

Berikut adalah contoh cara menambahkan CocoaPod google-cast-sdk ke Podfile:

use_frameworks!

platform :ios, '14.0'

def target_pods
  pod 'google-cast-sdk'
end

target 'CastVideos-objc' do
  target_pods
end
target 'CastVideos-swift' do
  target_pods
end

Untuk project Anda, Anda harus menentukan rentang untuk pod guna mencegah perubahan yang tidak terduga seperti yang dijelaskan dalam panduan podfile.

Dalam cuplikan ini, versi 4.8.3 dan versi hingga versi utama berikutnya (major.minor.patch) diizinkan:

pod 'google-cast-sdk', '~> 4.8.3'

Misalnya, '~> 1.6.7' akan menyertakan semua versi dari 1.6.7 dan yang lebih tinggi, tetapi tidak menyertakan, versi 2.0.0.

Penyiapan manual

Petunjuk berikut adalah untuk menambahkan Cast iOS SDK ke project Anda tanpa menggunakan CocoaPods:

Poin Penting: Mulai versi 4.3.1, CocoaPods menggunakan library statis untuk menghindari peringatan simbol duplikat yang disebabkan oleh dependensi library Protobuf bersama saat menggunakan Firebase dan Cast SDK secara bersamaan. Meskipun perubahan ini akan menghasilkan download yang lebih besar, ukuran aplikasi akhir tidak akan bertambah.

Jika perbedaan ukuran menjadi masalah bagi Anda, download library dinamis untuk mendapatkan ukuran yang mirip dengan library CocoaPods versi pra-4.3.1.

Download

Setelah mendownload library yang sesuai di bawah, ikuti langkah-langkah penyiapan untuk menambahkan framework ke project Anda.

Library Cast iOS Sender SDK 4.8.3:

Statis Dinamis

Langkah-langkah penyiapan

Untuk menginstal library:

1. Download dan ekstrak SDK yang sesuai untuk project Anda.
2. Siapkan library GoogleCastSDK dinamis:
3. Tarik .xcframework yang telah diekstrak ke project utama Anda di navigator project Xcode (bukan ke project Pods jika Anda memilikinya). Centang 'Salin semua item jika diperlukan', lalu tambahkan ke semua target.
4. Di target Xcode, pada tab General, pilih Embed and Sign untuk GoogleCast.xcframework.

Jika Anda menyiapkan library statis, ikuti langkah-langkah berikut selain langkah-langkah sebelumnya:

1. Siapkan library Protobuf dengan versi minimum v3.13.
1. Jika project Anda menggunakan CocoaPods:
1. Buka Podfile dan hapus google-cast-sdk jika ada:

   pod 'google-cast-sdk'

2. Tambahkan library Protobuf jika tidak ada:

   pod 'Protobuf', '3.13'

3. Jalankan pod install di folder root project Anda.
2. Jika project Anda tidak menggunakan CocoaPods:
1. Hapus versi GoogleCastSDK saat ini jika ada.
2. Tambahkan library Protobuf v3.13 atau yang lebih baru, dengan mengikuti petunjuk yang ada di repositori GitHub Protobuf.
2. Di project Xcode Anda, tambahkan flag -ObjC -lc++ ke Build Settings > Other Linker Flags.
3. Temukan folder Resources di direktori yang diekstrak, lalu tarik GoogleCastCoreResources.bundle, GoogleCastUIResources.bundle, dan MaterialDialogs.bundle ke project Anda di samping GoogleCast.xcframework yang Anda tambahkan sebelumnya. Centang 'Salin semua item jika diperlukan', dan tambahkan ke semua target.

Penyiapan Mac Catalyst

Untuk Aplikasi yang mendukung Mac Catalyst, gunakan library dinamis Cast SDK. Ikuti proses penyiapan manual untuk menambahkan framework ke project Anda. Kemudian, secara kondisional kecualikan Cast SDK dari target Mac seperti yang disebutkan dalam dokumentasi Apple. Library statis dikompilasi sebelumnya untuk arsitektur iOS, yang menyebabkan error penaut saat mem-build terhadap target Mac.