Update to support ARM64 build target by jamescharters · Pull Request #5246 · cefsharp/CefSharp

jamescharters · 2026-05-19T01:35:23Z

Fixes: [issue-number]

Summary: [summary of the change and which issue is fixed here]

This change introduces full ARM64 support for CefSharp, covering native C++/CLI projects, managed .NET Framework projects, NuGet packaging, and the build pipeline. It enables CefSharp to be built and distributed for Windows ARM64 devices natively.

Changes: [specify the structures changed]

Added ArchitectureHelper.cs — new helper class that resolves the current process architecture (x86/x64/arm64) for both .NET Framework and .NET Core
Modified CefRuntime.cs — replaced Environment.Is64BitProcess checks with ArchitectureHelper.ProcessArchitecture so ARM64 processes resolve the correct arch-specific assembly path
Modified DependencyChecker.cs — skips d3dcompiler_47.dll in optional dependency checks when running on ARM64 (not available on that platform)
Modified CefSharp.Core.Runtime.vcxproj and CefSharp.BrowserSubprocess.Core.vcxproj — added Debug|arm64 and Release|arm64 project configurations
Modified CefSharp.BrowserSubprocess.csproj — added arm64 platform/runtime identifier and updated the post-build editbin/sn script to select the correct vcvarsall arch for x86, x64, and arm64 (including cross-compile from AMD64 host)
Modified CefSharp3.sln — registered Debug|arm64 and Release|arm64 solution-level configurations for all projects
Modified CefSharp.Native.props — added arm64 locale content item group
Modified example and test projects (OffScreen, WinForms, WPF, HwndHost, Test) — added arm64 to , , and conditional / properties
Modified CefSharp.Common.nuspec — added chromiumembeddedframework.runtime.win-arm64 dependency and arm64 binary entries
Modified CefSharp.Common.props — added CefSharpCommonBinariesArm64 and CefSharpBrowserProcessCoreArm64 item groups
Modified CefSharp.Common.targets — added arm64 / item groups and CefSharpCopyFilesAfterNugetRestoreArm64 copy target
Modified build.ps1 — refactored BuildSolution to invoke msbuild.exe directly; added Get-HostArchitecture, Get-VCVarsAllArch, and Ensure-BuildEnvironment helpers to correctly bootstrap the VC environment per target arch (native or cross-compile); removed the blanket arm64 exclusion for NetFramework builds and replaced it with a guard that requires VS2022/v143 when targeting arm64

How Has This Been Tested?

Built the solution targeting ARM64 using build.ps1 with -BuildArches arm64 -Target vs2022 on an AMD64 host (cross-compile). Verified arm64 binaries are produced in bin\arm64\Release for both CefSharp.Core.Runtime and CefSharp.BrowserSubprocess.

Screenshots (if appropriate):

Types of changes

Bug fix (non-breaking change which fixes an issue)
New feature (non-breaking change which adds functionality)
Breaking change (fix or feature that would cause existing functionality to change)
Updated documentation

Checklist:

Tested the code(if applicable)
Commented my code
Changed the documentation(if applicable)
New files have a license disclaimer
The formatting is consistent with the project (project supports .editorconfig)

coderabbitai · 2026-05-19T01:35:31Z

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: ec976e4e-5fa0-4632-8e90-218737c1a632

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

AppVeyorBot · 2026-05-19T01:50:09Z

❌ Build CefSharp 147.0.100-CI5487 failed (commit 14883d302f by @jamescharters)

AppVeyorBot · 2026-05-19T05:31:31Z

❌ Build CefSharp 147.0.100-CI5488 failed (commit da5271272b by @)

jamescharters · 2026-06-02T01:32:22Z

@amaitland Hi Alex, this is currently a draft of changes to get this building for ARM64. My team has compiled this locally and is using it on real ARM64 hardware (M4 Macs) without issue. Was wanting to know how to move forward with this, as it looks like the CI/CD environment does not support this architecture.

AppVeyorBot · 2026-06-02T01:41:45Z

