# IOS Sdk Knowledge Patch > iOS SDK - Skill: `nevaberry/ios-sdk-knowledge-patch` (Agent Skill, multi-file: 8 files) - Install (CLI): `npx skillmds@latest add nevaberry/ios-sdk-knowledge-patch` - Raw SKILL.md: https://api.skillmd.com/api/skills/nevaberry/ios-sdk-knowledge-patch/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - License: MIT - Author: nevaberry (https://skillmd.com/u/nevaberry) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/nevaberry/ios-sdk-knowledge-patch --- # iOS SDK Knowledge Patch Use this skill when building, reviewing, testing, or upgrading applications against recent iOS SDKs and Xcode toolchains. Start with the compatibility checks below, then open the topic reference that matches the affected code. ## How to Apply This Patch 1. Inspect the Xcode version, base SDK, deployment target, linked-on SDK, Swift language mode, and device OS before changing code. 2. Distinguish an SDK-linked behavior change from a runtime change. Several behaviors below affect only binaries rebuilt with a newer SDK. 3. Audit removals and deprecations before adopting new APIs or build defaults. 4. Reproduce issues with the same SDK and toolchain used by CI and distribution. 5. Prefer the project's manifests, compiler diagnostics, tests, and observed behavior if they conflict with this guidance. ## Reference Index | Reference | Topics | | --- | --- | | [C++, Swift interop, and language runtime](references/cpp-and-language-interop.md) | C and C++ compatibility, libxml2 allocators, Swift interop, spans, ABI changes, and Objective-C race detection | | [Graphics, media, and spatial APIs](references/graphics-media-and-spatial.md) | Nearby Interaction, broadcast extensions, and Metal residency | | [Networking, security, and distribution](references/networking-security-and-distribution.md) | HTTP loading, TLS and VPN policy, entitlements, enterprise recovery, Safari extensions, attribution, and App Store uploads | | [Persistence, Foundation, and commerce](references/persistence-foundation-and-commerce.md) | Core Data, StoreKit, ISO-8601 parsing, fileports, and named semaphores | | [SwiftUI, UIKit, and text](references/swiftui-uikit-and-documents.md) | Localization, navigation, gestures, text direction, Writing Tools, picker sizing, and screen APIs | | [Toolchain, build, and testing](references/toolchain-build-and-testing.md) | Xcode host and device requirements, explicit modules, linking, package builds, diagnostics, Simulator fixes, and Swift Testing | ## Breaking Changes and Required Migrations ### Remove Core Data Ubiquity Options When building with the newer SDK, the legacy Core Data ubiquity option keys are errors rather than warnings. Remove those keys and migrate synchronization to `NSPersistentCloudKitContainer` or SwiftData. Removing the keys preserves the local store but stops its synchronization. See [Persistence, Foundation, and commerce](references/persistence-foundation-and-commerce.md) for the complete key list and concurrency-import changes. ### Replace the Legacy Push to Talk Entitlement Applications built with the newer SDK cannot use `com.apple.developer.pushkit.unrestricted-voip.ptt`. Migrate to the Push to Talk framework rather than carrying the entitlement forward. ### Raise Legacy Network Security Floors Newly linked applications default to TLS 1.2 for `URLSession` and Network framework connections. IKEv2 also drops DES, 3DES, SHA1-96, SHA1-160, and Diffie-Hellman groups below 14. Update endpoints, VPN profiles, and VPN servers; use an explicit minimum protocol only when a legacy endpoint cannot yet move. ### Stop Using libxml2 Custom Allocators Replace libxml2 allocation functions with the system `malloc`, `realloc`, `free`, and `strdup` family. Remove `xmlMemSetup`, `xmlMemGet`, `xmlGcMemSetup`, `xmlGcMemGet`, and related allocator globals because libxml2 and libxslt now use the system allocator internally. ### Use the Plural StoreKit Entitlement API Replace `Transaction.currentEntitlement(for:)` with `Transaction.currentEntitlements(for:)`. The singular API can omit family-shared transactions. Also require an App Store sign-in before treating `isEligibleForIntroOffer(for:)` as a meaningful eligibility result. ### Fix Localization-Sensitive Text Construction Do not interpolate a nonlocalized value directly into `LocalizedStringResource`, `String(localized:)`, or `AttributedString(localized:)`. Supply a localized value or explicitly use `String(describing:)` for an intentional description. Replace SwiftUI `Text` concatenation with interpolation so translations can reorder content. ### Audit SDK-Linked SwiftUI Behavior For rebuilt applications, paragraph direction is content-based, button-like pickers use fitted sizing, and a `NavigationLink` produces one view instead of a view list in list contexts. Explicitly configure writing direction or button sizing where required, and move escaping `containerValue(_:_:)` modifiers outside the link. ### Keep Indirect Metal Pipelines Resident With Metal 4 command encoders, add render and compute pipelines that support indirect command buffers to the residency set. Do this even when the current driver appears to tolerate a missing residency declaration. ## Build and Runtime Compatibility ### Match Xcode to Its Host Xcode 16.3 requires macOS Sequoia 15.2 or later. Xcode 16.4 requires macOS Sequoia 15.3 through macOS Tahoe 26.1. Xcode 26 requires macOS Sequoia 15.6 or later. Keep local and CI hosts within the selected Xcode release's supported range. ### Respect Device Debugging Floors Xcode 16.3 supports on-device debugging for iOS and tvOS 15 or later, watchOS 7 or later, and visionOS. Xcode 26 raises the watchOS floor to 8 while retaining the iOS and tvOS 15 floors. ### Account for Explicit Swift Modules Swift explicit modules are enabled by default for Swift targets, except for targets using a pre-Swift-5 language version or Swift/C++ interoperability. If a severe compatibility issue blocks a build, use `SWIFT_ENABLE_EXPLICIT_MODULES=NO` as a temporary opt-out while fixing it. ### Treat C++ Container Layout as ABI-Sensitive The toolchain can change the layout of `std::unordered_map`, `std::unordered_set`, their multi variants, and `std::deque` when rebound allocators share an empty base. Enclosing layouts can also change when an empty allocator, comparator, or hasher is reused through `[[no_unique_address]]` or empty inheritance. Rebuild ABI boundaries together and avoid persisting such layouts. ### Diagnose Core Data Concurrency The imported concurrency annotations make `NSManagedObject` non-`Sendable` and `NSManagedObjectContext` `Sendable`; context `perform` closures are also `Sendable`. Keep managed objects inside their context's scope, and launch with `-com.apple.CoreData.ConcurrencyDebug 1` to catch violations. ### Recognize Nonatomic Property Races A synthesized Objective-C nonatomic setter may temporarily store the sentinel `0x400000000000bad0` (`0xbad0` on 32-bit watchOS). A concurrent read that crashes on this value points to unsafe simultaneous property access. ## High-Value API Changes ### Opt In to the New HTTP Loading Mode Set `usesClassicLoadingMode` to `false` on a `URLSessionConfiguration` to test the new HTTP loader before it becomes the default: ```swift let configuration = URLSessionConfiguration.default configuration.usesClassicLoadingMode = false let session = URLSession(configuration: configuration) ``` ### Use StoreKit's Expanded Commerce Metadata Advanced Commerce purchases and `introductoryOfferEligibility(compactJWS:)` are available. New transaction data includes `appTransactionID`, `originalPlatform`, and `period`; the platform type is `AppStore.Platform`, and the former `watchOS` case is folded into `iOS`. ### Use SwiftUI Control and Section APIs `ControlSize` is comparable, and `controlSize(_:)` accepts a range that clamps the environment value. `sectionActions(content:)` adds section actions; they remain trailing on macOS and become individual form rows on iOS and iPadOS. ### Select Gesture Priority Explicitly Use `highPriorityGesture(_:isEnabled:)` when a SwiftUI gesture must precede a native UIKit or AppKit recognizer. Use `simultaneousGesture(_:isEnabled:)` when both should receive equal priority. ### Exercise Swift Testing Exit Paths Swift Testing can test code paths that terminate through `precondition()`, `fatalError()`, or another process exit. Use `swift test --attachments-path ` to control attachment output. ### Use Background Nearby Interaction Deliberately An application with an active Live Activity can perform Ultra Wideband ranging through Nearby Interaction while backgrounded. Tie background ranging to the Live Activity's active lifetime. ## Common Diagnostic Traps - Safari extensions are absent from iOS and visionOS Simulator; test them on a device. - An iOS 18.3 Simulator runtime used with Xcode 16.4 includes the fix for `NSURLSession` requests that otherwise always timed out. - `isEligibleForIntroOffer(for:)` returns `false` when no App Store account is signed in. - `ISO8601FormatStyle` accepts fractional seconds regardless of the `includingFractionalSeconds` setting. - `UIScreen.mainScreen` is deprecated; audit existing uses and avoid adding new dependencies on it. - The generic `std::char_traits` base template is temporarily restored but remains deprecated and should not anchor new code. - `devicectl diagnose` collects a sysdiagnose from the Mac and every available device by default; account for the broader collection scope. ## Distribution Check Before uploading, verify that the archive was produced with an accepted Xcode and platform SDK. Current App Store submission requirements are detailed in [Networking, security, and distribution](references/networking-security-and-distribution.md).