fix: storage not working on tvOS (#316)

* fix: storage not working on TvOS

* fix: maxBatchSize and flushIntervalSeconds defaults

* fix: refactor library path

* fix: feedback

* chore: revert changes for UserDefaults

Author: ioannisj

CHANGELOG.md

@@ -1,5 +1,6 @@
 ## Next
 
+- fix: disk storage not working on tvOS ([#316](https://github.com/PostHog/posthog-ios/pull/316))
 - fix: wrong is_identified fallback value ([#317](https://github.com/PostHog/posthog-ios/pull/317))
 
 ## 3.20.0 - 2025-03-04

PostHog/PostHogConfig.swift

@@ -7,6 +7,18 @@
 import Foundation
 
 @objc(PostHogConfig) public class PostHogConfig: NSObject {
+    enum Defaults {
+        #if os(tvOS)
+            static let flushAt: Int = 5
+            static let maxQueueSize: Int = 100
+        #else
+            static let flushAt: Int = 20
+            static let maxQueueSize: Int = 1000
+        #endif
+        static let maxBatchSize: Int = 50
+        static let flushIntervalSeconds: TimeInterval = 30
+    }
+
     @objc(PostHogDataMode) public enum PostHogDataMode: Int {
         case wifi
         case cellular
@@ -15,10 +27,10 @@ import Foundation
 
     @objc public let host: URL
     @objc public let apiKey: String
-    @objc public var flushAt: Int = 20
-    @objc public var maxQueueSize: Int = 1000
-    @objc public var maxBatchSize: Int = 50
-    @objc public var flushIntervalSeconds: TimeInterval = 30
+    @objc public var flushAt: Int = Defaults.flushAt
+    @objc public var maxQueueSize: Int = Defaults.maxQueueSize
+    @objc public var maxBatchSize: Int = Defaults.maxBatchSize
+    @objc public var flushIntervalSeconds: TimeInterval = Defaults.flushIntervalSeconds
     @objc public var dataMode: PostHogDataMode = .any
     @objc public var sendFeatureFlagEvent: Bool = true
     @objc public var preloadFeatureFlags: Bool = true

PostHog/PostHogStorage.swift

@@ -10,11 +10,22 @@ import Foundation
 /**
  # Storage
 
- posthog-ios stores data either to file or to UserDefaults in order to support tvOS. As recordings won't work on tvOS anyways and we have no tvOS users so far,
- we are opting to only support iOS via File storage.
+ Note for tvOS:
+ As tvOS restricts access to persisted Application Support directory, we use Library/Caches instead for storage
+
+ If needed, we can use UserDefaults for lightweight data - according to Apple, you can use UserDefaults to persist up to 500KB of data on tvOS
+ see: https://developer.apple.com/forums/thread/16967?answerId=50696022#50696022
  */
 func applicationSupportDirectoryURL() -> URL {
-    let url = FileManager.default.urls(for: .applicationSupportDirectory, in: .userDomainMask).first!
+    #if os(tvOS)
+        // tvOS restricts access to Application Support directory on physical devices
+        // Use Library/Caches directory which may have less frequent eviction behavior than temp (which is purged when the app quits)
+        let searchPath: FileManager.SearchPathDirectory = .cachesDirectory
+    #else
+        let searchPath: FileManager.SearchPathDirectory = .applicationSupportDirectory
+    #endif
+
+    let url = FileManager.default.urls(for: searchPath, in: .userDomainMask).first!
     let bundleIdentifier = getBundleIdentifier()
 
     return url.appendingPathComponent(bundleIdentifier)
@@ -38,9 +49,16 @@ func appGroupContainerUrl(config: PostHogConfig) -> URL? {
 
     let bundleIdentifier = getBundleIdentifier()
 
+    #if os(tvOS)
+        // tvOS: Due to stricter sandbox rules, creating "Application Support" directory is not possible on tvOS
+        let librarySubPath = "Library/Caches/"
+    #else
+        let librarySubPath = "Library/Application Support/"
+    #endif
+
     let url = FileManager.default
         .containerURL(forSecurityApplicationGroupIdentifier: appGroupIdentifier)?
-        .appendingPathComponent("Library/Application Support/")
+        .appendingPathComponent(librarySubPath)
         .appendingPathComponent(bundleIdentifier)
 
     if let url {