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

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

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

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

Penyiapan Xcode

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

iOS 14

Peringatan iOS 14: Perubahan pada iOS 14 izin akses jaringan lokal telah memengaruhi Google Cast iOS SDK dalam sejumlah cara. Lihat Perubahan iOS 14 dokumen 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, tarik SDK secara manual.

   Catatan: Jika Anda membuat pemilih perangkat kustom di aplikasi, Anda memerlukan secara eksplisit memanggil metode startDiscovery pada 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 Anda untuk memungkinkan penemuan jaringan lokal berhasil di iOS 14.

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

   AppID adalah ID penerima Anda, yang merupakan ID yang sama yang 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 kolom Dialog jaringan dengan menambahkan string izin khusus aplikasi di File Info.plist untuk NSLocalNetworkUsageDescription seperti untuk mendeskripsikan Transmisi penemuan 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 Local Network Access iOS sebagai yang ditampilkan dalam tiruan.

   
4. Merilis ulang aplikasi Anda ke Apple App Store

   Sebaiknya rilis ulang aplikasi Anda menggunakan 4.8.3 sesegera mungkin.

iOS 13

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

iOS 12

Peringatan iOS 12: Jika melakukan pengembangan menggunakan Xcode 10, opsi "Access WiFi Information" kapabilitas diperlukan agar untuk menemukan dan terhubung ke perangkat Transmisi.

Pastikan tombol Akses Informasi Wi-Fi di tombol Kemampuan target ditetapkan ke "Aktif".

Selain itu, profil penyediaan Anda harus mendukung protokol Akses Wi-Fi Informasi. 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 menggunakan panduan CocoaPods untuk membuat Podfile dan project Anda siap 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 harus menentukan rentang pod untuk mencegah perubahan yang dapat menyebabkan gangguan seperti yang dijelaskan dalam panduan podfile.

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

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

Misalnya, '~> 1.6.7' akan mencakup semua versi dari 1.6.7 dan yang lebih baru, tetapi tidak termasuk, 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 saat digunakan bersama. Meskipun perubahan ini akan menghasilkan download yang lebih besar, aplikasi final ukurannya tidak akan bertambah.

Jika perbedaan ukuran mengkhawatirkan situasi Anda, download library dinamis untuk mendapatkan ukuran yang mirip dengan CocoaPods versi sebelum 4.3.1 library.

Download

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

Library Cast iOS Sender SDK 4.8.3:

Statis Dinamis

Langkah-langkah penyiapan

Untuk menginstal library:

1. Download dan ekstrak SDK yang sesuai untuk proyek Anda.
2. Siapkan library GoogleCastSDK dinamis:
3. Tarik .xcframework yang telah diekstrak ke project utama Anda di Navigator project Xcode (bukan ke dalam project Pod jika Anda memilikinya). Centang 'Salin semua item jika diperlukan', dan 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. Menyiapkan 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 belum 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 pustaka Protobuf v3.13 atau yang lebih baru, dengan mengikuti petunjuk yang ada di GitHub Protobuf repo Anda.
2. Di project Xcode Anda, tambahkan tanda -ObjC -lc++ ke Setelan Build > Tanda Penaut Lainnya.
3. Temukan folder Resources dalam direktori yang telah diekstrak dan tarik GoogleCastCoreResources.bundle, GoogleCastUIResources.bundle dan MaterialDialogs.bundle ke dalam project Anda di sebelah GoogleCast.xcframework yang yang ditambahkan sebelumnya. Centang 'Salin semua item jika diperlukan', dan tambahkan ke semua target.

Penyiapan Mac Catalyst

Untuk Aplikasi yang mendukung Mac Catalyst, gunakan library dinamis SDK Cast. Ikuti proses penyiapan manual untuk menambahkan kerangka kerja untuk proyek Anda. Kemudian, kecualikan Cast SDK secara bersyarat dari Mac target sebagaimana disebutkan dalam Dokumentasi Apple. Library statis telah dikompilasi sebelumnya untuk arsitektur iOS, yang menyebabkan penaut saat membangun jaringan untuk target Mac.