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

Cast çerçevesi, iOS 14 ve sonraki sürümleri destekler ve hem statik hem de dinamik çerçevelerde bulunur.

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

Xcode kurulumu

iOS 14

  1. Cast iOS SDK 4.8.3'ü projenize ekleme

    CocoaPods kullanıyorsanız 4.8.3 SDK'sını projenize eklemek için pod update simgesini kullanın.

    Aksi takdirde, SDK'yı manuel olarak alın.

  2. NSBonjourServices'i Info.plist'inize ekleme

    iOS 14'te yerel ağ keşfinin başarılı olmasını sağlamak 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'ü hizmet olarak 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. Info.plist hesabınıza NSLocalNetworkUsageDescription ekleme

    Yerel Ağ isteminde gösterilen mesajı özelleştirmenizi önemle tavsiye ederiz. Bunun için uygulamanızın Info.plist dosyasına NSLocalNetworkUsageDescription için uygulamaya özel bir izin dizesi ekleyin. Örneğin, Cast keşfini ve DIAL gibi diğer keşif hizmetlerini açıklamak için bu dize kullanabilirsiniz. 

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

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

    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.3 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, temel hazırlama profilinizin Kablosuz Ağ Bilgilerine Erişim özelliğini desteklemesi gerekir. Bu, Apple Developer Portalı'ndan 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 talimatları uygulayın.

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

google-cast-sdk CocoaPod'u Podfile'a nasıl ekleyeceğinizi gösteren bir örnek aşağıda verilmiştir:

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

Pod dosyası kılavuzunda açıklandığı gibi, projenizde beklenmedik ve önemli değişiklikleri önlemek için kapsülleriniz için bir aralık belirtmeniz gerekir.

Bu snippet'te 4.8.3 sürümüne ve sonraki ana sürüme (ana.alt.yama) kadarki sürümlere izin verilir:

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

Örneğin, "~> 1.6.7", 1.6.7 sürümünden 2.0.0 sürümünü de dahil edecek şekilde tüm sürümleri içerir.

Manuel kurulum

Aşağıdaki talimatlar, Cast iOS SDK'sını CocoaPods kullanmadan 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.3 kitaplıkları:

Statik Dinamik

Kurulum adımları

Kitaplığı yüklemek için:

  1. Projeniz için uygun SDK'yı indirip açın.
  2. Dinamik GoogleCastSDK kitaplığını ayarlayın:
  3. Sıkıştırılmış .xcframework dosyasını Xcode proje gezgininde ana projenize sürükleyin (Pods projenize değil). "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'i seçin.

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

  1. Protobuf kitaplığını minimum sürüm 3.13 ile ayarlayın.
    1. Projenizde CocoaPods kullanılıyorsa:
      1. Podfile cihazınızı açın ve varsa google-cast-sdk'ı çıkarın: 
        pod 'google-cast-sdk'
      2. Mevcut değilse Protobuf kitaplığını ekleyin: 
        pod 'Protobuf', '3.13'
      3. Projenizin kök klasöründe pod install dosyasını çalıştırın.
    2. Projenizde CocoaPods kullanılmıyorsa:
      1. Varsa GoogleCastSDK'nin mevcut sürümünü kaldırın.
      2. Protobuf GitHub deposundaki talimatları uygulayarak Protobuf kitaplığının 3.13 veya sonraki bir sürümünü ekleyin.
  2. Xcode projenizde Derleme Ayarları > Diğer Bağlantı Oluşturucu İşaretleri'ne -ObjC -lc++ işaretlerini ekleyin.
  3. Sıkıştırılmış dizinde Kaynaklar klasörünü bulun ve GoogleCastCoreResources.bundle, GoogleCastUIResources.bundle ve MaterialDialogs.bundle dosyalarını daha önce eklediğiniz GoogleCast.xcframework dosyasının yanına sürükleyin. "Gerekirse tüm öğeleri kopyala"yı işaretleyin ve tüm hedeflere ekleyin.

Mac Catalyst kurulumu

Mac Catalyst'i destekleyen uygulamalarda 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 dokümanlarında belirtildiği gibi Cast SDK'sını Mac hedefinden koşullu olarak hariç tutun. Statik kitaplıklar iOS mimarisi için önceden derlenir. Bu durum, Mac hedefine göre derleme yapılırken bir bağlayıcı hatasına neden olur.

Sonraki
Gizlilik