Version 1.0.7

Author: bodenberg

.github/workflows/iOS.yml

@@ -0,0 +1,17 @@
+name: iOS CI
+on: [push, pull_request]
+jobs:
+  build-test:
+    runs-on: macos-14
+    steps:
+      - uses: actions/checkout@v4
+      - name: Select Xcode
+        run: sudo xcode-select -s /Applications/Xcode_16.0.app
+      - name: Build & Test (Xcodeproj)
+        run: |
+          cd iOS
+          xcodebuild -project AppDimens.xcodeproj \
+            -scheme AppDimens \
+            -sdk iphonesimulator \
+            -destination 'platform=iOS Simulator,name=iPhone 15,OS=18.0' \
+            clean build test | xcpretty

Android/appdimens_dynamic/src/main/java/com/appdimens/dynamic/code/AppDimens.kt

@@ -61,14 +61,43 @@ object AppDimens {
             }
         }
 
+    /**
+     * [EN] Registry of all AppDimensDynamic instances for global cache management.
+     * [PT] Registro de todas as instâncias AppDimensDynamic para gerenciamento global de cache.
+     */
+    private val dynamicInstances = mutableSetOf<AppDimensDynamic>()
+    
+    /**
+     * [EN] Registers an AppDimensDynamic instance for global cache management.
+     * [PT] Registra uma instância AppDimensDynamic para gerenciamento global de cache.
+     */
+    @JvmStatic
+    internal fun registerDynamicInstance(instance: AppDimensDynamic) {
+        dynamicInstances.add(instance)
+    }
+    
+    /**
+     * [EN] Unregisters an AppDimensDynamic instance from global cache management.
+     * [PT] Remove o registro de uma instância AppDimensDynamic do gerenciamento global de cache.
+     */
+    @JvmStatic
+    internal fun unregisterDynamicInstance(instance: AppDimensDynamic) {
+        dynamicInstances.remove(instance)
+    }
+    
     /**
      * [EN] Clears all caches from all instances.
      * [PT] Limpa todos os caches de todas as instâncias.
      */
     @JvmStatic
     fun clearAllCaches() {
-        // This would need to be implemented with a registry of instances
-        // For now, individual instances will clear their own caches
+        // Clear the global auto cache
+        AppDimensAutoCache.clearAll()
+        
+        // Clear individual instance caches
+        dynamicInstances.forEach { instance ->
+            instance.clearInstanceCache()
+        }
     }
 
     /**
@@ -120,6 +149,29 @@ object AppDimens {
      * @return True se os ajustes multi-view são ignorados globalmente.
      */
     fun isGlobalIgnoreMultiViewAdjustment(): Boolean = globalIgnoreMultiViewAdjustment
