chore: update apollo.podspec to use xcframework

Author: fnazarios

Apollo.podspec

@@ -1,48 +1,30 @@
-Pod::Spec.new do |s|
-  s.name = 'Apollo'
-  s.version = `scripts/get-version.sh`
-  s.author = 'Apollo GraphQL'
-  s.homepage = 'https://github.com/apollographql/apollo-ios'
-  s.license = { :type => 'MIT', :file => 'LICENSE' }
-  s.summary = "A GraphQL client for iOS, written in Swift."
-  s.source = { :git => 'https://github.com/apollographql/apollo-ios.git', :tag => s.version }
-  s.requires_arc = true
-  s.swift_version = '5.6'
-  s.default_subspecs = 'Core'
-  s.ios.deployment_target = '12.0'
-  s.osx.deployment_target = '10.14'
-  s.tvos.deployment_target = '12.0'
-  s.watchos.deployment_target = '5.0'
-  s.visionos.deployment_target = '1.0'
-
-  cli_binary_name = 'apollo-ios-cli'
-  s.preserve_paths = [cli_binary_name]
-  s.prepare_command = <<-CMD    
-    make unpack-cli
-  CMD
-
-  s.subspec 'Core' do |ss|
-    ss.source_files = 'Sources/Apollo/**/*.swift','Sources/ApolloAPI/**/*.swift'
-    ss.resource_bundles = {'Apollo' => ['Sources/Apollo/Resources/PrivacyInfo.xcprivacy']}
-  end
-
-  # Apollo provides exactly one persistent cache out-of-the-box, as a reasonable default choice for
-  # those who require cache persistence. Third-party caches may use different storage mechanisms.
-  s.subspec 'SQLite' do |ss|
-    ss.source_files = 'Sources/ApolloSQLite/*.swift'
-    ss.dependency 'Apollo/Core'
-    ss.resource_bundles = {
-      'ApolloSQLite' => ['Sources/ApolloSQLite/Resources/PrivacyInfo.xcprivacy']
-    }
-  end
-
-  # Websocket and subscription support based on Starscream
-  s.subspec 'WebSocket' do |ss|
-    ss.source_files = 'Sources/ApolloWebSocket/**/*.swift'
-    ss.dependency 'Apollo/Core'
-    ss.resource_bundles = {
-      'ApolloWebSocket' => ['Sources/ApolloWebSocket/Resources/PrivacyInfo.xcprivacy']
-    }
-  end
-
+Pod::Spec.new do |spec|
+  spec.name         = "Apollo"
+  spec.version      = "0.0.1"
+  spec.summary      = "Apollo iOS XCFrameworks"
+  spec.description  = "Precompiled Apollo iOS frameworks for GraphQL client"
+  
+  spec.homepage     = "https://github.com/runna-app/apollo-ios"
+  spec.license      = { :type => "MIT" }
+  spec.author       = { "Runna" => "dev@runna.com" }
+  
+  spec.platform     = :ios, "15.0"
+  
+  spec.source       = { :path => "." }
+  
+  spec.vendored_frameworks = [
+    'Apollo.xcframework',
+    'ApolloSQLite.xcframework',
+    'ApolloAPI.xcframework',
+  ]
+  
+  # Ensure the frameworks are preserved during installation
+  spec.preserve_paths = [
+    'Apollo.xcframework',
+    'ApolloSQLite.xcframework',
+    'ApolloAPI.xcframework',
+  ]
+  
+  # Add any required system frameworks
+  spec.frameworks = 'Foundation'
 end

ApolloTestSupport.podspec

@@ -0,0 +1,41 @@
+// swift-tools-version:5.9
+//
+// The swift-tools-version declares the minimum version of Swift required to build this package.
+// Swift 5.9 is available from Xcode 15.0.
+//
+// This is an alternative Package.swift that uses precompiled XCFrameworks from the artifacts folder.
+// To use this instead of the source-based Package.swift:
+// 1. Build the XCFrameworks using: make xcframeworks
+// 2. Rename this file to Package.swift (and backup the original)
+// 3. Update your package dependencies
+
+import PackageDescription
+
+let package = Package(
+  name: "Apollo",
+  platforms: [
+    .iOS(.v17),
+    .watchOS(.v11),
+  ],
+  products: [
+    .library(name: "Apollo", targets: ["Apollo"]),
+    .library(name: "ApolloAPI", targets: ["ApolloAPI"]),
+    .library(name: "ApolloSQLite", targets: ["ApolloSQLite"]),
+  ],
+  dependencies: [
+  ],
+  targets: [
+    .binaryTarget(
+      name: "Apollo",
+      path: "artifacts/Apollo.xcframework"
+    ),
+    .binaryTarget(
+      name: "ApolloAPI",
+      path: "artifacts/ApolloAPI.xcframework"
+    ),
+    .binaryTarget(
+      name: "ApolloSQLite",
+      path: "artifacts/ApolloSQLite.xcframework"
+    ),
+  ]
+)

