2. Xcode proje kurulumu — xcframework dosyalarını projeye dahil etme

Burada manifest birleştirme veya depo URL'si yok — iki derlenmiş framework'ü Xcode projesine elle (veya ekibinizin kullandığı bir kurulum betiği varsa onunla) bağlıyorsunuz.

2.1 Framework'lerin konumu

AKSKit.xcframework ve AppsKit.xcframework dosyalarını doğrudan .xcodeproj dosyanızla aynı klasöre yerleştirin — yani Podfile ve uygulamanızın kaynak kod klasörüyle aynı düzeyde olmalılar; kaynak kod klasörünün veya Pods/ klasörünün içinde olmamalılar. Bu önemlidir çünkü Xcode, framework referansını yalnızca dosya adından oluşan göreli bir yolla çözümler (özel bir FRAMEWORK_SEARCH_PATHS ayarı gerekmez) — dosyaları taşırsanız proje dosyasındaki referans geçersiz hale gelir.

YourApp/                          <- CocoaPods project root (Podfile lives here)
├── Podfile
├── AKSKit.xcframework/            <- sibling of the .xcodeproj
├── AppsKit.xcframework/           <- sibling of the .xcodeproj
├── YourApp.xcodeproj/
├── YourApp.xcworkspace/           <- open THIS, not the .xcodeproj, once Pods are installed
└── YourApp/                       <- your app target's source folder
    ├── AppDelegate.swift
    └── ...

2.2 Framework'leri uygulama hedefine ekleyin

Xcode'da uygulama hedefinizi seçin → General → Frameworks, Libraries, and Embedded Content bölümüne gidin → her iki .xcframework dosyasını ekleyin ve her biri için Embed & Sign seçeneğini ayarlayın. Bu işlemin sonucunda şunlar oluşmalıdır:

• Her framework için sourceTree = "<group>" ve yalnızca dosya adını içeren bir path (klasör öneki olmadan) ile bir PBXFileReference
• Link Binary With Libraries (PBXFrameworksBuildPhase) altında her iki framework'ün de listelenmesi
• CodeSignOnCopy + RemoveHeadersOnCopy öznitelikleriyle bir Embed Frameworks dosya kopyalama derleme aşamasında (PBXCopyFilesBuildPhase, dstSubfolderSpec = 10) her ikisinin de listelenmesi — Xcode arayüzünde "Embed & Sign" seçildiğinde tam olarak bu yapılandırma oluşturulur

Ayrıca LD_RUNPATH_SEARCH_PATHS ayarının @executable_path/Frameworks değerini içerdiğini doğrulayın (arayüz üzerinden bir framework ekleyip gömdüğünüzde Xcode bunu otomatik olarak ekler; uygulamaya gömülmüş ve imzalanmış framework'lerin çalışma zamanında yüklenmesini bu ayar sağlar).

Xcode arayüzünü kullanmak yerine bu işlemi bir betikle yapıyorsanız (örneğin bir CI kurulum adımı için), project.pbxproj dosyasına eklemeniz gerekenler tam olarak yukarıdaki üç bileşendir: dosya referansı, bağlama aşaması ve gömme aşaması.

2.3 Projeyi değil, çalışma alanını açın

pod install çalıştırıldıktan sonra YourApp.xcworkspace dosyasını açın. Uygulama hedefinizi CocoaPods tarafından oluşturulan Pods.xcodeproj ile bir araya getiren bu çalışma alanıdır; doğrudan .xcodeproj dosyasını açarsanız derleme, Podfile bağımlılıklarınız doğru şekilde bağlanmadan yapılır.