Merge pull request #853 from qonversion/kamo/dev-1236-sdk-iosandroid-obvyazki-refetch-rc-posle-identify-i-yavnii

feat: invalidateRemoteConfigsCache() + remote config refetch after same-uid identify (DEV-1236)

Author: SpertsyanKM

sample/src/main/java/io/qonversion/sample/RemoteConfigsFragment.kt

@@ -57,6 +57,11 @@ class RemoteConfigsFragment : Fragment() {
             getRemoteConfig(contextKey.ifEmpty { null })
         }
 
+        binding.buttonInvalidateRemoteConfigsCache.setOnClickListener {
+            Qonversion.shared.invalidateRemoteConfigsCache()
+            Toast.makeText(context, getString(R.string.remote_configs_cache_invalidated), Toast.LENGTH_SHORT).show()
+        }
+
         binding.buttonAttachExperiment.setOnClickListener {
             val experimentId = binding.editExperimentId.text.toString()
             val groupId = binding.editGroupId.text.toString()

sample/src/main/res/layout/fragment_remote_configs.xml

@@ -115,6 +115,15 @@
                     app:backgroundTint="@color/colorDark"
                     app:cornerRadius="8dp" />
 
+                <com.google.android.material.button.MaterialButton
+                    android:id="@+id/buttonInvalidateRemoteConfigsCache"
+                    style="@style/Widget.MaterialComponents.Button.OutlinedButton"
+                    android:layout_width="match_parent"
+                    android:layout_height="48dp"
+                    android:layout_marginTop="8dp"
+                    android:text="@string/invalidate_remote_configs_cache"
+                    app:cornerRadius="8dp" />
+
             </LinearLayout>
         </androidx.cardview.widget.CardView>
 

sample/src/main/res/values/strings.xml

@@ -84,6 +84,8 @@
     <string name="single_remote_config">Single Remote Config</string>
     <string name="context_key_optional">Context Key (optional)</string>
     <string name="get_remote_config">Get Remote Config</string>
+    <string name="invalidate_remote_configs_cache">Invalidate Remote Configs Cache</string>
+    <string name="remote_configs_cache_invalidated">Cache invalidated — the next request fetches a fresh evaluation</string>
     <string name="experiments">Experiments</string>
     <string name="experiment_id">Experiment ID</string>
     <string name="group_id">Group ID</string>

sdk/src/main/java/com/qonversion/android/sdk/Qonversion.kt

@@ -222,6 +222,42 @@ interface Qonversion {
      */
     fun remoteConfigList(callback: QonversionRemoteConfigListCallback)
 
+    /**
+     * Invalidates the in-memory cache of remote configs so the next
+     * [remoteConfig] or [remoteConfigList] call fetches a fresh targeting
+     * evaluation from the server instead of returning the cached copy.
+     *
+     * This method performs no network request itself and has no callback —
+     * it only marks the cached values as stale. A [remoteConfig] load that is
+     * already in flight when this method is called is re-issued once, so its
+     * waiting callbacks receive a fresh evaluation rather than the superseded
+     * one (if the re-issued request fails, the superseded evaluation is
+     * delivered instead); an in-flight [remoteConfigList] load completes with
+     * the evaluation it started with, and any subsequent call fetches fresh
+     * values.
+     *
+     * Call it when the targeting inputs changed and you need the change
+     * reflected immediately, for example:
+     * - after setting a batch of user properties via [setUserProperty] or
+     *   [setCustomUserProperty] that your remote config targeting depends on;
+     * - on returning to the foreground in long-living sessions, if the
+     *   targeting could have changed server-side.
+     *
+     * You do NOT need to call it after [identify] — the SDK invalidates the
+     * cache on identity changes automatically. You also do not need it to
+     * recover from a locally bundled fallback config — fallbacks are never
+     * cached, so the next call retries the network automatically. The screens
+     * shown by No-Code products are not affected by this method.
+     *
+     * Call it from the same thread you use for the other Qonversion calls
+     * (typically the main thread). On Android this method is also safe to
+     * call from any thread.
+     *
+     * @see remoteConfig
+     * @see remoteConfigList
+     */
+    fun invalidateRemoteConfigsCache()
+
     /**
      * This function should be used for the test purposes only. Do not forget to delete the usage of this function before the release.
      * Use this function to attach the user to the experiment.
@@ -329,15 +365,23 @@ interface Qonversion {
      * Sets Qonversion reserved user properties, like email or user id.
      * Note that using [QUserPropertyKey.Custom] here will do nothing.
      * To set custom user property, use [setCustomUserProperty] method instead.
+     * If your remote config targeting depends on this property and you need
+     * the updated evaluation immediately, call [invalidateRemoteConfigsCache]
+     * after setting the properties.
      * @param key defined enum key that will be transformed to string
      * @param value property value
+     * @see invalidateRemoteConfigsCache
      */
     fun setUserProperty(key: QUserPropertyKey, value: String)
 
     /**
-     * Sets custom user property
+     * Sets custom user property.
+     * If your remote config targeting depends on this property and you need
+     * the updated evaluation immediately, call [invalidateRemoteConfigsCache]
+     * after setting the properties.
      * @param key custom user property key
      * @param value property value
+     * @see invalidateRemoteConfigsCache
      */
     fun setCustomUserProperty(key: String, value: String)
 

sdk/src/main/java/com/qonversion/android/sdk/internal/QProductCenterManager.kt

@@ -228,6 +228,16 @@ internal class QProductCenterManager internal constructor(
                 processingPartnersIdentityId = null
 
                 if (currentUserId == qonversionUid) {
+                    // The uid did not change, but the identity did — user
+                    // properties and the external identity are now attached, so
+                    // cached configs may no longer reflect the server-side
+                    // targeting evaluation. Drop them (non-destructively) so the
+                    // next remoteConfig() call refetches; pending requests
+                    // re-issued below fetch fresh as well (DEV-1236 B4).
+                    // Invalidate BEFORE handlePendingRequests: the replay must
+                    // miss the cache, or queued completions would be served the
+                    // pre-identify evaluation.
+                    remoteConfigManager.invalidateRemoteConfigsCache()
                     handlePendingRequests()
                     fireIdentitySuccess(identityId)
                 } else {