com.azerion.bluestack 6.0.0-beta.1 → 6.0.0-beta.2

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-## [6.0.0-beta.1] - 2026-06-10
+## [6.0.0-beta.2] - 2026-06-10
 
 ### Native SDK upgrades
 

package/Editor/BlueStackDependenciesSource.xml

@@ -1,4 +1,4 @@
-<dependencies version="6.0.0-beta.1">
+<dependencies version="6.0.0-beta.2">
     <androidPackages>
         <androidPackage alias="BlueStack" spec="com.azerion:bluestack-sdk-core:6.0.1">
             <repositories>

package/Runtime/Common/BlueStackSdkInfo.cs

@@ -5,6 +5,6 @@ namespace Azerion.BlueStack.Common
 {
     public static class BlueStackSdkInfo
     {
-        public const string Version = "6.0.0-beta.1";
+        public const string Version = "6.0.0-beta.2";
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "com.azerion.bluestack",
-  "version": "6.0.0-beta.1",
+  "version": "6.0.0-beta.2",
   "displayName": "BlueStack",
   "description": "BlueStack SDK has been designed to give developers options for showing Ads from different ad networks.",
   "unity": "2020.3",

package/CLAUDE.md

@@ -1,157 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## What This Is
-
-`com.azerion.bluestack` — a Unity UPM package (v6.0.0) that wraps the native BlueStack ad SDK for iOS and Android. It exposes a cross-platform C# API for banner, interstitial, rewarded, and native ad formats.
-- **package project repo**: `/Users/moinhasan/Development/Azerdev/bluestack/unity/bluestack-sdk-unity`
-- **UPM package directory**: `/Users/moinhasan/Development/Azerdev/bluestack/unity/bluestack-sdk-unity/plugin`
-
-**Related repos worked on alongside this package:**
-- **Demo/test app**: `/Users/moinhasan/Development/Azerdev/bluestack/unity/bluestack-demo-unity`
-- **Android native bridge source**: `/Users/moinhasan/Development/Azerdev/bluestack/unity/bluestack-sdk-unity/android-bridge`
-- **Public Documentation**: `/Users/moinhasan/Development/Azerdev/bluestack/bluestack-app`
-
----
-
-## Build Commands
-
-### Rebuild Android Bridge AAR
-
-After changing any Kotlin source in `android-bridge/`, rebuild and deploy the AAR:
-
-```bash
-cd /Users/moinhasan/Development/Azerdev/bluestack/unity/bluestack-sdk-unity/android-bridge
-./gradlew mkBlueStackSdk
-```
-
-Output goes to `plugin/Plugins/Android/bluestack-unity-android-bridge-{version}.aar`. The version is set in `android-bridge/build.gradle` ext block.
-
-### iOS Bridge
-
-No build step — Swift/Objective-C files in `Plugins/iOS/` are compiled by Xcode during Unity iOS export. After exporting from Unity, run `pod install` in the generated Xcode project.
-
-### Run SDK Tests
-
-Use **Unity Test Runner** (`Window > General > Test Runner`):
-- `Tests/Runtime/` — `Azerion.BlueStack.Tests` assembly
-- `Tests/Editor/` — `Azerion.BlueStack.Editor.Tests` assembly
-
-Moq is available at `Plugins/Moq/` for mocking interfaces in tests.
-
----
-
-## Architecture
-
-### Layer Stack
-
-```
-Developer code
-    ↓
-API layer          Runtime/API/               Public classes (BannerAd, InterstitialAd, …)
-    ↓
-Interfaces         Runtime/Internal/          IBannerAdClient, IInterstitialAdClient, …
-    ↓
-Platform clients   Runtime/Platforms/
-                     Android/                 AndroidJavaProxy-based wrappers
-                     iOS/                     P/Invoke wrappers
-                     Unity/                   Editor stubs (simulate ads in Play mode)
-    ↓
-Native bridge
-                   Plugins/Android/*.aar      Kotlin — com.azerion.bluestack.unity.*
-                   Plugins/iOS/*.swift/.m     Swift/Obj-C — BSU* classes
-```
-
-### Factory Pattern — Platform Selection
-
-`BlueStackAds.GetClientsFactory()` (in `Runtime/API/BlueStackAds.cs`) selects the platform factory at runtime:
-
-```
-Application.platform == Android  →  Platforms.Android.ClientsFactory
-Application.platform == iPhone   →  Platforms.iOS.ClientsFactory
-anything else (Editor)           →  Platforms.Unity.ClientsFactory  (loaded via Activator.CreateInstance)
-```
-
-The Unity editor factory uses reflection so its assembly (`Azerion.BlueStack.Editor`) doesn't need to be referenced from the runtime assembly. All platform clients implement `IClientsFactory` and create the six client interfaces: `IBlueStackClient`, `IBannerAdClient`, `IInterstitialAdClient`, `IRewardedVideoAdClient`, `INativeAdClient`, `IPreferenceClient`.
-
-### Main Thread Dispatcher
-
-`BlueStackMainThreadDispatcher` (`Runtime/Common/`) is a `DontDestroyOnLoad` MonoBehaviour. Native SDK callbacks arrive on native threads; they must be marshalled to Unity's main thread before firing C# events.
-
-- Call `BlueStackMainThreadDispatcher.ExecuteInUpdate(action)` from any thread
-- Actions are drained in `Update()` under a lock
-- Initialised once by `BlueStackAds.Initialize()`
-
-### Android Platform Client Pattern
-
-- Client classes extend `AndroidJavaProxy`, passing the matching Java interface name to the base constructor (e.g. `UnityBannerAdListenerClassName`)
-- The Java bridge calls back into C# by invoking the proxy's methods on the Unity thread
-- All outbound calls to Java go through `AndroidJavaObjectFactory.Instance.RunOnUiThread(() => _unityBannerAd.Call("methodName", args))` — Android SDK requires UI thread
-- Java class names are centralised in `BlueStackNativeClassNames.cs`
-
-### iOS Platform Client Pattern
-
-- All native function declarations live in `Runtime/Platforms/iOS/Externs.cs` as `[DllImport("__Internal")]`
-- Function naming: `BSU<AdFormat><Action>` (e.g. `BSULoadBannerAd`, `BSUShowRewardedAd`, `BSUDestroyInterstitialAd`)
-- Callbacks from native → C# use typed `delegate` definitions + `[AOT.MonoPInvokeCallback(typeof(DelegateType))]` on `static` methods
-- `GCHandle.Alloc(this)` pins the client instance; `GCHandle.ToIntPtr()` is passed to native as the "client ref" opaque pointer, recovered in callbacks via `GCHandle.FromIntPtr().Target`
-- Native objects are kept alive in `BSUObjectCache` (Swift) until `BSURelease(ptr)` is called
-
-### iOS Native Bridge (Plugins/iOS/)
-
-- `BSUInterface.m` — all `extern "C"` entry points; the only file that crosses the C↔Swift boundary
-- `BSU<Format>.swift` — Swift classes implementing BlueStack iOS SDK delegates (e.g. `BSUBanner: NSObject, BannerViewDelegate`)
-- `BSU<Format>.h` — Objective-C headers exposing Swift classes to C
-- `BSUTypes.h` / `BSUTypes.swift` — opaque pointer `typedef`s (`BSUTypeBannerClientRef`, etc.) shared across all files
-- `BSUObjectCache.swift` — thread-safe singleton (serial dispatch queue); keys objects by memory address string; objects are released by `BSURelease()`
-- `MaskView.swift` — `MTKView` subclass for banner clipping/masking
-- `UnityFramework.modulemap` — module map so Unity's Xcode build can import the bridge headers
-
-Banner positioning strategy in `BSUBanner.swift`:
-- Preset positions (top/bottom): `NSLayoutConstraint` Auto Layout anchored to safe area
-- Custom positions: frame-based with `CATransaction.disableActions` to avoid implicit animations
-
----
-
-## Key Files
-
-| File | Purpose |
-|---|---|
-| `Runtime/API/BlueStackAds.cs` | SDK entry point; factory selection |
-| `Runtime/Internal/IClientsFactory.cs` | Interface every platform factory must implement |
-| `Runtime/Platforms/Android/BlueStackNativeClassNames.cs` | All Java class name constants |
-| `Runtime/Platforms/Android/AndroidJavaObjectFactory.cs` | UI thread runner + Java object creation |
-| `Runtime/Platforms/iOS/Externs.cs` | Every `[DllImport]` declaration |
-| `Runtime/Common/BlueStackMainThreadDispatcher.cs` | Thread-safe callback queue |
-| `Plugins/iOS/BSUInterface.m` | C entry points for all P/Invoke calls |
-| `Plugins/iOS/BSUTypes.h` | Shared opaque pointer typedefs |
-| `Plugins/iOS/BSUObjectCache.swift` | Native object lifetime management |
-| `Editor/BlueStackSettingsEditor.cs` | `Azerion > BlueStack > Settings` menu |
-| `package.json` | UPM manifest (version bump here) |
-| `CHANGELOG.md` | Version history |
-
----
-
-## Adding a New Ad Format
-
-Follow the existing pattern — each format has the same set of files:
-
-1. `Runtime/API/<Format>.cs` — public API class, holds `IFormatClient` reference
-2. `Runtime/Internal/IFormatClient.cs` — interface with Load/Show/Destroy + events
-3. `Runtime/Platforms/Android/<Format>Client.cs` — extends `AndroidJavaProxy`, calls `_unityAd.Call(...)` on UI thread
-4. `Runtime/Platforms/iOS/<Format>Client.cs` — `IntPtr` holder + delegate types + `[MonoPInvokeCallback]` statics
-5. `Runtime/Platforms/Unity/<Format>Client.cs` — Editor stub
-6. Add `Create<Format>Client()` to all three `ClientsFactory.cs` files and to `IClientsFactory`
-7. `Plugins/iOS/BSU<Format>.swift` + `BSU<Format>.h` — Swift delegate implementation
-8. Add `extern "C"` functions to `BSUInterface.m` and declare in `Externs.cs`
-9. Android: add `Unity<Format>Ad.kt` + listener interface to `android-bridge`, rebuild AAR
-
----
-
-## Editor Tooling
-
-- **Settings window**: `Azerion > BlueStack > Settings` — configures AdMob App IDs and mediation networks; writes `Assets/Resources/BlueStackSettings.asset` into the consuming project
-- **Dependency management**: `Editor/BlueStackDependenciesSource.xml` declares native dependencies; EDM4U (`com.google.external-dependency-manager`) resolves them into Android Gradle and iOS Podfile
-- **Post-build hooks**: `Editor/Android/AndroidBuildPostProcess.cs` and `Editor/iOS/BlueStackBuildPostProcess.cs` run after Unity builds to patch Xcode project / Gradle config
-- **Asset post-processor**: `BlueStackAssetPostProcessor.cs` syncs dependency metadata when SDK version changes

package/Example/Scripts/AnchoredBannerExample.cs

@@ -1,179 +0,0 @@
-// using Azerion.BlueStack.API;
-// using UnityEngine;
-// using Azerion.BlueStack.API.Banner;
-//
-// namespace Azerion.BlueStack.Example
-// {
-//     /// <summary>
-//     /// Example script demonstrating anchor-based banner ad positioning.
-//     /// Attach this to any GameObject in your scene and assign an anchor GameObject.
-//     /// </summary>
-//     public class AnchoredBannerExample : MonoBehaviour
-//     {
-//         [Header("Banner Configuration")]
-//         [SerializeField] private string placementId = "your-placement-id";
-//         [SerializeField] private AdSize adSize = AdSize.Banner;
-//         
-//         [Header("Anchor Settings")]
-//         [Tooltip("GameObject to anchor the banner to (automatically creates if null)")]
-//         [SerializeField] private GameObject anchor;
-//         
-//         [Tooltip("Camera for position tracking (null = Camera.main)")]
-//         [SerializeField] private Camera trackingCamera;
-//         
-//         [Header("Auto-Create Anchor")]
-//         [SerializeField] private bool autoCreateAnchor = true;
-//         [SerializeField] private Vector3 anchorWorldPosition = new Vector3(0, 0, 5);
-//         
-//         private BannerAd bannerAd;
-//
-//         void Start()
-//         {
-//             // Create anchor if needed
-//             if (anchor == null && autoCreateAnchor)
-//             {
-//                 CreateAnchor();
-//             }
-//             
-//             if (anchor == null)
-//             {
-//                 Debug.LogError("AnchoredBannerExample: No anchor GameObject assigned or created!");
-//                 return;
-//             }
-//             
-//             // Create banner with anchor
-//             CreateBannerWithAnchor();
-//         }
-//
-//         private void CreateAnchor()
-//         {
-//             anchor = new GameObject("BannerAnchor");
-//             anchor.transform.position = anchorWorldPosition;
-//             
-//             // Optional: Add a visual indicator in editor
-// #if UNITY_EDITOR
-//             var meshFilter = anchor.AddComponent<MeshFilter>();
-//             var meshRenderer = anchor.AddComponent<MeshRenderer>();
-//             
-//             // Create a simple sphere mesh
-//             meshFilter.sharedMesh = Resources.GetBuiltinResource<Mesh>("Sphere.fbx");
-//             
-//             // Make it small and semi-transparent
-//             anchor.transform.localScale = Vector3.one * 0.2f;
-//             
-//             var material = new Material(Shader.Find("Standard"));
-//             material.color = new Color(0, 1, 0, 0.5f);
-//             meshRenderer.sharedMaterial = material;
-// #endif
-//             
-//             Debug.Log($"Created banner anchor at {anchorWorldPosition}");
-//         }
-//
-//         private void CreateBannerWithAnchor()
-//         {
-//             try
-//             {
-//                 // Create banner ad with anchor GameObject
-//                 bannerAd = new BannerAd(placementId, anchor, trackingCamera);
-//                 
-//                 // Subscribe to events
-//                 bannerAd.OnAdLoaded += OnBannerLoaded;
-//                 bannerAd.OnAdFailedToLoad += OnBannerFailed;
-//                 bannerAd.OnAdDisplayed += OnAdDisplayed;
-//                 bannerAd.OnAdHidden += OnAdHidden;
-//                 
-//                 // Load the banner
-//                 bannerAd.Load(adSize);
-//                 
-//                 Debug.Log($"Banner created and loading with anchor: {anchor.name}");
-//             }
-//             catch (System.Exception e)
-//             {
-//                 Debug.LogError($"Failed to create banner: {e.Message}");
-//             }
-//         }
-//
-//         private void OnBannerLoaded(object sender, System.EventArgs args)
-//         {
-//             Debug.Log("Banner loaded successfully");
-//             bannerAd.Show();
-//         }
-//
-//         private void OnBannerFailed(object sender, BlueStackError error)
-//         {
-//             Debug.LogError($"Banner failed to load: {error.Message}");
-//         }
-//
-//         private void OnAdDisplayed(object sender, System.EventArgs args)
-//         {
-//             Debug.Log("Banner displayed");
-//         }
-//
-//         private void OnAdHidden(object sender, System.EventArgs args)
-//         {
-//             Debug.Log("Banner hidden");
-//         }
-//
-//         /// <summary>
-//         /// Example: Move the anchor to a new position
-//         /// </summary>
-//         public void MoveAnchorTo(Vector3 newPosition)
-//         {
-//             if (anchor != null)
-//             {
-//                 anchor.transform.position = newPosition;
-//                 // AdPlacementHandler will automatically update the banner position
-//                 Debug.Log($"Moved anchor to {newPosition}");
-//             }
-//         }
-//
-//         /// <summary>
-//         /// Example: Access the placement handler for advanced control
-//         /// </summary>
-//         public void ForceUpdateBannerPosition()
-//         {
-//             if (bannerAd?.PlacementHandler != null)
-//             {
-//                 bannerAd.PlacementHandler.ForceUpdate();
-//                 Debug.Log("Forced banner position update");
-//             }
-//         }
-//
-//         /// <summary>
-//         /// Example: Check if banner is visible
-//         /// </summary>
-//         public bool IsBannerVisible()
-//         {
-//             return bannerAd?.PlacementHandler?.IsVisible ?? false;
-//         }
-//
-//         private void OnDestroy()
-//         {
-//             // Clean up the banner ad
-//             if (bannerAd != null)
-//             {
-//                 bannerAd.Destroy();
-//                 bannerAd = null;
-//             }
-//             
-//             // Clean up auto-created anchor
-//             if (autoCreateAnchor && anchor != null)
-//             {
-//                 Destroy(anchor);
-//             }
-//         }
-//
-// #if UNITY_EDITOR
-//         private void OnDrawGizmos()
-//         {
-//             // Draw a line from this object to the anchor in editor
-//             if (anchor != null)
-//             {
-//                 Gizmos.color = Color.cyan;
-//                 Gizmos.DrawLine(transform.position, anchor.transform.position);
-//                 Gizmos.DrawWireSphere(anchor.transform.position, 0.3f);
-//             }
-//         }
-// #endif
-//     }
-// }

package/Example/Scripts/AnchoredBannerExample.cs.meta

@@ -1,2 +0,0 @@
-fileFormatVersion: 2
-guid: 6f6bb4665bcd74fbca72ce0f533b7aee

package/Example/Scripts/BannerAnchor.cs

@@ -1,75 +0,0 @@
-using Azerion.BlueStack.API;
-// using Azerion.BlueStack.Utilities;
-using UnityEngine;
-
-namespace Azerion.BlueStack.Example
-{
-    [RequireComponent(typeof(RectTransform))]
-    public class BannerAnchor : MonoBehaviour
-    {
-        [Header("Anchor Configuration")]
-        [SerializeField] private AdSize adSize = AdSize.Banner;
-        
-        [Header("Auto Resize")]
-        [SerializeField] private bool resizeOnStart = true;
-        
-        private RectTransform rectTransform;
-        
-        public AdSize AdSize
-        {
-            get => adSize;
-            set
-            {
-                adSize = value;
-                if (Application.isPlaying)
-                {
-                    ApplyAdSize();
-                }
-            }
-        }
-        
-        private void Awake()
-        {
-            rectTransform = GetComponent<RectTransform>();
-        }
-        
-        private void Start()
-        {
-            if (resizeOnStart && adSize != null)
-            {
-                ApplyAdSize();
-            }
-        }
-        
-        /// <summary>
-        /// Sets the AdSize and immediately applies it to the RectTransform.
-        /// This method can be used when adding the component via AddComponent.
-        /// </summary>
-        /// <param name="newAdSize">The AdSize to apply</param>
-        public void SetAdSize(AdSize newAdSize)
-        {
-            adSize = newAdSize;
-            ApplyAdSize();
-        }
-        
-        /// <summary>
-        /// Applies the current AdSize to the RectTransform.
-        /// Converts dp dimensions to Unity pixels.
-        /// </summary>
-        public void ApplyAdSize()
-        {
-            if (adSize == null)
-            {
-                Debug.LogWarning("BannerAnchor: AdSize is null, cannot resize RectTransform");
-                return;
-            }
-            
-            if (rectTransform == null)
-            {
-                rectTransform = GetComponent<RectTransform>();
-            }
-            
-            // CoordinateConverter.ResizeRectTransformFromDpWxH(adSize, rectTransform);
-        }
-    }
-}

package/Example/Scripts/BannerAnchor.cs.meta

@@ -1,2 +0,0 @@
-fileFormatVersion: 2
-guid: bc8fcf3b2416348d198f12342f98237c