fix(mac): reduce AltTester connection flakiness in CI

- Prefer UNITY_APP_PATH when launching the sample app on macOS.
- Retry AltDriver connection with a longer timeout to handle slow startup.

Author: rodrigo-fournier-immutable

sample/Tests/test/test_mac.py

@@ -27,7 +27,20 @@ class MacTest(UnityTest):
     @classmethod
     def setUpClass(cls):
         open_sample_app()
-        cls.altdriver = AltDriver()
+        # macOS runners can take a while to start the AltTester server inside Unity.
+        # Retry connection instead of failing immediately with "Connection refused".
+        last_err = None
+        for attempt in range(12):  # ~60s total
+            try:
+                cls.altdriver = AltDriver(timeout=120)
+                last_err = None
+                break
+            except Exception as e:
+                last_err = e
+                print(f"AltDriver connect attempt {attempt + 1}/12 failed: {e}")
+                time.sleep(5)
+        if last_err is not None:
+            raise SystemExit(f"Failed to connect AltDriver on macOS: {last_err}")
         cls.stop_browser()
 
     @classmethod
@@ -242,7 +255,18 @@ def test_6_relogin(self):
 
         # Restart AltTester
         self.altdriver.stop()
-        self.__class__.altdriver = AltDriver()
+        last_err = None
+        for attempt in range(12):
+            try:
+                self.__class__.altdriver = AltDriver(timeout=120)
+                last_err = None
+                break
+            except Exception as e:
+                last_err = e
+                print(f"AltDriver reconnect attempt {attempt + 1}/12 failed: {e}")
+                time.sleep(5)
+        if last_err is not None:
+            raise SystemExit(f"Failed to reconnect AltDriver on macOS: {last_err}")
         time.sleep(5)
 
         # Wait for unauthenticated screen
@@ -275,7 +299,18 @@ def test_7_reconnect_connect_imx(self):
 
         # Restart AltTester
         self.altdriver.stop()
-        self.__class__.altdriver = AltDriver()
+        last_err = None
+        for attempt in range(12):
+            try:
+                self.__class__.altdriver = AltDriver(timeout=120)
+                last_err = None
+                break
+            except Exception as e:
+                last_err = e
+                print(f"AltDriver reconnect attempt {attempt + 1}/12 failed: {e}")
+                time.sleep(5)
+        if last_err is not None:
+            raise SystemExit(f"Failed to reconnect AltDriver on macOS: {last_err}")
         time.sleep(5)
 
         # Wait for unauthenticated screen

sample/Tests/test/test_mac_helpers.py

@@ -6,19 +6,34 @@ def get_app_name():
     """Get the app name from environment variable, falling back to default"""
     return os.getenv("UNITY_APP_NAME", "SampleApp")
 
+def get_app_path():
+    """
+    Prefer the explicit app bundle path from CI (UNITY_APP_PATH).
+    Fallback to "<UNITY_APP_NAME>.app".
+    """
+    app_path = os.getenv("UNITY_APP_PATH")
+    if app_path:
+        return app_path
+    return f"{get_app_name()}.app"
+
 def open_sample_app():
     app_name = get_app_name()
     print(f"Opening Unity sample app ({app_name})...")
-    subprocess.Popen(["open", f"{app_name}.app"], shell=False)
-    time.sleep(5)
+    app_path = get_app_path()
+    print(f"Using app path: {app_path}")
+    if not os.path.exists(app_path):
+        raise SystemExit(f"Unity app bundle not found at path: {app_path}")
+    subprocess.Popen(["open", app_path], shell=False)
+    # macOS runners are slow to launch + start AltTester server
+    time.sleep(10)
     print(f"Unity sample app ({app_name}) opened successfully.")
 
 def stop_sample_app():
     app_name = get_app_name()
     print(f"Stopping sample app ({app_name})...")
 
     bash_script = f"""
-    app_path="{app_name}.app"
+    app_path="{get_app_path()}"
     echo "Closing sample app..."
     PID=$(ps aux | grep "$app_path" | grep -v grep | awk '{{print $2}}')
     if [ -n "$PID" ]; then