Merge 27-beta to main

.gitignore

@@ -1,14 +1,28 @@
+# AI
+.claude
+.etabli
+
+# Build Output
 Build/
 TestBuilds/
 scripts/python/__pycache__/
 **/.DS_Store
 **/.idea/*
 **/Temp/*
 plug-ins/**/TestPlayers
+**/Apple Plug-In Support/
+**/Apple Plug-In Support.meta
+**/NativeLibraries~/
+
+# VS Code/Xcode
 **/.vsconfig
 **/xcuserdata
 *.vsconfig
 **/.vscode/*
-**/Apple Plug-In Support/
-**/Apple Plug-In Support.meta
-**/NativeLibraries~/
+
+# IDE-generated solution/project files (regenerated by Unity's IDE integration)
+*.sln
+*.slnx
+*.csproj
+
+

Documentation/Quickstart.md

@@ -19,6 +19,8 @@ The first step is to download or clone the [Apple-Unity Plug-ins repository](htt
 | Apple.GameController | [Apple.GameController Documentation](../plug-ins/Apple.GameController/Apple.GameController_Unity/Assets/Apple.GameController/Documentation~/Apple.GameController.md) | 
 | Apple.GameKit | [Apple.GameKit Documentation](../plug-ins/Apple.GameKit/Apple.GameKit_Unity/Assets/Apple.GameKit/Documentation~/Apple.GameKit.md) | 
 | Apple.PHASE | [Apple.PHASE Documentation](../plug-ins/Apple.PHASE/Apple.PHASE_Unity/Assets/Documentation~/Apple.PHASE.md) | 
+| Apple.SpatialController | [Apple.SpatialController Documentation](../plug-ins/Apple.SpatialController/README.md) |
+| Apple.StoreKit | [Apple.StoreKit Documentation](../plug-ins/Apple.StoreKit/Apple.StoreKit_Unity/Assets/Apple.StoreKit/Documentation~/Apple.StoreKit.md) |
 
 ## 2. Build
 After downloading the plug-in(s), you will need to build the native libraries. If you are familiar with Unity plug-ins, these are compiled assets found in a Unity project's `Assets/.../Plugins/{iOS, macOS, tvOS}/` directories. Along with some C# bridging scripts, they enable communication with Apple devices' native technologies.

README.md

@@ -1,8 +1,5 @@
 # Apple Unity Plug-Ins
 
-## 27 Beta
-
-27 beta is now live! Watch the [WWDC26 video](https://developer.apple.com/videos/play/wwdc2026/378/) for information and check out the `27-beta` branch to test it out. 
 
 ## Overview
 The Apple Unity Plug-Ins expose a selection of Apple platform frameworks to Unity developers.
@@ -16,17 +13,19 @@ To get started with integration of these plug-ins into your Unity projects, run
 | :------ | :---------- |
 | Apple.Core | Provides integrated build post process management and Editor UI.<br/>**Note:** Apple.Core is a dependency of all Apple Unity plug-ins.|
 | Apple.Accessibility | Provides Apple's accessibility to Unity developers allowing adding supports to Apple's built-in assistive technologies such as VoiceOver.|
+| Apple.BackgroundAssets | Exposes Apple’s Background Assets framework to Unity developers, enabling out-of-band delivery of asset packs from Apple or third-party servers. The plug-in also automatically configures generated Xcode projects with a downloader extension and everything else that’s necessary to use Background Assets. |
 | Apple.CoreHaptics | Brings Apple's Core Haptics framework to Unity developers, enabling for customizable haptic patterns and in-depth playback control on supported devices. This Plug-In also includes UIKit's UIFeedbackGenerator API.|
 | Apple.GameController | Exposes Apple's GameController framework to Unity developers allowing for rich controller features in macOS, iOS, and tvOS apps. |
 | Apple.GameKit | Allows Unity developers to easily integrate GameKit features such as leaderboards, achievements, and match making. |
 | Apple.PHASE | The PHASE plug-in allows Unity developers to take full advantage of Apple's new geometry and material aware spatial audio system. |
 | Apple.SpatialController | Exposes Apple's AccessoryTracking and GameController frameworks to Unity developers on visionOS allowing for spatial controller features in visionOS apps. Requires visionOS 26.0 |
+| Apple.StoreKit | Exposes Apple's StoreKit 2 framework to Unity developers, enabling in-app purchases, subscriptions, and transaction management with modern async/await patterns. |
 
 ## Minimum Supported OS Versions
 | OS | Version |
 | :- | :------ |
 | iOS | 15.6 |
-| macOS | 11.5 |
+| macOS | 12.0 |
 | tvOS | 15.6 |
 | visionOS | 1.3 |
 | watchOS | not supported |

build.py

@@ -26,7 +26,7 @@
 # Handle command line args
 
 argument_parser = argparse.ArgumentParser(description="Builds all native libraries, packages plug-ins, and moves packages to build folder.")
-argument_parser.add_argument("-p", "--plugin-list", dest="plugin_list", nargs='*', default=[PluginID.ALL], help=f"Selects the plug-ins to process. Possible values are: {PluginID.ACCESSIBILITY}, {PluginID.CORE}, {PluginID.CORE_HAPTICS}, {PluginID.GAME_CONTROLLER}, {PluginID.SPATIAL_CONTROLLER}, {PluginID.GAME_KIT}, {PluginID.PHASE}, or {PluginID.ALL}. Default is: {PluginID.ALL}")
+argument_parser.add_argument("-p", "--plugin-list", dest="plugin_list", nargs='*', default=[PluginID.ALL], help=f"Selects the plug-ins to process. Possible values are: {PluginID.ACCESSIBILITY}, {PluginID.CORE}, {PluginID.CORE_HAPTICS}, {PluginID.GAME_CONTROLLER}, {PluginID.SPATIAL_CONTROLLER}, {PluginID.GAME_KIT}, {PluginID.PHASE}, {PluginID.STORE_KIT}, {PluginID.BACKGROUND_ASSETS}, or {PluginID.ALL}. Default is: {PluginID.ALL}")
 argument_parser.add_argument("-m", "--platforms", dest="platform_list", nargs='*', default=[PlatformID.ALL], help=f"Selects the desired platforms to target when building native libraries. Possible values are: {PlatformID.IOS}, {PlatformID.IOS_SIMULATOR}, {PlatformID.MACOS}, {PlatformID.TVOS}, {PlatformID.TVOS_SIMULATOR}, {PlatformID.VISIONOS}, {PlatformID.VISIONOS_SIMULATOR}, {PlatformID.SIMULATORS}, {PlatformID.DEVICES} or {PlatformID.ALL}. Default is: {PlatformID.ALL}")
 argument_parser.add_argument("-b", "--build-action", dest="build_actions", nargs='*', default=[BuildActionID.BUILD, BuildActionID.PACK], help=f"Sets the build actions for the selected plug-ins. Possible values are: {BuildActionID.BUILD}, {BuildActionID.PACK}, {BuildActionID.NONE} or {BuildActionID.ALL}. Defaults are: {BuildActionID.BUILD}, {BuildActionID.PACK}")
 argument_parser.add_argument("-bc","--build-config", dest="build_config", default=ConfigID.ALL, help=f"Sets the build configuration to compile. Possible values are: {ConfigID.RELEASE}, {ConfigID.DEBUG}, or {ConfigID.ALL} which builds all other configs. Default is: {ConfigID.ALL}")
@@ -186,7 +186,7 @@ def Main():
             break
         elif platform_id in CTX.platforms:
             if platform_id in supported_platforms:
-                valid_platform_found = True  
+                valid_platform_found = True
                 CTX.platforms[platform_id] = True
             else:
                 CTX.printer.WarningMessage(f"Valid platform '{platform_id}' selected, but no {platform_id} SDK is installed.\nPlease add the SDK:\n  {Printer.Bold('1.')} Open {Printer.Bold('Xcode')}\n  {Printer.Bold('2.')} Open {Printer.Bold('Settings')} (Xcode > Settings...) or (⌘ + ,) \n  {Printer.Bold('3.')} Go to the {Printer.Bold('Platforms')} tab\n  {Printer.Bold('4.')} Install the {platform_id} SDK.")
@@ -235,7 +235,9 @@ def Main():
         PluginID.GAME_CONTROLLER: False,
         PluginID.SPATIAL_CONTROLLER: False,
         PluginID.GAME_KIT: False,
-        PluginID.PHASE: False
+        PluginID.PHASE: False,
+        PluginID.STORE_KIT: False,
+        PluginID.BACKGROUND_ASSETS: False
     }
 
     valid_plugin_found = False
@@ -249,7 +251,7 @@ def Main():
             valid_plugin_found = True
             break
         else:
-            utility.WarningMessage(f"Ignoring unknown plug-in '{plugin_id}'. Valid options are {PluginID.ACCESSIBILITY}, {PluginID.CORE}, {PluginID.CORE_HAPTICS}, {PluginID.GAME_CONTROLLER}, {PluginID.SPATIAL_CONTROLLER}, {PluginID.GAME_KIT}, {PluginID.PHASE}, or {PluginID.ALL} (Default)")
+            CTX.printer.WarningMessage(f"Ignoring unknown plug-in '{plugin_id}'. Valid options are {PluginID.ACCESSIBILITY}, {PluginID.CORE}, {PluginID.CORE_HAPTICS}, {PluginID.GAME_CONTROLLER}, {PluginID.SPATIAL_CONTROLLER}, {PluginID.GAME_KIT}, {PluginID.PHASE}, {PluginID.STORE_KIT}, {PluginID.BACKGROUND_ASSETS}, or {PluginID.ALL} (Default)")
 
     # -------------------------------------------------------------------------
 
@@ -312,18 +314,18 @@ def Main():
     CTX.printer.SectionHeading("Configure Build Paths")
 
     # Configure build paths for packages
-    CTX.build_path = pathlib.Path(build_args.output_path)
+    CTX.build_output_path = pathlib.Path(build_args.output_path)
 
-    if CTX.clean_actions[CleanActionID.PACKAGES] and CTX.build_path.exists():
+    if CTX.clean_actions[CleanActionID.PACKAGES] and CTX.build_output_path.exists():
         CTX.printer.StatusMessage("Cleaning packages.", "\n")
-        CTX.printer.StatusMessageWithContext("Removing folder at path:",  f"{CTX.build_path}")
-        utility.RemoveFolder(CTX.build_path, prompt= not build_args.force_clean, printer= CTX.printer)
+        CTX.printer.StatusMessageWithContext("Removing folder at path:",  f"{CTX.build_output_path}")
+        utility.RemoveFolder(CTX.build_output_path, prompt= not build_args.force_clean, printer= CTX.printer)
 
     if CTX.build_actions[BuildActionID.BUILD] or CTX.build_actions[BuildActionID.PACK]:
-        if not CTX.build_path.exists():
+        if not CTX.build_output_path.exists():
             CTX.printer.Message(f"Build output path not found.", "\n")
-            CTX.printer.StatusMessageWithContext("Creating: ", f"{CTX.build_path}")
-            CTX.build_path.mkdir()
+            CTX.printer.StatusMessageWithContext("Creating: ", f"{CTX.build_output_path}")
+            CTX.build_output_path.mkdir()
 
     # Configure and optionally clean paths for test builds
     test_build_root_path = pathlib.Path(build_args.test_output_path)

plug-ins/Apple.Accessibility/Apple.Accessibility_Unity/Assets/Apple.Accessibility/AccessibilityNode.cs

@@ -3,6 +3,7 @@
 using System.Linq;
 using System.Reflection;
 using System.Runtime.InteropServices;
+using Apple.Core;
 using UnityEngine;
 
 namespace Apple.Accessibility
@@ -388,60 +389,36 @@ private void OnDestroy()
             UnregisterAXElement(this);
         }
 
