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

Framework Cast mendukung iOS 15 dan yang lebih baru, serta hadir dalam framework statis dan dinamis.

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

Penyiapan Xcode

iOS 14

1. Menambahkan Cast iOS SDK 4.8.4 ke project Anda

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

   Jika tidak, tarik SDK secara manual.

2. Tambahkan NSBonjourServices ke Info.plist

   Tentukan NSBonjourServices di Info.plist agar 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 definisi NSBonjourServices contoh berikut dan ganti "ABCD1234" dengan appID Anda.

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

3. Menambahkan NSLocalNetworkUsageDescription ke Info.plist

   Sebaiknya sesuaikan pesan yang ditampilkan dalam perintah Jaringan Lokal dengan menambahkan string izin khusus aplikasi di file aplikasi Anda Info.plist 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 ditunjukkan dalam contoh.

   
4. Merilis ulang aplikasi Anda ke Apple App Store

   Sebaiknya rilis ulang aplikasi Anda menggunakan 4.8.4 sesegera mungkin.

iOS 13

iOS 12

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

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

Penyiapan CocoaPods

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

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 contoh cara menambahkan CocoaPod google-cast-sdk ke Podfile Anda:

use_frameworks!

platform :ios, '15.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, tentukan rentang untuk pod guna mencegah perubahan yang tidak terduga seperti yang dijelaskan dalam panduan podfile.

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

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

Misalnya, '~> 1.6.7' akan menyertakan semua versi dari 1.6.7 hingga, tetapi tidak termasuk, versi 2.0.0.

Penyiapan manual

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

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.4:

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 belum di-zip ke project utama Anda di navigator project Xcode (bukan ke project Pods jika Anda memilikinya). Centang 'Copy all items if needed', dan tambahkan ke semua target.
4. Di target Xcode Anda, di tab General, pilih Embed and Sign untuk GoogleCast.xcframework.

Jika Anda menyiapkan library dinamis, ikuti langkah-langkah ini selain langkah-langkah sebelumnya:

1. Siapkan library Protobuf dengan versi minimum v3.13.
1. Jika project Anda menggunakan CocoaPods:
1. Buka Podfile Anda 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 GoogleCastSDK versi saat ini jika ada.
2. Tambahkan library Protobuf v3.13 atau yang lebih baru, dengan mengikuti petunjuk yang terdapat di repo GitHub Protobuf.

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

1. Di project Xcode Anda, tambahkan flag -ObjC -lc++ ke Build Settings > Other Linker Flags.
2. Temukan folder Resources di direktori yang belum di-zip dan tarik semua file .bundle ke project Anda di samping GoogleCast.xcframework yang Anda tambahkan sebelumnya. Centang 'Copy all items if needed', 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, kecualikan Cast SDK secara kondisional dari target Mac seperti yang disebutkan dalam dokumentasi Apple. Library statis telah dikompilasi sebelumnya untuk arsitektur iOS, yang menyebabkan error linker saat mem-build terhadap target Mac.