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çevelerde kullanılabilir.

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 ekleyin.

  2. NSBonjourServices uygulamasını Info.plist cihazınıza ekleyin

    Yerel ağ keşfinin başarılı olması için Info.plist dosyanızda NSBonjourServices değerini 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. Bu kimlik, 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 uygulamasını Info.plist cihazınıza ekleyin

    Uygulamanızın Info.plist dosyasında NSLocalNetworkUsageDescription için uygulamaya özel bir izin dizesi ekleyerek yerel ağ isteminde gösterilen mesajı özelleştirmenizi önemle tavsiye ederiz. Bu dize, Cast keşfi ve DIAL gibi diğer keşif hizmetlerini açıklayabilir. 

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

    Bu mesaj, örnekte gösterildiği gibi iOS Yerel Ağ Erişimi iletişim kutusunun bir parçası olarak görünür.

    Yayınlama yerel ağ erişimi izinleri iletişim kutusu resmi
  4. Uygulamanızı Apple uygulama mağazasında 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'sı paketi, google-cast-ios-sdk GitHub deposunda mevcuttur.

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

  1. Xcode'da File (Dosya) > Add Packages... (Paket Ekle...) seçeneğini belirleyin.
  2. Kod deposu 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 zarar veren değişiklikler olmadan uyumlu güncellemeleri almak için minimum sürümü 4.8.6 olan 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.

Çerçeve varyantı seçme

Cast iOS SDK'sı 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şaretleri 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. Bu nedenle Swift Package Manager, Cast kullanıcı arayüzü bileşenleri için gereken öğe kaynaklarını (ör. kullanıcı arayüzü resimleri, görsel taslaklar ve yerelleştirme dosyaları) GoogleCastStatic ürünüyle otomatik olarak paketleyemez. Hedefinize GoogleCastStatic eklerseniz aşağıdaki adımları tamamlayı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. Uygulamanızda Cast kullanıcı arayüzü bileşenleri kullanılıyorsa öğe paketlerini projenize manuel olarak ekleyin:
    1. İndirilenler'den statik kitaplığı indirin. Statik kitaplığın sürümünün, eklediğiniz paketin sürümüyle eşleştiğinden emin olun.
    2. Sıkıştırılmış dosyayı açtığınız 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 Gönderen SDK'sı 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. Sıkıştırılmış dosyadan çıkarılan .xcframework dosyasını Xcode proje gezginindeki ana projenize sürükleyin. "Gerekirse tüm öğeleri kopyala"yı işaretleyin ve tüm hedeflere ekleyin.
  4. Xcode hedefinizde, General sekmesinin altında GoogleCast.xcframework için Embed and Sign seçeneğini belirleyin.

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

  1. Varsa GoogleCastSDK uygulamasının mevcut sürümünü kaldırın.
  2. Protobuf GitHub deposunda bulunan talimatları uygulayarak Protobuf kitaplığı v3.13 veya sonraki bir sürümü ekleyin.

Statik kitaplığı ayarlıyorsanız önceki adımlara ek olarak aşağıdaki adımları 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. Sıkıştırılmış dosyayı açtığınız dizinde Resources 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'sının dinamik kitaplığını kullanın. Çerçeveyi projenize eklemek için manuel kurulum sürecini uygulayın. Ardından, Apple belgelerinde 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 yaparken bağlayıcı hatasına neden olur.

Sonraki
Gizlilik