+    
+    /**
+     * [EN] Sets the global cache control setting.
+     * @param enabled If true, enables global cache; if false, disables and clears all caches.
+     * @return The AppDimens instance for chaining.
+     * [PT] Define a configuração global de controle de cache.
+     * @param enabled Se verdadeiro, ativa o cache global; se falso, desativa e limpa todos os caches.
+     * @return A instância AppDimens para encadeamento.
+     */
+    @JvmStatic
+    fun setGlobalCache(enabled: Boolean): AppDimens {
+        globalCacheEnabled = enabled
+        return this
+    }
+    
+    /**
+     * [EN] Gets the current global cache setting.
+     * @return True if global cache is enabled.
+     * [PT] Obtém a configuração global atual de cache.
+     * @return True se o cache global está ativado.
+     */
+    @JvmStatic
+    fun isGlobalCacheEnabled(): Boolean = globalCacheEnabled
 
     /**
      * [EN] Gateway for `AppDimensFixed`.
@@ -186,7 +238,9 @@ object AppDimens {
     @JvmStatic
     fun dynamic(initialValueDp: Float, ignoreMultiViewAdjustment: Boolean? = null): AppDimensDynamic {
         val finalIgnoreMultiView = ignoreMultiViewAdjustment ?: globalIgnoreMultiViewAdjustment
-        return AppDimensDynamic(initialValueDp, finalIgnoreMultiView)
+        val instance = AppDimensDynamic(initialValueDp, finalIgnoreMultiView)
+        registerDynamicInstance(instance)
+        return instance
     }
 
     /**
@@ -201,7 +255,9 @@ object AppDimens {
     @JvmStatic
     fun dynamic(initialValueInt: Int, ignoreMultiViewAdjustment: Boolean? = null): AppDimensDynamic {
         val finalIgnoreMultiView = ignoreMultiViewAdjustment ?: globalIgnoreMultiViewAdjustment
-        return AppDimensDynamic(initialValueInt.toFloat(), finalIgnoreMultiView)
+        val instance = AppDimensDynamic(initialValueInt.toFloat(), finalIgnoreMultiView)
+        registerDynamicInstance(instance)
+        return instance
     }
 
     /**

Android/appdimens_dynamic/src/main/java/com/appdimens/dynamic/code/AppDimensAutoCache.kt

@@ -187,6 +187,20 @@ object AppDimensAutoCache {
         dependencyTracker.clear()
     }
 
+    /**
+     * [EN] Clears cache entries that match a specific pattern.
+     * Useful for clearing instance-specific cache entries.
+     * [PT] Limpa entradas do cache que correspondem a um padrão específico.
+     * Útil para limpar entradas de cache específicas da instância.
+     */
+    fun clearByPattern(pattern: String) {
+        val keysToRemove = cache.keys.filter { it.contains(pattern) }
+        keysToRemove.forEach { key ->
+            cache.remove(key)
+            dependencyTracker.remove(key)
+        }
+    }
+    
     /**
      * [EN] Gets cache statistics for debugging.
      * [PT] Obtém estatísticas do cache para debug.

Android/appdimens_dynamic/src/main/java/com/appdimens/dynamic/code/AppDimensDynamic.kt

@@ -243,7 +243,7 @@ class AppDimensDynamic(
     fun cache(enable: Boolean = true): AppDimensDynamic {
         enableCache = enable
         if (!enable) {
-            autoCache.clearAll()
+            clearInstanceCache()
         }
         return this
     }
@@ -378,6 +378,19 @@ class AppDimensDynamic(
         cachedScreenDimensions = null
         lastConfigurationHash = 0
     }
+    
+    /**
+     * [EN] Clears the cache for this specific instance.
+     * Called by the global cache management system.
+     * [PT] Limpa o cache para esta instância específica.
+     * Chamado pelo sistema de gerenciamento global de cache.
+     */
+    internal fun clearInstanceCache() {
+        invalidateCachedData()
+        // Clear any instance-specific cache entries from the global auto cache
+        val instanceHash = this.hashCode().toString()
+        autoCache.clearByPattern(instanceHash)
+    }
 
     /**
      * [EN] Auxiliary version of `resolveQualifierDp` that works with Float instead of Dp.

iOS/Sources/AppDimens/AppDimens.swift

@@ -92,7 +92,9 @@ public class AppDimens {
      */
     public func dynamic(_ initialValue: CGFloat, ignoreMultiWindowAdjustment: Bool? = nil) -> AppDimensDynamic {
         let ignore = ignoreMultiWindowAdjustment ?? false
-        return AppDimensDynamic(initialValue, ignoreMultiWindowAdjustment: ignore)
+        let instance = AppDimensDynamic(initialValue, ignoreMultiWindowAdjustment: ignore)
+        AppDimensGlobal.registerDynamicInstance(instance)
+        return instance
     }
 
     /**
@@ -131,13 +133,40 @@ public class AppDimensGlobal {
         }
     }
 
+    /// [EN] Registry of all AppDimensDynamic instances for global cache management.
+    /// [PT] Registro de todas as instâncias AppDimensDynamic para gerenciamento global de cache.
+    private static var dynamicInstances = NSHashTable<AppDimensDynamic>.weakObjects()
+    private static let registryQueue = DispatchQueue(label: "com.appdimens.registry", attributes: .concurrent)
+    
+    /// [EN] Registers an AppDimensDynamic instance for global cache management.
+    /// [PT] Registra uma instância AppDimensDynamic para gerenciamento global de cache.
+    public static func registerDynamicInstance(_ instance: AppDimensDynamic) {
+        registryQueue.async(flags: .barrier) {
+            dynamicInstances.add(instance)
+        }
+    }
+    
+    /// [EN] Unregisters an AppDimensDynamic instance from global cache management.
+    /// [PT] Remove o registro de uma instância AppDimensDynamic do gerenciamento global de cache.
+    public static func unregisterDynamicInstance(_ instance: AppDimensDynamic) {
+        registryQueue.async(flags: .barrier) {
+            dynamicInstances.remove(instance)
+        }
+    }
+    
     /**
      * [EN] Clears all caches from all instances.
      * [PT] Limpa todos os caches de todas as instâncias.
      */
     public static func clearAllCaches() {
-        // This would need to be implemented with a registry of instances
-        // For now, individual instances will clear their own caches
+        // Clear the global auto cache
+        AppDimensAutoCache.shared.clearAll()
+        // Clear individual instance caches
+        registryQueue.sync {
+            dynamicInstances.allObjects.forEach { instance in
+                instance.clearInstanceCache()
+            }
+        }
     }
 }
 

iOS/Sources/AppDimens/AppDimensAutoCache.swift

@@ -217,6 +217,23 @@ public class AppDimensAutoCache {
         }
     }
 
+    /**
+     * [EN] Clears cache entries that match a specific pattern.
+     * Useful for clearing instance-specific cache entries.
+     * [PT] Limpa entradas do cache que correspondem a um padrão específico.
+     * Útil para limpar entradas de cache específicas da instância.
+     */
+    public func clearByPattern(_ pattern: String) {
+        cacheQueue.async(flags: .barrier) {
+            let keys = self.cache.allKeys.compactMap { $0 as? String }
+            let keysToRemove = keys.filter { $0.contains(pattern) }
+            keysToRemove.forEach { key in
+                self.cache.removeObject(forKey: key as NSString)
+                self.dependencyTracker.removeObject(forKey: key as NSString)
+            }
+        }
+    }
+    
     /**
      * [EN] Gets cache statistics for debugging.
      * [PT] Obtém estatísticas do cache para debug.

iOS/Sources/AppDimens/AppDimensDynamic.swift

@@ -236,7 +236,7 @@ public class AppDimensDynamic {
     public func cache(enable: Bool = true) -> AppDimensDynamic {
         enableCache = enable
         if !enable {
-            autoCache.clearAll()
+            clearInstanceCache()
         }
         return self
     }
@@ -381,6 +381,16 @@ public class AppDimensDynamic {
         lastConfigurationHash = 0
     }
 
+    /// [EN] Clears the cache for this specific instance.
+    /// Called by the global cache management system.
+    /// [PT] Limpa o cache para esta instância específica.
+    /// Chamado pelo sistema de gerenciamento global de cache.
+    internal func clearInstanceCache() {
+        invalidateCachedData()
+        // Clear any instance-specific cache entries from the global auto cache
+        AppDimensAutoCache.shared.clearByPattern("_\(self.hashValue)")
+    }
+    
     /**
      * [EN] Performs the final dynamic dimension calculation.
      * @return The dynamically adjusted value as a CGFloat (not converted to pixels).