Package.XCFramework.swift

@@ -0,0 +1,92 @@
+# Using Apollo iOS with XCFrameworks
+
+This project supports two ways to integrate Apollo iOS into your project:
+
+## Option 1: Source-Based Installation (Default)
+
+Use the standard `Package.swift` file which builds Apollo from source. This is the default and recommended approach for most users.
+
+**Pros:**
+- Full source code available for debugging
+- Works with all platforms (iOS, macOS, tvOS, watchOS, visionOS)
+- Automatic updates through Swift Package Manager
+
+**Supported Platforms:**
+- iOS 12.0+
+- macOS 10.14+
+- tvOS 12.0+
+- watchOS 5.0+
+- visionOS 1.0+
+
+## Option 2: Precompiled XCFramework Installation
+
+Use the `Package.XCFramework.swift` file which uses precompiled binary XCFrameworks for faster build times.
+
+**Pros:**
+- Significantly faster build times
+- Smaller project compilation overhead
+- Pre-optimized binaries
+
+**Cons:**
+- Limited to iOS 17.0+ and watchOS 11.0+
+- Requires building XCFrameworks first
+- No source code debugging
+
+**Supported Platforms:**
+- iOS 17.0+
+- watchOS 11.0+
+
+### How to Use XCFrameworks
+
+1. **Build the XCFrameworks:**
+   ```bash
+   make xcframeworks
+   ```
+   This will create XCFrameworks for Apollo, ApolloAPI, and ApolloSQLite in the `artifacts/` folder.
+
+2. **Switch to XCFramework Package:**
+   ```bash
+   # Backup the original Package.swift
+   mv Package.swift Package.Source.swift
+   
+   # Use the XCFramework version
+   mv Package.XCFramework.swift Package.swift
+   ```
+
+3. **Use in your project:**
+   Add the dependency to your project's `Package.swift` as usual:
+   ```swift
+   dependencies: [
+       .package(path: "../path/to/apollo-ios")
+   ]
+   ```
+
+4. **Switch back to source-based (if needed):**
+   ```bash
+   mv Package.swift Package.XCFramework.swift
+   mv Package.Source.swift Package.swift
+   ```
+
+## Available Libraries
+
+Both installation methods provide the following libraries:
+
+- **Apollo**: The core Apollo iOS client
+- **ApolloAPI**: Apollo's GraphQL type system
+- **ApolloSQLite**: SQLite normalized cache implementation
+- **ApolloWebSocket**: WebSocket transport (source-based only)
+- **ApolloTestSupport**: Testing utilities (source-based only)
+
+## Choosing the Right Option
+
+- **Use source-based** if you need:
+  - Support for macOS, tvOS, or visionOS
+  - Access to ApolloWebSocket or ApolloTestSupport
+  - Support for older OS versions
+  - Source-level debugging
+
+- **Use XCFramework** if you:
+  - Only target iOS 17+ and/or watchOS 11+
+  - Want faster build times
+  - Prefer smaller project compilation overhead
+  - Only need Apollo, ApolloAPI, and ApolloSQLite

XCFRAMEWORK_USAGE.md

@@ -8,64 +8,64 @@
 			<key>BinaryPath</key>
 			<string>Apollo.framework/Apollo</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_x86_64-simulator</string>
+			<string>watchos-arm64_arm64_32</string>
 			<key>LibraryPath</key>
 			<string>Apollo.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>x86_64</string>
+				<string>arm64_32</string>
 			</array>
 			<key>SupportedPlatform</key>
-			<string>ios</string>
-			<key>SupportedPlatformVariant</key>
-			<string>simulator</string>
+			<string>watchos</string>
 		</dict>
 		<dict>
 			<key>BinaryPath</key>
 			<string>Apollo.framework/Apollo</string>
 			<key>LibraryIdentifier</key>
-			<string>watchos-arm64_x86_64-simulator</string>
+			<string>ios-arm64</string>
 			<key>LibraryPath</key>
 			<string>Apollo.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
-			<string>watchos</string>
-			<key>SupportedPlatformVariant</key>
-			<string>simulator</string>
+			<string>ios</string>
 		</dict>
 		<dict>
 			<key>BinaryPath</key>
 			<string>Apollo.framework/Apollo</string>
 			<key>LibraryIdentifier</key>
-			<string>watchos-arm64_arm64_32</string>
+			<string>watchos-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>Apollo.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>arm64_32</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>watchos</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
 		</dict>
 		<dict>
 			<key>BinaryPath</key>
 			<string>Apollo.framework/Apollo</string>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64</string>
+			<string>ios-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>Apollo.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
 		</dict>
 	</array>
 	<key>CFBundlePackageType</key>