❌ Build CefSharp 148.0.90-CI5510 failed (commit fd4a1df55e by @jamescharters)

amaitland

See comments inline

amaitland · 2026-05-27T09:22:58Z

-    $StartInfo = New-Object System.Diagnostics.ProcessStartInfo
-    $StartInfo.FileName = "msbuild.exe"
-    $StartInfo.Arguments = $Arguments


Is this strictly necessary? From memory there was a specific reason the EnvironmentVariables were cleared (I don't remember the specifics, it's been years since this was done).

Please revert any unnecessary changes to this file. Keeping it to the bare minimum change will also make it easy to review.

amaitland · 2026-06-12T21:20:22Z

+        private static IEnumerable<string> GetOptionalDependencies()
+        {
+            foreach (var dependency in CefOptionalDependencies)
+            {
+                if (ArchitectureHelper.IsArm64Process && string.Equals(dependency, "d3dcompiler_47.dll", StringComparison.OrdinalIgnoreCase))
+                {
+                    continue;
+                }
+
+                yield return dependency;
+            }
+        }


Chromium started shipping the d33compiler some time back.

#4515

unless they've stopped shipping the dll this can be reverted.

amaitland · 2026-06-12T21:22:56Z

+                case "Arm64":
+                case "arm64":


Could we not just turn the string to lowercase?

relying on hard coded case comparison seems less than ideal.

If we do need a comparison then using if statements with string comparison to ignore case I think makes more sense then multiple case statements.

amaitland · 2026-06-12T22:10:38Z

  </ItemGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.SourceLink.GitHub" Version="1.0.0" />
+    <PackageReference Include="System.Runtime.InteropServices.RuntimeInformation" Version="4.3.0" />


If we need this then it will need to be added to the nuspec file.

amaitland · 2026-06-12T22:12:21Z

Was wanting to know how to move forward with this

Until it builds there really isn't much I can do. You'd need to build locally in the mean time.

As per my comment inline try reverting your changes to the build script to see if that helps.

Update to support ARM64 build target

4742db6

Merge branch 'master' into ter-805-arm64-target

f5ef76a

Simplify code in ArchitectureHelper

ffc1eba

Merge branch 'master' into ter-805-arm64-target

8dd60a3

amaitland requested changes Jun 12, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Update to support ARM64 build target#5246

Update to support ARM64 build target#5246
jamescharters wants to merge 4 commits into
cefsharp:masterfrom
jamescharters:ter-805-arm64-target

jamescharters commented May 19, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented May 19, 2026 •

edited

Loading

Review skipped

Uh oh!

AppVeyorBot commented May 19, 2026

Uh oh!

AppVeyorBot commented May 19, 2026

Uh oh!

jamescharters commented Jun 2, 2026

Uh oh!

AppVeyorBot commented Jun 2, 2026

Uh oh!

amaitland left a comment

Uh oh!

amaitland May 27, 2026

Uh oh!

amaitland Jun 12, 2026

Uh oh!

amaitland Jun 12, 2026

Uh oh!

amaitland Jun 12, 2026

Uh oh!

amaitland commented Jun 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

jamescharters commented May 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot commented May 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Uh oh!

AppVeyorBot commented May 19, 2026

Uh oh!

AppVeyorBot commented May 19, 2026

Uh oh!

jamescharters commented Jun 2, 2026

Uh oh!

AppVeyorBot commented Jun 2, 2026

Uh oh!

amaitland left a comment

Choose a reason for hiding this comment

Uh oh!

amaitland May 27, 2026

Choose a reason for hiding this comment

Uh oh!

amaitland Jun 12, 2026

Choose a reason for hiding this comment

Uh oh!

amaitland Jun 12, 2026

Choose a reason for hiding this comment

Uh oh!

amaitland Jun 12, 2026

Choose a reason for hiding this comment

Uh oh!

amaitland commented Jun 12, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

jamescharters commented May 19, 2026 •

edited

Loading

coderabbitai Bot commented May 19, 2026 •

edited

Loading