StoreKit2 support for Apple devices (#1846)

* StoreKit2 support for Apple devices

* Add conditional building for win / android and make the build.sh changed as I have make the complier xcode

* Linux fix

* Clean up

* revert the to include the old way of header generator

* clean up build and path finding

* Fix tvOS build for Swift by directly compiling in target

* Add in dummy async func to force backward compatability

* [StoreKit2] Fix Xcode 15 dyld launch crashes on iOS <=16 and update documentation

This commit resolves several known compiler and runtime issues when compiling C++ alongside modern Swift (Concurrency) using Xcode 15+ for deployment on iOS 15/16:

1. `swift_task_alloc` (EXC_BAD_ACCESS): Mixing Swift Concurrency with `@objc` interfaces and C++ pointers on older runtimes causes memory segmentation faults. We introduced an Objective-C++ Block Barrier to keep C pointers on the C++ side (`analytics_ios.mm`) and used a detached `Task` with a pure Swift struct (`AppleTransactionVerifier.swift`) to safely isolate the async `Transaction.all` loop from the bridging boundary.
2. `AsyncIteratorProtocol` (Witness Table Corruption): Using a `for await` loop within an `@objc` class on iOS 15/16 triggers a known Xcode 15+ compiler bug leading to a runtime crash. We bypassed this by extracting the logic into a pure Swift struct and replacing the `for await` loop with manual `while let ... = await iterator.next()` iteration.
3. `__libcpp_verbose_abort`: Xcode 15 requires this symbol for C++ exception handling, but it is missing from the iOS 15/16 system `libc++`. We disabled verbose abort globally via `CMakeLists.txt` and provided a weak fallback implementation in `app_framework.cc` for integration tests to prevent a `dyld` launch crash.
4. `libswift_Concurrency.dylib`: The Swift compiler sometimes fails to weak-link the Concurrency backward compatibility library in Objective-C++ projects. We now natively inject `-Wl,-weak-lswift_Concurrency` into all integration test Xcode projects during `setup_integration_tests.py`.

Internal dialog comments have been cleaned up and replaced with professional explanations suitable for open-source maintainers.
Documentation in `release_build_files/readme.md` has been updated to provide clear instructions for manual C++ integrators to apply these linker/compiler flags if they experience similar crashes.

* simplify the build as we have xcode 16 as minimum and we only support ios 15+ which should bundle the concurrency headers

* Remove the old changes

* clean up pbxproj

* revert setup changes

* Continue the clean up

* Clean up some of the un needed changes

* More of the clean up

* Cleanup

* More clean up

* Comment why bitcode was removed

* Fix header inclusion after analytics order of operation change

* Verify readme and clean up  tvos build

* Fix MSVC implicit include flags

* update readme

* Fix __libcpp_verbose_abort signature for Xcode 16

* fix formating

* Remove the FIREBASE_XCODE_TARGET_FORMAT STREQUAL "frameworks")

Author: AustinBenoit

CMakeLists.txt

@@ -96,8 +96,14 @@ set(FIREBASE_XCODE_TARGET_FORMAT "frameworks" CACHE STRING
 set(FIREBASE_CPP_SDK_ROOT_DIR ${CMAKE_CURRENT_LIST_DIR})
 
 project (firebase NONE)
+
+set(CMAKE_Swift_LANGUAGE_VERSION 6.2)
+
 enable_language(C)
 enable_language(CXX)
+if(CMAKE_SYSTEM_NAME STREQUAL "iOS" OR CMAKE_SYSTEM_NAME STREQUAL "tvOS")
+  enable_language(Swift)
+endif()
 
 if(NOT DEFINED CMAKE_CXX_COMPILER_LAUNCHER)
   find_program(CCACHE_PROGRAM ccache)
@@ -477,6 +483,7 @@ if(DESKTOP)
         -DUSE_LIBUV=1
       )
     elseif(APPLE)
