Test ARM64 ODBC driver natively using Firebird snapshot-master

PSFirebird v1.2.0 adds snapshot support. Firebird snapshot-master publishes
win-arm64 binaries, enabling native ARM64 builds and tests.

- windows-11-arm: build ARM64 natively (no -A flag), test against
  Firebird snapshot-master win-arm64 binary (real ARM64 fbclient.dll)
- Remove win-x64 emulation workaround on ARM64 Windows hosts
- windows-latest ARM64 build-only job retained for release artifact
- Require PSFirebird >= 1.2.0 (snapshot branch support)
- build-test-databases: supports -Branch for snapshot Firebird

Author: fdcastel

.github/workflows/build-and-test.yml

@@ -29,10 +29,9 @@ jobs:
             artifact-name: windows-arm64-binaries
             arch: ARM64
             build-only: true
-          # Windows ARM64 tests: build as x64 and test via emulation
-          # because Firebird has no ARM64 Windows binaries yet.
+          # Windows ARM64 native: build + test using Firebird snapshot-master (win-arm64).
+          # Firebird does not publish official ARM64 Windows releases; snapshots do.
           - os: windows-11-arm
-            arch: x64
           - os: ubuntu-22.04
             artifact-name: linux-x64-binaries
           - os: ubuntu-22.04-arm

firebird-odbc-driver.build.ps1

@@ -42,20 +42,20 @@ if ($IsWindowsOS) {
 	$DriverPath = Join-Path $BuildDir $DriverFileName
 }
 
-# Map build Architecture to PSFirebird RuntimeIdentifier (RID).
+# Map build Architecture to PSFirebird RuntimeIdentifier (RID) and optional branch.
 # Used by build-test-databases to download the correct Firebird binaries.
-# ARM64 falls back to win-x64 because Firebird has no ARM64 Windows builds.
 $FirebirdRid = switch ($Architecture) {
 	'Win32' { 'win-x86' }
-	'ARM64' { 'win-x64' }
 	default { '' }
 }
+$FirebirdBranch = ''
 
-# On ARM64 Windows hosts building for x64 (emulation), explicitly request
-# win-x64 Firebird since PSFirebird would otherwise auto-detect win-arm64.
-if (-not $FirebirdRid -and $IsWindowsOS -and
+# On native ARM64 Windows (no Architecture override = native ARM64 build),
+# use the Firebird snapshot-master branch which publishes win-arm64 binaries.
+if (-not $Architecture -and $IsWindowsOS -and
 	[System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture -eq 'Arm64') {
-	$FirebirdRid = 'win-x64'
+	$FirebirdRid = 'win-arm64'
+	$FirebirdBranch = 'master'
 }
 
 # Synopsis: Remove the build directory.
@@ -85,7 +85,8 @@ task build {
 # Synopsis: Create Firebird test databases.
 task build-test-databases {
 	$fbVersion = '5.0.2'
-	$envPath = '/fbodbc-tests/fb502'
+	# Use a distinct env path for snapshot (branch) builds to avoid stale cache.
+	$envPath = if ($FirebirdBranch) { "/fbodbc-tests/snapshot-$FirebirdBranch" } else { '/fbodbc-tests/fb502' }
 	$dbPathUtf8 = '/fbodbc-tests/TEST.FB50.FDB'
 	$dbPathIso = '/fbodbc-tests/TEST-ISO.FB50.FDB'
 
@@ -104,12 +105,18 @@ task build-test-databases {
 		$fbExtraParams['RuntimeIdentifier'] = $FirebirdRid
 		print Cyan "Using Firebird RID: $FirebirdRid"
 	}
+	if ($FirebirdBranch) {
+		$fbExtraParams['Branch'] = $FirebirdBranch
+		print Cyan "Using Firebird snapshot branch: $FirebirdBranch"
+	} else {
+		$fbExtraParams['Version'] = $fbVersion
+	}
 
 	if (Test-Path (Join-Path $envPath 'firebird.msg')) {
 		$fb = Get-FirebirdEnvironment -Path $envPath
 		print Green "Reusing existing Firebird environment: $envPath"
 	} else {
-		$fb = New-FirebirdEnvironment -Version $fbVersion -Path $envPath -Force @fbExtraParams
+		$fb = New-FirebirdEnvironment -Path $envPath -Force @fbExtraParams
 		print Green "Firebird environment created: $envPath"
 	}
 

install-prerequisites.ps1

@@ -21,5 +21,5 @@ if ($IsLinux) {
     Register-PackageSource -Name 'NuGet' -Location 'https://api.nuget.org/v3/index.json' -ProviderName NuGet -Force
 }
 
-Install-Module -Name PSFirebird -MinimumVersion 1.1.0 -Force -AllowClobber -Scope CurrentUser -Repository PSGallery
+Install-Module -Name PSFirebird -MinimumVersion 1.2.0 -Force -AllowClobber -Scope CurrentUser -Repository PSGallery
 Install-Module -Name InvokeBuild -Force -Scope CurrentUser