Add an Unload method.

Author: jonsimantov

analytics/generate_windows_stubs.py

@@ -134,7 +134,11 @@ def generate_function_pointers(header_file_path, output_h_path, output_c_path):
         f.write("\n\n// --- Dynamic Loader Declaration for Windows ---\n")
         f.write("#if defined(_WIN32)\n")
         f.write('#include <windows.h> // For HMODULE\n')
-        f.write("void FirebaseAnalytics_LoadAnalyticsFunctions(HMODULE dll_handle);\n")
+        f.write('// Load Google Analytics functions from the given DLL handle into function pointers.\n')
+        f.write(f'// Returns the number of functions successfully loaded (out of {len(function_details_for_loader)}).\n')
+        f.write("int FirebaseAnalytics_LoadAnalyticsFunctions(HMODULE dll_handle);\n\n")
+        f.write('// Reset all function pointers back to stubs.\n')
+        f.write("void FirebaseAnalytics_UnloadAnalyticsFunctions(void);\n\n")
         f.write("#endif // defined(_WIN32)\n")
         f.write("\n#ifdef __cplusplus\n")
         f.write("}\n")
@@ -156,9 +160,10 @@ def generate_function_pointers(header_file_path, output_h_path, output_c_path):
         f.write("\n\n// --- Dynamic Loader Function for Windows ---\n")
         loader_lines = [
             '#if defined(_WIN32)',
-            'void FirebaseAnalytics_LoadAnalyticsFunctions(HMODULE dll_handle) {',
+            'int FirebaseAnalytics_LoadAnalyticsFunctions(HMODULE dll_handle) {',
+            '    int count = 0;\n',
             '    if (!dll_handle) {',
-            '        return;',
+            '        return count;',
             '    }\n'
         ]
         for name, ret_type, params in function_details_for_loader:
@@ -167,10 +172,16 @@ def generate_function_pointers(header_file_path, output_h_path, output_c_path):
                 f'    FARPROC proc_{name} = GetProcAddress(dll_handle, "{name}");',
                 f'    if (proc_{name}) {{',
                 f'        ptr_{name} = {pointer_type_cast}proc_{name};',
+                f'        count++;',
                 f'    }}'
             ]
             loader_lines.extend(proc_check)
-        loader_lines.append('\n}')
+        loader_lines.append('\n    return count;')
+        loader_lines.append('}\n')
+        loader_lines.append('void FirebaseAnalytics_UnloadAnalyticsFunctions(void) {')
+        for name, ret_type, params in function_details_for_loader:
+            loader_lines.append(f'    ptr_{name} = &Stub_{name};');
+        loader_lines.append('}\n')
         loader_lines.append('#endif // defined(_WIN32)\n')
         f.write('\n'.join(loader_lines))
 

analytics/src/windows/analytics_dynamic.c

@@ -188,91 +188,105 @@ void (*ptr_GoogleAnalytics_SetAnalyticsCollectionEnabled)(bool enabled) =
 
 // --- Dynamic Loader Function for Windows ---
 #if defined(_WIN32)