+  set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -D_LIBCPP_DISABLE_AVAILABILITY")
       set(websockets_additional_defines
         ${websockets_additional_defines}
         -DUSE_LIBUV=1

analytics/CMakeLists.txt

@@ -72,7 +72,8 @@ set(android_SRCS
 
 # Source files used by the iOS implementation.
 set(ios_SRCS
-    src/analytics_ios.mm)
+    src/analytics_ios.mm
+    src/ios/swift/AppleTransactionVerifier.swift)
 
 # Source files used by the desktop / stub implementation.
 set(desktop_SRCS
@@ -88,8 +89,12 @@ if(ANDROID)
   set(analytics_platform_SRCS
       "${android_SRCS}")
 elseif(IOS)
+  if(CMAKE_GENERATOR STREQUAL "Unix Makefiles")
+    message(FATAL_ERROR "Swift is not supported by the 'Unix Makefiles' generator on iOS. Please use the Xcode generator (-G Xcode) or Ninja (-G Ninja).")
+  endif()
   set(analytics_platform_SRCS
       "${ios_SRCS}")
+  
 else()
   set(analytics_platform_SRCS
       "${desktop_SRCS}")
@@ -99,6 +104,9 @@ add_library(firebase_analytics STATIC
     ${common_SRCS}
     ${analytics_platform_SRCS})
 
+
+add_dependencies(firebase_analytics FIREBASE_ANALYTICS_GENERATED_HEADERS)
+
 set_property(TARGET firebase_analytics PROPERTY FOLDER "Firebase Cpp")
 
 # Set up the dependency on Firebase App.
@@ -122,20 +130,86 @@ target_compile_definitions(firebase_analytics
     -DINTERNAL_EXPERIMENTAL=1
 )
 # Automatically include headers that might not be declared.
-if(MSVC)
-  add_definitions(/FI"assert.h" /FI"string.h" /FI"stdint.h")
+if(IOS)
+  if(MSVC)
+    target_compile_options(firebase_analytics PRIVATE
+      $<$<NOT:$<COMPILE_LANGUAGE:Swift>>:/FI"assert.h">
+      $<$<NOT:$<COMPILE_LANGUAGE:Swift>>:/FI"string.h">
+      $<$<NOT:$<COMPILE_LANGUAGE:Swift>>:/FI"stdint.h">)
+  else()
+    target_compile_options(firebase_analytics PRIVATE
+      $<$<NOT:$<COMPILE_LANGUAGE:Swift>>:SHELL:-include assert.h -include string.h>
+    )
+  endif()
 else()
-  add_definitions(-include assert.h -include string.h)
+  if(MSVC)
+    target_compile_options(firebase_analytics PRIVATE
+      /FI"assert.h" /FI"string.h" /FI"stdint.h")
+  else()
+    target_compile_options(firebase_analytics PRIVATE
+      SHELL:-include assert.h -include string.h
+    )
+  endif()
 endif()
 
 if(ANDROID)
   firebase_cpp_proguard_file(analytics)
 elseif(IOS)
-  # Enable Automatic Reference Counting (ARC) and Bitcode.
+  # Enable Automatic Reference Counting (ARC) and Bitcode specifically for Objective-C++ files.
+  # Note: -fembed-bitcode is placed here for src/analytics_ios.mm so that it is not passed
+  # to the Swift compiler, which does not support the flag.
+  set_source_files_properties(src/analytics_ios.mm PROPERTIES COMPILE_OPTIONS "-fobjc-arc;-fembed-bitcode")
+
+  if(CMAKE_GENERATOR STREQUAL "Xcode")
+    target_include_directories(firebase_analytics PRIVATE "$(DERIVED_FILE_DIR)")
+    target_compile_options(firebase_analytics PRIVATE 
+      "-I$(OBJECT_FILE_DIR_normal)/$(CURRENT_ARCH)"
+    )
+  else()
+    target_include_directories(firebase_analytics PRIVATE "${CMAKE_CURRENT_BINARY_DIR}")
+  endif()
+ 
+  # Swift needs to find the FirebaseAnalytics module from CocoaPods
+  set(pods_dir "${FIREBASE_POD_DIR}/Pods")
+  
+  # Point to the base directories containing the .xcframework folders.
+  # Xcode natively handles XCFrameworks and will pick the right slice automatically.
+  # Determine the xcframework architecture slice based on the target platform
+  # and if it is running on simulator or device.
+  string(TOLOWER "${CMAKE_OSX_SYSROOT}" sysroot_lower)
+  if(CMAKE_SYSTEM_NAME STREQUAL "tvOS")
+    if(sysroot_lower MATCHES "simulator")
+      set(analytics_slice "tvos-arm64_x86_64-simulator")
+    else()
+      set(analytics_slice "tvos-arm64")
+    endif()
+  else()
+    if(sysroot_lower MATCHES "simulator")
+      set(analytics_slice "ios-arm64_x86_64-simulator")
+    else()
+      set(analytics_slice "ios-arm64")
+    endif()
+  endif()
+
+  set(analytics_framework_dir "${pods_dir}/FirebaseAnalytics/Frameworks/FirebaseAnalytics.xcframework/${analytics_slice}")
+  set(measurement_framework_dir "${pods_dir}/GoogleAppMeasurement/Frameworks/GoogleAppMeasurement.xcframework/${analytics_slice}")
+  
   target_compile_options(firebase_analytics
-                         PUBLIC "-fobjc-arc" "-fembed-bitcode")
-  target_link_libraries(firebase_analytics
-                        PUBLIC "-fembed-bitcode")
+    PRIVATE
+      $<$<COMPILE_LANGUAGE:Swift>:-F${analytics_framework_dir}>
+      $<$<COMPILE_LANGUAGE:Swift>:-F${measurement_framework_dir}>
+  )
+  
+  target_link_options(firebase_analytics
+    PUBLIC
+      "-F${analytics_framework_dir}"
+      "-F${measurement_framework_dir}"
+  )
+
+  # Prevent Xcode from trying to build or evaluate headers for unused architectures
+  set_target_properties(firebase_analytics PROPERTIES
+    XCODE_ATTRIBUTE_ONLY_ACTIVE_ARCH "YES"
+  )
 
   setup_pod_headers(
     firebase_analytics

analytics/integration_test/readme.md

@@ -64,6 +64,37 @@ Building and Running the sample
     "Analytics" tab accessible from
     [https://firebase.google.com/console/](https://firebase.google.com/console/).
 
+#### iOS Testing LogAppleTransaction
+
+To test the log apple transaction function, you should use the existing test app and xcode's simulated transactions.
+The manual test will involve running the integration test: `firebase_analytics_test/TestLogAppleTransaction` and verifying that it logs a transaction to the console.
+
+  - Step 1: Set up the Local Xcode Environment
+    - In Xcode, go to File > New > File from Template and create a StoreKit Configuration File (.storekit).
+      - Give the configuration any name.
+      - Target both integration_test and integration_test_tvos
+    - Add at least one dummy product to this file. 
+      - Do this by selecting the file in xcode and clicking the + button in the bottom left corner.
+      - Choose a Non-Consumable in app purchase product. 
+      - Give it a Reference name of your choice (e.g. "ReferenceAppleIapProduct").
+      - Give it a Product ID of your choice (e.g. "com.example.nonconsumable").
+    - Make the app use the store kit file. In the top bar go to Product > Scheme > Edit Scheme...
+      - In the left hand menu select Run
+      - Select the Options tab on the right
+      - Set the StoreKit Configuration dropdown to your new .storekit file.
+  - Step 2: Validate logging transactions
+    - Try running the test app with the dummy transaction ID. It should return an error from the
+      LogAppleTransactions function.
+    - After runnign the app once you can create a simulated transaction for testing.
+    - To create a simulated transaction ID:
+        - Go to Debug > StoreKit > Manage Transactions.
+        - Click the + button in the bottom left corner.
+        - Select the Non-Consumable in app purchase product.
+        - Copy the transaction ID to the test case and replace 'dummy_transaction_id' with your new transaction ID. e.g. '0'
+        - Make sure to update the testcase to now expect success. 
+    - Then try running the test app again with the simulated transaction ID.
+      - It should log the transaction to the console. Both the Xcode console and firebase console should show a log for an in app purchase. 
+
 ### Android
   - Register your Android app with Firebase.
     - Create a new app on the [Firebase console](https://firebase.google.com/console/), and attach

analytics/integration_test/src/integration_test.cc

@@ -22,6 +22,10 @@
 #include <ctime>
 #include <future>
 
+#if defined(__APPLE__)
+#include <TargetConditionals.h>
+#endif
+
 #include "app_framework.h"  // NOLINT
 #include "firebase/analytics.h"
 #include "firebase/analytics/event_names.h"
@@ -299,6 +303,21 @@ TEST_F(FirebaseAnalyticsTest, TestDesktopDebugMode) {
   firebase::analytics::SetDesktopDebugMode(false);
 }
 
+TEST_F(FirebaseAnalyticsTest, TestLogAppleTransaction) {
+  auto future =
+      firebase::analytics::LogAppleTransaction("dummy_transaction_id");
+  WaitForCompletionAnyResult(future, "LogAppleTransaction");
+#if defined(__APPLE__) && (TARGET_OS_IOS || TARGET_OS_TV)
+  // On iOS/tvOS, passing a dummy transaction ID will fail to find a verified
+  // transaction.
+  EXPECT_NE(future.error(), 0);
+#else
+  // On Android and Desktop (including macOS), LogAppleTransaction is a no-op
+  // that returns success.
+  EXPECT_EQ(future.error(), 0);
+#endif
+}
+
 TEST_F(FirebaseAnalyticsTest, TestLogEvents) {
   // Log an event with no parameters.
   firebase::analytics::LogEvent(firebase::analytics::kEventLogin);

analytics/src/analytics_android.cc

@@ -502,6 +502,30 @@ void LogEvent(const char* name) {
   LogEvent(name, nullptr, static_cast<size_t>(0));
 }
 
+/// Log an Apple StoreKit 2 transaction. This is a no-op on Android and returns
+/// success.
+Future<void> LogAppleTransaction(const char* transaction_id) {
+  auto* api = internal::FutureData::Get() ? internal::FutureData::Get()->api()
+                                          : nullptr;
+  if (!api) {
+    return Future<void>();
+  }
+  const auto future_handle =
+      api->SafeAlloc<void>(internal::kAnalyticsFnLogAppleTransaction);
+  api->Complete(future_handle, 0, "");
+  return Future<void>(api, future_handle.get());
+}
+
+Future<void> LogAppleTransactionLastResult() {
+  auto* api = internal::FutureData::Get() ? internal::FutureData::Get()->api()
+                                          : nullptr;
+  if (!api) {
+    return Future<void>();
+  }
+  return static_cast<const Future<void>&>(
+      api->LastResult(internal::kAnalyticsFnLogAppleTransaction));
+}
+
 // Log an event with associated parameters.
 void LogEvent(const char* name, const Parameter* parameters,
               size_t number_of_parameters) {

analytics/src/analytics_common.h

@@ -26,7 +26,8 @@ namespace internal {
 enum AnalyticsFn {
   kAnalyticsFnGetAnalyticsInstanceId,
   kAnalyticsFnGetSessionId,
-  kAnalyticsFnCount
+  kAnalyticsFnLogAppleTransaction,
+  kAnalyticsFnCount,
 };
 
 // Data structure which holds the Future API for this module.

analytics/src/analytics_desktop.cc

@@ -467,6 +467,30 @@ void LogEvent(const char* name) {
   LogEvent(name, static_cast<const Parameter*>(nullptr), 0);
 }
 
+/// Log an Apple StoreKit 2 transaction. This is a no-op on Desktop and returns
+/// success.
+Future<void> LogAppleTransaction(const char* transaction_id) {
+  auto* api = internal::FutureData::Get() ? internal::FutureData::Get()->api()
+                                          : nullptr;
+  if (!api) {
+    return Future<void>();
+  }
+  const auto future_handle =
+      api->SafeAlloc<void>(internal::kAnalyticsFnLogAppleTransaction);
+  api->Complete(future_handle, 0, "");
+  return Future<void>(api, future_handle.get());
+}
+
+Future<void> LogAppleTransactionLastResult() {
+  auto* api = internal::FutureData::Get() ? internal::FutureData::Get()->api()
+                                          : nullptr;
+  if (!api) {
+    return Future<void>();
+  }
+  return static_cast<const Future<void>&>(
+      api->LastResult(internal::kAnalyticsFnLogAppleTransaction));
+}
+
 void LogEvent(const char* name, const char* parameter_name,
               const char* parameter_value) {
   if (parameter_name == nullptr) {

analytics/src/analytics_ios.mm

@@ -20,9 +20,12 @@
 #import "FIRAnalytics+OnDevice.h"
 #import "FIRAnalytics.h"
 
+#include "analytics/src/analytics_common.h"
 #include "analytics/src/include/firebase/analytics.h"
 
-#include "analytics/src/analytics_common.h"
+// Include the generated Swift header for the C++ bridge.
+#include "firebase_analytics-Swift.h"
+
 #include "app/src/assert.h"
 #include "app/src/include/firebase/internal/mutex.h"
 #include "app/src/include/firebase/version.h"
@@ -231,6 +234,42 @@ void LogEvent(const char* name) {
   [FIRAnalytics logEventWithName:@(name) parameters:@{}];
 }
 
+Future<void> LogAppleTransaction(const char* transaction_id) {
+  MutexLock lock(g_mutex);
+  FIREBASE_ASSERT_RETURN(Future<void>(), internal::IsInitialized());
+
+  auto* api = internal::FutureData::Get()->api();
+  const auto future_handle = api->SafeAlloc<void>(internal::kAnalyticsFnLogAppleTransaction);
+
+  if (!transaction_id) {
+    api->Complete(future_handle, -1, "Transaction ID is null");
+    return Future<void>(api, future_handle.get());
+  }
+
+  [AppleTransactionVerifier
+      verifyWithTransactionId:SafeString(transaction_id)
+                   completion:^(BOOL isFound) {
+                     MutexLock lock(g_mutex);
+                     if (!internal::IsInitialized()) return;
+
+                     auto* api = internal::FutureData::Get()->api();
+                     if (isFound) {
+                       api->Complete(future_handle, 0, "");
+                     } else {
+                       api->Complete(future_handle, -1, "StoreKit 2 transaction not found.");
+                     }
+                   }];
+
+  return Future<void>(api, future_handle.get());
+}
+
+Future<void> LogAppleTransactionLastResult() {
+  MutexLock lock(g_mutex);
+  FIREBASE_ASSERT_RETURN(Future<void>(), internal::IsInitialized());
+  return static_cast<const Future<void>&>(
+      internal::FutureData::Get()->api()->LastResult(internal::kAnalyticsFnLogAppleTransaction));
+}
+
 // Declared here so that it can be used, defined below.
 NSDictionary* MapToDictionary(const std::map<Variant, Variant>& map);
 

analytics/src/include/firebase/analytics.h

@@ -455,6 +455,37 @@ void LogEvent(const char* name, const char* parameter_name,
 /// @endif
 void LogEvent(const char* name);
 
+/// @brief Logs an in-app purchase transaction specifically for Apple's
+/// StoreKit 2.
+///
+/// This function is intended for developers on iOS who process transactions
+/// via custom native plugins or engines and need to securely log those
+/// transactions natively through Google Analytics. The provided ID must map 1:1
+/// with the native Apple `Transaction.id`. If a matching transaction is not
+/// found in the Apple device's purchase history, nothing will be logged to
+/// Analytics.
+///
+/// @note Finished consumable transactions are removed from the local
+///       transaction history and cannot be retrieved by this function once
+///       finished. Developers should either call this function before finishing
+///       the transaction or use `FirebaseAnalytics.LogEvent` directly as a
+///       fallback.
+///
+/// @param transaction_id The native Apple transaction identifier as a
+///                       null-terminated string.
+///
+/// @returns A Future<void> that completes successfully when the native
+///          StoreKit 2 transaction is found and logged. If the transaction
+///          cannot be found, the Future will complete with a non-zero error().
+Future<void> LogAppleTransaction(const char* transaction_id);
+
+/// @brief Get the result of the most recent LogAppleTransaction() call.
+///
+/// @returns A Future<void> that completes successfully when the native
+///          StoreKit 2 transaction is found and logged. If the transaction
+///          cannot be found, the Future will complete with a non-zero error().
+Future<void> LogAppleTransactionLastResult();
+
 /// @brief Log an event with associated parameters.
 ///
 /// An Event is an important occurrence in your app that you want to