-        private static Dictionary<ulong, AccessibilityNode> axElements = new Dictionary<ulong, AccessibilityNode>();
+        private static Dictionary<ulong, AccessibilityNode> axElements = new();
 
         static internal void RegisterAXElement(AccessibilityNode obj)
         {
-#if UNITY_6000_4_OR_NEWER
-            if (axElements.ContainsKey(EntityId.ToULong(obj.gameObject.GetEntityId())))
-#else
-            if (axElements.ContainsKey((ulong)obj.gameObject.GetInstanceID()))
-#endif
+            if (axElements.ContainsKey(obj.gameObject.GetLongId()))
             {
                 return;
             }
-
-#if UNITY_6000_4_OR_NEWER
-            axElements.Add(EntityId.ToULong(obj.gameObject.GetEntityId()), obj);
-            AccessibilityNode parent = obj._accessibilityParent();
-            ulong parentId = EntityId.ToULong(EntityId.None);
-#else
-            axElements.Add((ulong)obj.gameObject.GetInstanceID(), obj);
+            axElements.Add(obj.gameObject.GetLongId(), obj);
             AccessibilityNode parent = obj._accessibilityParent();
-            ulong parentId = 0;
-#endif
 
+            // Use Unity's lifetime-aware null check, not C#'s: a destroyed-but-not-collected
+            // parent is non-null to `?.` but null to `parent != null` below, which would leave
+            // us reporting a live parentId alongside hasParent: false.
+            ulong parentId = 0;
             if (parent)
             {
-#if UNITY_6000_4_OR_NEWER
-                parentId = EntityId.ToULong(parent.gameObject.GetEntityId());
-#else
-                parentId = (ulong)parent.gameObject.GetInstanceID();
-#endif
+                parentId = parent.gameObject.GetLongId();
             }
 
 #if (UNITY_IOS || UNITY_TVOS) && !UNITY_EDITOR
-#if UNITY_6000_4_OR_NEWER
-            _UnityAX_RegisterElementWithIdentifier(EntityId.ToULong(obj.gameObject.GetEntityId()), parentId, parent != null);
-#else
-            _UnityAX_RegisterElementWithIdentifier((ulong)obj.gameObject.GetInstanceID(), parentId, parent != null);
-#endif
+            _UnityAX_RegisterElementWithIdentifier(obj.gameObject.GetLongId(), parentId, parent != null);
 #endif
         }
 
         static internal void UnregisterAXElement(AccessibilityNode obj)
         {
-#if UNITY_6000_4_OR_NEWER
-            axElements.Remove(EntityId.ToULong(obj.gameObject.GetEntityId()));
-#else
-            axElements.Remove((ulong)obj.gameObject.GetInstanceID());
-#endif
+            axElements.Remove(obj.gameObject.GetLongId());
 #if (UNITY_IOS || UNITY_TVOS) && !UNITY_EDITOR
-#if UNITY_6000_4_OR_NEWER
-            _UnityAX_UnregisterElementWithIdentifier(EntityId.ToULong(obj.gameObject.GetEntityId()));
-#else
-            _UnityAX_UnregisterElementWithIdentifier((ulong)obj.gameObject.GetInstanceID());
-#endif
+            _UnityAX_UnregisterElementWithIdentifier(obj.gameObject.GetLongId());
 #endif
         }
 
@@ -897,7 +874,7 @@ private static void RegisterCallbacks()
 
 #if (UNITY_IOS || UNITY_TVOS) && !UNITY_EDITOR
         [DllImport("__Internal")] private static extern void _UnityAX_InitializeAXRuntime();
-        [DllImport("__Internal")] private static extern void _UnityAX_RegisterElementWithIdentifier(ulong identifier, ulong parentIdentifier, bool hasParent);
+        [DllImport("__Internal")] private static extern void _UnityAX_RegisterElementWithIdentifier(ulong identifier, ulong parentIdentifier, [MarshalAs(UnmanagedType.I1)] bool hasParent);
         [DllImport("__Internal")] private static extern void _UnityAX_UnregisterElementWithIdentifier(ulong identifier);
 
         private delegate string AccessibilityFrameDelegate(ulong identifier);