3.1.0: arm64 + proxy passthrough for binary download

- GetBinaryName made public and adds Linux arm64 branch via
  RuntimeInformation.OSArchitecture. arm64 wins over alpine to match
  the Node SDK ordering.
- BrowserStackTunnel.SetProxy(host, port) + proxyHost/proxyPort fields.
- fetchSourceUrl builds HttpClientHandler with Proxy = WebProxy(host, port)
  when proxy is set.
- downloadBinary sets WebClient.Proxy = WebProxy(host, port) when set.
  (Keeping WebClient; proxy plumbing on it is one line.)
- Local.addArgs captures proxyHost/proxyPort on local fields in addition
  to appending to argumentString. Local.start calls tunnel.SetProxy(...)
  before DownloadVerifyAndRunBinary.
- Test fixtures derive binaryName from BrowserStackTunnel.GetBinaryName()
  so arm64 CI hosts pick the right binary.

Tracks LOC-6563.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: yashdsaraf

BrowserStackLocal/BrowserStackLocal Unit Tests/BrowserStackTunnelTests.cs

@@ -17,7 +17,7 @@ public class BrowserStackTunnelTests
     static readonly string homepath = os.Platform.ToString() == "Unix" ?
                                         Environment.GetFolderPath(Environment.SpecialFolder.Personal) :
                                         Environment.ExpandEnvironmentVariables("%HOMEDRIVE%%HOMEPATH%");
-    static readonly string binaryName = os.Platform.ToString() == "Unix" ? "BrowserStackLocal-darwin-x64" : "BrowserStackLocal.exe";
+    static readonly string binaryName = BrowserStackTunnel.GetBinaryName();
     private TunnelClass tunnel;
     [TestMethod]
     public void TestInitialState()

BrowserStackLocal/BrowserStackLocal/BrowserStackLocal.csproj

@@ -7,9 +7,9 @@
     <Title>BrowserStackLocal</Title>
     <Product>BrowserStackLocal</Product>
     <Description>C# Bindings for BrowserStack Local</Description>
-    <Version>3.0.0</Version>
-    <AssemblyVersion>3.0.0</AssemblyVersion>
-    <FileVersion>3.0.0</FileVersion>
+    <Version>3.1.0</Version>
+    <AssemblyVersion>3.1.0</AssemblyVersion>
+    <FileVersion>3.1.0</FileVersion>
     <Authors>BrowserStack</Authors>
     <Company>BrowserStack</Company>
     <Copyright>Copyright ©  2016</Copyright>

BrowserStackLocal/BrowserStackLocal/BrowserStackTunnel.cs

@@ -12,6 +12,7 @@
 using System.Collections.Generic;
 using System.Net.Http;
 using System.Threading.Tasks;
+using System.Runtime.InteropServices;
 using Newtonsoft.Json;
 
 namespace BrowserStack
@@ -27,6 +28,8 @@ public class BrowserStackTunnel : IDisposable
     private string sourceUrl = null;
     private bool isFallbackEnabled = false;
     private Exception downloadFailureException = null;
+    private string proxyHost = null;
+    private int proxyPort = 0;
 
     static readonly string homepath = !IsWindows() ?
                                         Environment.GetFolderPath(Environment.SpecialFolder.Personal) :
@@ -77,13 +80,14 @@ static bool IsAlpine()
       return false;
     }
 
-    static string GetBinaryName()
+    public static string GetBinaryName()
     {
       if (IsWindows()) return "BrowserStackLocal.exe";
       if (IsDarwin(uname)) return "BrowserStackLocal-darwin-x64";
 
       if (IsLinux(uname))
       {
+          if (IsArm64()) return "BrowserStackLocal-linux-arm64";
           if (Util.Is64BitOS())
           {
             return IsAlpine() ? "BrowserStackLocal-alpine" : "BrowserStackLocal-linux-x64";
@@ -94,6 +98,17 @@ static string GetBinaryName()
       return "BrowserStackLocal.exe";
     }
 
+    static bool IsArm64()
+    {
+      return RuntimeInformation.OSArchitecture == Architecture.Arm64;
+    }
+
+    public virtual void SetProxy(string host, int port)
+    {
+      proxyHost = host;
+      proxyPort = port;
+    }
+
     public virtual void addBinaryPath(string binaryAbsolute, string accessKey, bool fallbackEnabled = false, Exception failureException = null)
     {
       if (basePathsIndex == -1)
@@ -169,7 +184,14 @@ private string fetchSourceUrl(string accessKey)
     {
       var url = "https://local.browserstack.com/binary/api/v1/endpoint";
 
-      using (var client = new HttpClient())
+      HttpClientHandler handler = new HttpClientHandler();
+      if (!string.IsNullOrEmpty(proxyHost) && proxyPort > 0)
+      {
+        handler.Proxy = new WebProxy(proxyHost, proxyPort);
+        handler.UseProxy = true;
+      }
+
+      using (var client = new HttpClient(handler))
       {
         var data = new Dictionary<string, object>
         {
@@ -216,6 +238,10 @@ public void downloadBinary()
 
       using (var client = new WebClient())
       {
+        if (!string.IsNullOrEmpty(proxyHost) && proxyPort > 0)
+        {
+          client.Proxy = new WebProxy(proxyHost, proxyPort);
+        }
         client.DownloadFile(sourceUrl + "/" + binaryName, this.binaryAbsolute);
       }
 

BrowserStackLocal/BrowserStackLocal/Local.cs

@@ -17,6 +17,8 @@ public class Local
     private string userAgent = "browserstack-local-csharp";
     private bool isFallbackEnabled = false;
     private Exception downloadFailureException = null;
+    private string proxyHost = null;
+    private int proxyPort = 0;
 
     protected BrowserStackTunnel tunnel = null;
     private static KeyValuePair<string, string> emptyStringPair = new KeyValuePair<string, string>();
@@ -75,6 +77,15 @@ private void addArgs(string key, string value)
       }
     else
       {
+        if (key.Equals("proxyHost"))
+        {
+          proxyHost = value;
+        }
+        else if (key.Equals("proxyPort"))
+        {
+          int.TryParse(value, out proxyPort);
+        }
+
         result = valueCommands.Find(pair => pair.Key == key);
         if (!result.Equals(emptyStringPair))
         {
@@ -226,6 +237,7 @@ public void start(List<KeyValuePair<string, string>> options)
       argumentString += "-logFile \"" + customLogPath + "\" ";
       argumentString += "--source \"c-sharp:" + bindingVersion + "\" ";
       tunnel.addBinaryArguments(argumentString);
+      tunnel.SetProxy(proxyHost, proxyPort);
 
       DownloadVerifyAndRunBinary();
     }

BrowserStackLocal/BrowserStackLocalIntegrationTests/IntegrationTests.cs

@@ -12,7 +12,7 @@ namespace BrowserStackLocalIntegrationTests
   public class IntegrationTests
   {
     static readonly OperatingSystem os = Environment.OSVersion;
-    static readonly string binaryName = os.Platform.ToString() == "Unix" ? "BrowserStackLocal-darwin-x64" : "BrowserStackLocal";
+    static readonly string binaryName = BrowserStackTunnel.GetBinaryName().Replace(".exe", "");
     private static string username = Environment.GetEnvironmentVariable("BROWSERSTACK_USERNAME");
     private static string accesskey = Environment.GetEnvironmentVariable("BROWSERSTACK_ACCESS_KEY");