iOS'te Cast Uygulama Çerçevesi (CAF) ile Geliştirme Kurulumu

Cast çerçevesi, iOS 16 ve sonraki sürümleri destekler ve hem statik hem de dinamik çerçeveler halinde sunulur.

Tüm sınıfların ve yöntemlerin açıklamaları için Google Cast iOS API Referansı'na bakın.

Xcode kurulumu

  1. Cast iOS SDK 4.8.6'yı projenize ekleme

    Swift Package Manager kullanıyorsanız google-cast-ios-sdk paketini 4.8.6 sürümüne güncelleyin.

    Aksi takdirde, SDK'yı manuel olarak çekin.

  2. NSBonjourServices öğesini Info.plist cihazınıza ekleme

    Yerel ağ keşfinin başarılı olması için NSBonjourServices içinde Info.plist belirtin.

    Cihaz keşfinin düzgün çalışması için hem _googlecast._tcp hem de _<your-app-id>._googlecast._tcp hizmetlerini eklemeniz gerekir.

    appID, alıcı kimliğinizdir ve GCKDiscoveryCriteria içinde tanımlanan kimlikle aynıdır.

    Aşağıdaki örnek NSBonjourServices tanımını güncelleyin ve "ABCD1234" yerine uygulama kimliğinizi girin. 

    <key>NSBonjourServices</key>
<array>
  <string>_googlecast._tcp</string>
  <string>_ABCD1234._googlecast._tcp</string>
</array>
  3. NSLocalNetworkUsageDescription öğesini Info.plist cihazınıza ekleme

    Uygulamanızın Info.plist dosyasında NSLocalNetworkUsageDescription uygulamaya özel bir izin dizesi ekleyerek Yerel Ağ isteminde gösterilen mesajı özelleştirmenizi önemle tavsiye ederiz. Örneğin, Cast keşfini ve DIAL gibi diğer keşif hizmetlerini açıklayabilirsiniz. 

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

    Bu mesaj, iOS Yerel Ağ Erişimi iletişim kutusunda gösterilir.

    Yayınlama için yerel ağ erişimi izinleri iletişim kutusu resmi
  4. Uygulamanızı Apple App Store'da yeniden yayınlama

    Ayrıca, uygulamanızı en kısa sürede 4.8.6 sürümünü kullanarak yeniden yayınlamanızı öneririz.

Swift Package Manager kurulumu

Google Cast'i entegre etmenin önerilen yolu Swift Package Manager (SPM) kullanmaktır. Cast iOS SDK paketi, google-cast-ios-sdk GitHub deposunda mevcuttur.

Xcode'da Cast iOS SDK'yı projenize eklemek için:

  1. Xcode'da File (Dosya) > Add Packages... (Paket Ekle...) seçeneğini belirleyin.
  2. Depo URL'sini girin: https://github.com/googlecast/google-cast-ios-sdk.
  3. Sürüm oluşturma kurallarınızı seçin. Örneğin, beklenmedik büyük değişiklikler olmadan uyumlu güncellemeler almak için minimum sürümü 4.8.6 olan Bir Sonraki Ana Sürüme Kadar'ı seçin.
  4. Paket Ekle'yi tıklayın.
  5. GoogleCastDynamic veya GoogleCastStatic ürününü seçip uygulama hedefinize ekleyin.

Bir çerçeve varyantı seçin

Cast iOS SDK paketi iki ürün sunar:

  • GoogleCastDynamic: Dinamik çerçeve. Cast kullanıcı arayüzü bileşenlerinin gerektirdiği tüm öğe kaynaklarını içerir ve ek bağlayıcı işareti gerektirmez. Mac Catalyst'i destekleyen uygulamalar dinamik çerçeveyi kullanmalıdır. Daha fazla bilgi için Mac Catalyst kurulumu başlıklı makaleyi inceleyin.
  • GoogleCastStatic: Statik çerçeve. Statik çerçeve kurulumu bölümünde açıklanan ek kurulum adımları gereklidir.

