2. Xcode proje kurulumu — xcframework dosyalarını projeye ekleme

Burada manifest birleştirme veya depo URL'si yok — iki ikili framework'ü Xcode projesine elle (ya da ekibinizin 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 klasörüyle aynı seviyeye; kaynak klasörünün veya Pods/ klasörünün içine değil. Bu önemlidir çünkü Xcode, framework referansını klasör öneki olmayan bir göreli yolla çözümler (özel bir FRAMEWORK_SEARCH_PATHS ayarı gerekmez) — dosyaları taşırsanız proje dosyasındaki referans bozulur.

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 → her iki .xcframework dosyasını ekleyin ve her biri için Embed & Sign seçeneğini ayarlayın. Bu işlem sonucunda şunlar oluşmalıdır:

• her framework için sourceTree = "<group>" ve klasör öneki olmayan bir path içeren bir PBXFileReference
• Link Binary With Libraries altında her iki framework'ün de listelenmesi (PBXFrameworksBuildPhase)
• Embed Frameworks dosya kopyalama derleme aşaması altında her iki framework'ün de CodeSignOnCopy + RemoveHeadersOnCopy öznitelikleriyle listelenmesi (PBXCopyFilesBuildPhase, dstSubfolderSpec = 10) — 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 içerdiğini doğrulayın (Xcode, arayüz üzerinden bir framework gömdüğünüzde bunu otomatik olarak ekler; gömülü ve imzalanmış framework'lerin çalışma zamanında yüklenmesini sağlayan ayar budur).

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. Bu dosya, uygulama hedefinizi CocoaPods tarafından oluşturulan Pods.xcodeproj ile bir araya getirir; doğrudan .xcodeproj dosyasını açarsanız derleme, Podfile bağımlılıklarınız doğru şekilde bağlanmadan yapılır.