Agent-Skills.md

Agent Skills: iOS SDK Knowledge Patch

iOS SDK

UncategorizedID: nevaberry/nevaberry-plugins/ios-sdk-knowledge-patch

Repository

nevaberry/nevaberry-plugins
NevaberryLicense: MIT
23

Install this agent skill to your local

pnpm dlx add-skill https://github.com/Nevaberry/nevaberry-plugins/tree/HEAD/plugins/knowledge-patch/patches-codex/ios-sdk-knowledge-patch

Skill Files

Browse the full folder contents for ios-sdk-knowledge-patch.

Download Skill

Loading file tree…

plugins/knowledge-patch/patches-codex/ios-sdk-knowledge-patch/SKILL.md

Skill Metadata

Name
ios-sdk-knowledge-patch
Description
iOS SDK

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 | C and C++ compatibility, libxml2 allocators, Swift interop, spans, ABI changes, and Objective-C race detection | | Graphics, media, and spatial APIs | Nearby Interaction, broadcast extensions, and Metal residency | | Networking, security, and distribution | HTTP loading, TLS and VPN policy, entitlements, enterprise recovery, Safari extensions, attribution, and App Store uploads | | Persistence, Foundation, and commerce | Core Data, StoreKit, ISO-8601 parsing, fileports, and named semaphores | | SwiftUI, UIKit, and text | Localization, navigation, gestures, text direction, Writing Tools, picker sizing, and screen APIs | | Toolchain, build, and testing | 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 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:

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 <directory> 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.