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

Cast çerçevesi, iOS 15 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

iOS 14

iOS 14 Değişiklikleri dokümanına bakın.
  1. Cast iOS SDK 4.8.4'ü projenize ekleme

    CocoaPods kullanıyorsanız 4.8.4 SDK'yı projenize eklemek için pod update komutunu kullanın.

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

  2. NSBonjourServices cihazınızı Info.plist hesabınıza ekleme

    iOS 14'te yerel ağ keşfinin başarılı olması için Info.plist öğenizde NSBonjourServices 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 dosyanızda 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 hesabınıza ekleme

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

    <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ın 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.4 sürümünü kullanarak yeniden yayınlamanızı öneririz.

iOS 13

iOS 12

Hedefin Özellikler bölümündeki Kablosuz ağ bilgilerine erişim anahtarının "Açık" olarak ayarlandığından emin olun.

Ayrıca, sağlama profilinizin Access WiFi Information (Kablosuz ağ bilgilerine erişim) özelliğini desteklemesi gerekir. Bu, Apple Developer Portal'da eklenebilir.

CocoaPods kurulumu

Google Cast'i entegre etmenin önerilen yolu CocoaPods'u kullanmaktır. Entegrasyon için google-cast-sdk CocoaPods'u kullanın.

Başlamak için başlangıç kılavuzundaki adımları uygulayın.

CocoaPods kurulduktan sonra Podfile oluşturmak ve projenizi Google Cast SDK'sı ile kullanıma hazır hale getirmek için CocoaPods'u kullanma kılavuzundaki talimatları uygulayın.

google-cast-sdk CocoaPod'u Podfile projenize nasıl ekleyeceğinize dair bir örneği aşağıda bulabilirsiniz:

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

Projeniz için, Podfile kılavuzunda ayrıntılı olarak açıklandığı gibi beklenmedik uyumsuz değişiklikleri önlemek amacıyla podlarınız için bir aralık belirtmeniz gerekir.

Bu snippet'te 4.8.4 sürümüne ve sonraki ana sürüme (major.minor.patch) kadar olan sürümlere izin verilir:

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

Örneğin, "~> 1.6.7" ifadesi 1.6.7 sürümünden başlayarak 2.0.0 sürümünden önceki son sürümü de dahil olacak şekilde tüm sürümleri kapsar.

Manuel kurulum

Aşağıdaki talimatlar, CocoaPods'u kullanmadan Cast iOS SDK'sını projenize eklemek içindir:

İ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.4 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. Zip'ten çıkarılan .xcframework dosyasını Xcode proje gezgininde ana projenize sürükleyin (Pods projeniz varsa bu projeye sürüklemeyin). "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 seçeneğini belirleyin.

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

  1. Protobuf kitaplığını minimum v3.13 sürümüyle kurun.
    1. Projenizde CocoaPods kullanılıyorsa:
      1. Podfile cihazınızı açın ve varsa google-cast-sdk öğesini çıkarın: 
        pod 'google-cast-sdk'
      2. Yoksa Protobuf kitaplığını ekleyin: 
        pod 'Protobuf', '3.13'
      3. Projenizin kök klasöründe pod install komutunu çalıştırın.
    2. Projenizde CocoaPods kullanılmıyorsa:
      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 > Other Linker Flags'e 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 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 yapılırken bağlayıcı hatasına neden olur.

Sonraki
Gizlilik