-void FirebaseAnalytics_LoadAnalyticsFunctions(HMODULE dll_handle) {
+int FirebaseAnalytics_LoadAnalyticsFunctions(HMODULE dll_handle) {
+  int count = 0;
+
   if (!dll_handle) {
-    return;
+    return count;
   }
 
   FARPROC proc_GoogleAnalytics_Item_Create =
       GetProcAddress(dll_handle, "GoogleAnalytics_Item_Create");
   if (proc_GoogleAnalytics_Item_Create) {
     ptr_GoogleAnalytics_Item_Create =
         (GoogleAnalytics_Item * (*)()) proc_GoogleAnalytics_Item_Create;
+    count++;
   }
   FARPROC proc_GoogleAnalytics_Item_InsertInt =
       GetProcAddress(dll_handle, "GoogleAnalytics_Item_InsertInt");
   if (proc_GoogleAnalytics_Item_InsertInt) {
     ptr_GoogleAnalytics_Item_InsertInt =
         (void (*)(GoogleAnalytics_Item* item, const char* key,
                   int64_t value))proc_GoogleAnalytics_Item_InsertInt;
+    count++;
   }
   FARPROC proc_GoogleAnalytics_Item_InsertDouble =
       GetProcAddress(dll_handle, "GoogleAnalytics_Item_InsertDouble");
   if (proc_GoogleAnalytics_Item_InsertDouble) {
     ptr_GoogleAnalytics_Item_InsertDouble =
         (void (*)(GoogleAnalytics_Item* item, const char* key,
                   double value))proc_GoogleAnalytics_Item_InsertDouble;
+    count++;
   }
   FARPROC proc_GoogleAnalytics_Item_InsertString =
       GetProcAddress(dll_handle, "GoogleAnalytics_Item_InsertString");
   if (proc_GoogleAnalytics_Item_InsertString) {
     ptr_GoogleAnalytics_Item_InsertString =
         (void (*)(GoogleAnalytics_Item* item, const char* key,
                   const char* value))proc_GoogleAnalytics_Item_InsertString;
+    count++;
   }
   FARPROC proc_GoogleAnalytics_Item_Destroy =
       GetProcAddress(dll_handle, "GoogleAnalytics_Item_Destroy");
   if (proc_GoogleAnalytics_Item_Destroy) {
     ptr_GoogleAnalytics_Item_Destroy =
         (void (*)(GoogleAnalytics_Item* item))proc_GoogleAnalytics_Item_Destroy;
+    count++;
   }
   FARPROC proc_GoogleAnalytics_ItemVector_Create =
       GetProcAddress(dll_handle, "GoogleAnalytics_ItemVector_Create");
   if (proc_GoogleAnalytics_ItemVector_Create) {
     ptr_GoogleAnalytics_ItemVector_Create = (GoogleAnalytics_ItemVector * (*)())
         proc_GoogleAnalytics_ItemVector_Create;
+    count++;
   }
   FARPROC proc_GoogleAnalytics_ItemVector_InsertItem =
       GetProcAddress(dll_handle, "GoogleAnalytics_ItemVector_InsertItem");
   if (proc_GoogleAnalytics_ItemVector_InsertItem) {
     ptr_GoogleAnalytics_ItemVector_InsertItem = (void (*)(
         GoogleAnalytics_ItemVector* item_vector,
         GoogleAnalytics_Item* item))proc_GoogleAnalytics_ItemVector_InsertItem;
+    count++;
   }
   FARPROC proc_GoogleAnalytics_ItemVector_Destroy =
       GetProcAddress(dll_handle, "GoogleAnalytics_ItemVector_Destroy");
   if (proc_GoogleAnalytics_ItemVector_Destroy) {
     ptr_GoogleAnalytics_ItemVector_Destroy =
         (void (*)(GoogleAnalytics_ItemVector* item_vector))
             proc_GoogleAnalytics_ItemVector_Destroy;
+    count++;
   }
   FARPROC proc_GoogleAnalytics_EventParameters_Create =
       GetProcAddress(dll_handle, "GoogleAnalytics_EventParameters_Create");
   if (proc_GoogleAnalytics_EventParameters_Create) {
     ptr_GoogleAnalytics_EventParameters_Create =
         (GoogleAnalytics_EventParameters * (*)())
             proc_GoogleAnalytics_EventParameters_Create;
+    count++;
   }
   FARPROC proc_GoogleAnalytics_EventParameters_InsertInt =
       GetProcAddress(dll_handle, "GoogleAnalytics_EventParameters_InsertInt");
   if (proc_GoogleAnalytics_EventParameters_InsertInt) {
     ptr_GoogleAnalytics_EventParameters_InsertInt = (void (*)(
         GoogleAnalytics_EventParameters* event_parameter_map, const char* key,
         int64_t value))proc_GoogleAnalytics_EventParameters_InsertInt;
+    count++;
   }
   FARPROC proc_GoogleAnalytics_EventParameters_InsertDouble = GetProcAddress(
       dll_handle, "GoogleAnalytics_EventParameters_InsertDouble");
   if (proc_GoogleAnalytics_EventParameters_InsertDouble) {
     ptr_GoogleAnalytics_EventParameters_InsertDouble = (void (*)(
         GoogleAnalytics_EventParameters* event_parameter_map, const char* key,
         double value))proc_GoogleAnalytics_EventParameters_InsertDouble;
+    count++;
   }
   FARPROC proc_GoogleAnalytics_EventParameters_InsertString = GetProcAddress(
       dll_handle, "GoogleAnalytics_EventParameters_InsertString");
   if (proc_GoogleAnalytics_EventParameters_InsertString) {
     ptr_GoogleAnalytics_EventParameters_InsertString = (void (*)(
         GoogleAnalytics_EventParameters* event_parameter_map, const char* key,
         const char* value))proc_GoogleAnalytics_EventParameters_InsertString;
+    count++;
   }
   FARPROC proc_GoogleAnalytics_EventParameters_InsertItemVector =
       GetProcAddress(dll_handle,
@@ -282,45 +296,90 @@ void FirebaseAnalytics_LoadAnalyticsFunctions(HMODULE dll_handle) {
         (void (*)(GoogleAnalytics_EventParameters* event_parameter_map,
                   const char* key, GoogleAnalytics_ItemVector* value))
             proc_GoogleAnalytics_EventParameters_InsertItemVector;
+    count++;
   }
   FARPROC proc_GoogleAnalytics_EventParameters_Destroy =
       GetProcAddress(dll_handle, "GoogleAnalytics_EventParameters_Destroy");
   if (proc_GoogleAnalytics_EventParameters_Destroy) {
     ptr_GoogleAnalytics_EventParameters_Destroy =
         (void (*)(GoogleAnalytics_EventParameters* event_parameter_map))
             proc_GoogleAnalytics_EventParameters_Destroy;
+    count++;
   }
   FARPROC proc_GoogleAnalytics_LogEvent =
       GetProcAddress(dll_handle, "GoogleAnalytics_LogEvent");
   if (proc_GoogleAnalytics_LogEvent) {
     ptr_GoogleAnalytics_LogEvent = (void (*)(
         const char* name, GoogleAnalytics_EventParameters* parameters))
         proc_GoogleAnalytics_LogEvent;
+    count++;
   }
   FARPROC proc_GoogleAnalytics_SetUserProperty =
       GetProcAddress(dll_handle, "GoogleAnalytics_SetUserProperty");
   if (proc_GoogleAnalytics_SetUserProperty) {
     ptr_GoogleAnalytics_SetUserProperty =
         (void (*)(const char* name,
                   const char* value))proc_GoogleAnalytics_SetUserProperty;
+    count++;
   }
   FARPROC proc_GoogleAnalytics_SetUserId =
       GetProcAddress(dll_handle, "GoogleAnalytics_SetUserId");
   if (proc_GoogleAnalytics_SetUserId) {
     ptr_GoogleAnalytics_SetUserId =
         (void (*)(const char* user_id))proc_GoogleAnalytics_SetUserId;
+    count++;
   }
   FARPROC proc_GoogleAnalytics_ResetAnalyticsData =
       GetProcAddress(dll_handle, "GoogleAnalytics_ResetAnalyticsData");
   if (proc_GoogleAnalytics_ResetAnalyticsData) {
     ptr_GoogleAnalytics_ResetAnalyticsData =
         (void (*)())proc_GoogleAnalytics_ResetAnalyticsData;
+    count++;
   }
   FARPROC proc_GoogleAnalytics_SetAnalyticsCollectionEnabled = GetProcAddress(
       dll_handle, "GoogleAnalytics_SetAnalyticsCollectionEnabled");
   if (proc_GoogleAnalytics_SetAnalyticsCollectionEnabled) {
     ptr_GoogleAnalytics_SetAnalyticsCollectionEnabled = (void (*)(
         bool enabled))proc_GoogleAnalytics_SetAnalyticsCollectionEnabled;
+    count++;
   }
+
+  return count;
 }
+
+void FirebaseAnalytics_UnloadAnalyticsFunctions(void) {
+  ptr_GoogleAnalytics_Item_Create = &Stub_GoogleAnalytics_Item_Create;
+  ptr_GoogleAnalytics_Item_InsertInt = &Stub_GoogleAnalytics_Item_InsertInt;
+  ptr_GoogleAnalytics_Item_InsertDouble =
+      &Stub_GoogleAnalytics_Item_InsertDouble;
+  ptr_GoogleAnalytics_Item_InsertString =
+      &Stub_GoogleAnalytics_Item_InsertString;
+  ptr_GoogleAnalytics_Item_Destroy = &Stub_GoogleAnalytics_Item_Destroy;
+  ptr_GoogleAnalytics_ItemVector_Create =
+      &Stub_GoogleAnalytics_ItemVector_Create;
+  ptr_GoogleAnalytics_ItemVector_InsertItem =
+      &Stub_GoogleAnalytics_ItemVector_InsertItem;
+  ptr_GoogleAnalytics_ItemVector_Destroy =
+      &Stub_GoogleAnalytics_ItemVector_Destroy;
+  ptr_GoogleAnalytics_EventParameters_Create =
+      &Stub_GoogleAnalytics_EventParameters_Create;
+  ptr_GoogleAnalytics_EventParameters_InsertInt =
+      &Stub_GoogleAnalytics_EventParameters_InsertInt;
+  ptr_GoogleAnalytics_EventParameters_InsertDouble =
+      &Stub_GoogleAnalytics_EventParameters_InsertDouble;
+  ptr_GoogleAnalytics_EventParameters_InsertString =
+      &Stub_GoogleAnalytics_EventParameters_InsertString;
+  ptr_GoogleAnalytics_EventParameters_InsertItemVector =
+      &Stub_GoogleAnalytics_EventParameters_InsertItemVector;
+  ptr_GoogleAnalytics_EventParameters_Destroy =
+      &Stub_GoogleAnalytics_EventParameters_Destroy;
+  ptr_GoogleAnalytics_LogEvent = &Stub_GoogleAnalytics_LogEvent;
+  ptr_GoogleAnalytics_SetUserProperty = &Stub_GoogleAnalytics_SetUserProperty;
+  ptr_GoogleAnalytics_SetUserId = &Stub_GoogleAnalytics_SetUserId;
+  ptr_GoogleAnalytics_ResetAnalyticsData =
+      &Stub_GoogleAnalytics_ResetAnalyticsData;
+  ptr_GoogleAnalytics_SetAnalyticsCollectionEnabled =
+      &Stub_GoogleAnalytics_SetAnalyticsCollectionEnabled;
+}
+
 #endif  // defined(_WIN32)

analytics/src/windows/analytics_dynamic.h

@@ -112,7 +112,13 @@ extern void (*ptr_GoogleAnalytics_SetAnalyticsCollectionEnabled)(bool enabled);
 // --- Dynamic Loader Declaration for Windows ---
 #if defined(_WIN32)
 #include <windows.h>  // For HMODULE
-void FirebaseAnalytics_LoadAnalyticsFunctions(HMODULE dll_handle);
+// Load Google Analytics functions from the given DLL handle into function
+// pointers. Returns the number of functions successfully loaded (out of 19).
+int FirebaseAnalytics_LoadAnalyticsFunctions(HMODULE dll_handle);
+
+// Reset all function pointers back to stubs.
+void FirebaseAnalytics_UnloadAnalyticsFunctions(void);
+
 #endif  // defined(_WIN32)
 
 #ifdef __cplusplus