Statik çerçeve kurulumu

Statik çerçeveler kaynak paketleri içeremez. Sonuç olarak, Swift Package Manager, Cast kullanıcı arayüzü bileşenleri (ör. kullanıcı arayüzü resimleri, storyboard'lar ve yerelleştirme dosyaları) tarafından gereken öğe kaynaklarını GoogleCastStatic ürünüyle otomatik olarak paketleyemez. Hedefinize GoogleCastStatic ekliyorsanız aşağıdaki adımları tamamlayın:

  1. Xcode projenizde -ObjC -lc++ işaretlerini Build Settings > Other Linker Flags'e ekleyin.
  2. Uygulamanızda Cast kullanıcı arayüzü bileşenleri kullanılıyorsa öğe paketlerini projenize manuel olarak ekleyin:
    1. Statik kitaplığı İndirilenler'den indirin. Statik kitaplığın sürümünün, eklediğiniz paketin sürümüyle eşleştiğinden emin olun.
    2. Açılan dizinde Resources klasörünü bulun ve tüm .bundle dosyalarını Xcode projenize sürükleyin. "Gerekirse tüm öğeleri kopyala"yı işaretleyin ve tüm hedeflere ekleyin.

CocoaPods kurulumu

Manuel kurulum

Aşağıdaki talimatlar, Swift Package Manager'ı kullanmadan Cast iOS SDK'sını projenize eklemeyle ilgilidir:

İndirilenler

Aşağıdaki uygun kitaplığı indirdikten sonra, çerçeveyi projenize eklemek için kurulum adımlarını uygulayın.

Cast iOS Sender SDK 4.8.6 kitaplıkları:

Statik Dinamik

Kurulum adımları

Kitaplığı yüklemek için:

  1. Projeniz için uygun SDK'yı indirip ayıklayın.
  2. Dinamik GoogleCastSDK kitaplığını ayarlayın:
  3. Çıkartılan .xcframework dosyasını Xcode proje gezgininde ana projenize sürükleyin. "Gerekirse tüm öğeleri kopyala"yı işaretleyin ve tüm hedeflere ekleyin.
  4. Xcode hedefinizde, General sekmesinde GoogleCast.xcframework için Embed and Sign'i seçin.

Dinamik kitaplığı ayarlıyorsanız önceki adımlara ek olarak aşağıdaki adımları da uygulayın:

  1. Varsa GoogleCastSDK'nın mevcut sürümünü kaldırın.
  2. Protobuf GitHub reposunda yer alan talimatları uygulayarak Protobuf kitaplığı v3.13 veya daha yeni bir sürümünü ekleyin.

Statik kitaplığı ayarlıyorsanız önceki adımlara ek olarak aşağıdaki adımları da uygulayın:

  1. Xcode projenizde -ObjC -lc++ işaretlerini Build Settings (Derleme Ayarları) > Other Linker Flags (Diğer Bağlayıcı İşaretleri) bölümüne ekleyin.
  2. Açılan dizinde Kaynaklar klasörünü bulun ve tüm .bundle dosyalarını, daha önce eklediğiniz GoogleCast.xcframework dosyasının yanına, projenize sürükleyin. "Gerekirse tüm öğeleri kopyala"yı işaretleyin ve tüm hedeflere ekleyin.

Mac Catalyst kurulumu

Mac Catalyst'i destekleyen uygulamalar için Cast SDK'nın dinamik kitaplığını kullanın. Çerçeveyi projenize eklemek için manuel kurulum sürecini uygulayın. Ardından, Apple dokümanlarında belirtildiği gibi Cast SDK'yı Mac hedefinden koşullu olarak hariç tutun. Statik kitaplıklar, iOS mimarisi için önceden derlenir. Bu durum, Mac hedefi için derleme yapılırken bağlayıcı hatasına neden olur.

Sonraki
Gizlilik