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

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

2.1 Framework'lerin konumu

AKSKit.xcframework ve AppsKit.xcframework dosyalarını doğrudan .xcodeproj ile aynı klasöre yerleştirin — yani Podfile ve uygulamanızın kaynak klasörüyle aynı seviyede olmalılar; kaynak klasörünün veya Pods/ klasörünün içinde değil. Bu konum ö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 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 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şlem sonucunda şunlar oluşmalıdır:

• Her framework için sourceTree = "<group>" ve yalnızca dosya adından oluşan bir path (klasör öneki olmadan) içeren bir PBXFileReference
• Her iki framework için Link Binary With Libraries altında (PBXFrameworksBuildPhase) birer kayıt
• Her iki framework için Embed Frameworks dosya kopyalama derleme aşamasında (PBXCopyFilesBuildPhase, dstSubfolderSpec = 10), CodeSignOnCopy + RemoveHeadersOnCopy özniteliklerini içeren birer kayıt — 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'ü uygulamaya gömdüğünüzde bunu otomatik olarak ekler; bu ayar, uygulamaya gömülen ve imzalanan framework'lerin çalışma zamanında yüklenmesini sağlar).

Xcode arayüzünü kullanmak yerine bu işlemi bir betikle yapıyorsanız (örneğin bir CI kurulum adımında), 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 komutu çalıştırıldıktan sonra YourApp.xcworkspace dosyasını açın. Bu çalışma alanı, uygulama hedefinizi CocoaPods tarafından oluşturulan Pods.xcodeproj ile bir araya getirir; doğrudan .xcodeproj dosyasını açarsanız derleme sırasında Podfile bağımlılıklarınız doğru şekilde bağlanmaz.