Skip to content

feat: Support Linux ARM64 #2470

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
bitsandfoxes wants to merge 15 commits into
base: main
Choose a base branch
from
Draft

feat: Support Linux ARM64 #2470

Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
7925c53
Build sentry-native for Linux ARM
bitsandfoxes Jan 8, 2026
1b0934c
Fix sysroot path
bitsandfoxes Jan 8, 2026
3ad2944
Missing cross-compilation tools
bitsandfoxes Jan 8, 2026
74694fb
Build on an actual arm runner
bitsandfoxes Jan 8, 2026
b6430b1
Simplified building for Linux
bitsandfoxes Jan 8, 2026
b1203df
Fix mv
bitsandfoxes Jan 8, 2026
51a407e
Powershell ftw
bitsandfoxes Jan 8, 2026
408477f
Fixed path
bitsandfoxes Jan 8, 2026
57b7944
Fixed developwer download
bitsandfoxes Jan 8, 2026
e49457c
Missed some paths
bitsandfoxes Jan 8, 2026
3e564bb
Still paths and downloads..
bitsandfoxes Jan 8, 2026
80af7ed
meta files
bitsandfoxes Jan 8, 2026
ea80b2a
Updated .meta to exclude themselves from building
bitsandfoxes Jan 9, 2026
989c7b6
Updated CHANGELOG.md
bitsandfoxes Jan 9, 2026
0d73dab
Merge branch 'main' into feat/linux-arm
bitsandfoxes Jan 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .github/workflows/sdk.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -74,6 +74,9 @@ jobs:
run: |
sudo apt-get update
sudo apt-get install -y zlib1g-dev libcurl4-openssl-dev libssl-dev build-essential cmake curl
# ARM64 cross-compilation toolchain and libraries
sudo apt-get install -y gcc-aarch64-linux-gnu g++-aarch64-linux-gnu binutils-aarch64-linux-gnu
sudo apt-get install -y libc6-dev-arm64-cross libc6-arm64-cross
set -eo pipefail
curl -sSL --retry 5 https://dot.net/v1/dotnet-install.sh | bash /dev/stdin --channel 9.0 --install-dir /usr/share/dotnet
echo "/usr/share/dotnet" >> $GITHUB_PATH
Expand Down
49 changes: 41 additions & 8 deletions Directory.Build.targets
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,8 @@
<!-- Native -->
<SentryNativeRoot>$(RepoRoot)modules/sentry-native/</SentryNativeRoot>
<SentryLinuxArtifactsDestination>$(SentryArtifactsDestination)Linux/Sentry/</SentryLinuxArtifactsDestination>
<SentryLinuxX64ArtifactsDestination>$(SentryArtifactsDestination)Linux/Sentry/x86_64/</SentryLinuxX64ArtifactsDestination>
<SentryLinuxArm64ArtifactsDestination>$(SentryArtifactsDestination)Linux/Sentry/arm64/</SentryLinuxArm64ArtifactsDestination>
<SentryWindowsArtifactsDestination>$(SentryArtifactsDestination)Windows/Sentry/</SentryWindowsArtifactsDestination>
</PropertyGroup>

Expand Down Expand Up @@ -174,8 +176,11 @@ Expected to exist:

<Target Name="CleanLinuxSDK" AfterTargets="Clean" Condition="'$(MSBuildProjectName)' == 'Sentry.Unity'">
<RemoveDir Directories="$(SentryNativeRoot)build/" ContinueOnError="true" />
<Delete Files="$(SentryLinuxArtifactsDestination)libsentry.so" ContinueOnError="true" />
<Delete Files="$(SentryLinuxArtifactsDestination)libsentry.dbg.so" ContinueOnError="true" />
<RemoveDir Directories="$(SentryNativeRoot)build-arm64/" ContinueOnError="true" />
<Delete Files="$(SentryLinuxX64ArtifactsDestination)libsentry.so" ContinueOnError="true" />
<Delete Files="$(SentryLinuxX64ArtifactsDestination)libsentry.dbg.so" ContinueOnError="true" />
<Delete Files="$(SentryLinuxArm64ArtifactsDestination)libsentry.so" ContinueOnError="true" />
<Delete Files="$(SentryLinuxArm64ArtifactsDestination)libsentry.dbg.so" ContinueOnError="true" />
Comment thread
bitsandfoxes marked this conversation as resolved.
Outdated
</Target>

<Target Name="CleanWindowsSDK" AfterTargets="Clean" Condition="'$(MSBuildProjectName)' == 'Sentry.Unity'">
Expand Down Expand Up @@ -297,20 +302,48 @@ Expected to exist:
<!-- Build the Sentry Native SDK for Linux: dotnet msbuild /t:BuildLinuxSDK src/Sentry.Unity -->
<Target Name="BuildLinuxSDK" Condition="'$(MSBuildProjectName)' == 'Sentry.Unity'
And $([MSBuild]::IsOsPlatform('Linux'))
And !Exists('$(SentryLinuxArtifactsDestination)libsentry.so')" BeforeTargets="BeforeBuild">
And !Exists('$(SentryLinuxX64ArtifactsDestination)libsentry.so')" BeforeTargets="BeforeBuild">
Comment thread
cursor[bot] marked this conversation as resolved.
Outdated
<Error Condition="!Exists('$(SentryNativeRoot)')" Text="Couldn't find the Native root at $(SentryNativeRoot)."></Error>

<Message Importance="High" Text="Building artifacts of Sentry Native SDK for Linux." />
<!-- ===== x86_64 Build ===== -->
<Message Importance="High" Text="Building Sentry Native SDK for Linux x86_64." />

<Exec WorkingDirectory="$(SentryNativeRoot)" Command="cmake -B build -D SENTRY_BACKEND=breakpad -D SENTRY_SDK_NAME=sentry.native.unity -D CMAKE_BUILD_TYPE=RelWithDebInfo -S ." />
<Exec WorkingDirectory="$(SentryNativeRoot)" Command="cmake --build build --target sentry --parallel" />

<MakeDir Directories="$(SentryLinuxArtifactsDestination)"/>
<MakeDir Directories="$(SentryLinuxX64ArtifactsDestination)"/>

<!-- strip all, including exported symbols except those starting with 'sentry_', except for 'sentry__' -->
<Exec WorkingDirectory="$(SentryNativeRoot)" Command="strip -s build/libsentry.so -w -K sentry_[^_]* -o $(SentryLinuxArtifactsDestination)libsentry.so" />
<Copy SourceFiles="$(SentryNativeRoot)build/libsentry.so" DestinationFiles="$(SentryLinuxArtifactsDestination)libsentry.dbg.so" />
<Exec WorkingDirectory="$(SentryLinuxArtifactsDestination)" Command="objcopy --add-gnu-debuglink=libsentry.dbg.so libsentry.so" />
<Exec WorkingDirectory="$(SentryNativeRoot)" Command="strip -s build/libsentry.so -w -K sentry_[^_]* -o $(SentryLinuxX64ArtifactsDestination)libsentry.so" />
<Copy SourceFiles="$(SentryNativeRoot)build/libsentry.so" DestinationFiles="$(SentryLinuxX64ArtifactsDestination)libsentry.dbg.so" />
<Exec WorkingDirectory="$(SentryLinuxX64ArtifactsDestination)" Command="objcopy --add-gnu-debuglink=libsentry.dbg.so libsentry.so" />

<!-- ===== ARM64 Build (cross-compilation) ===== -->
<!-- Check for cross-compiler availability -->
<Exec Command="which aarch64-linux-gnu-gcc" IgnoreExitCode="true" ConsoleToMSBuild="true">
<Output TaskParameter="ExitCode" PropertyName="Arm64ToolchainCheckExitCode"/>
</Exec>

<Message Condition="'$(Arm64ToolchainCheckExitCode)' != '0'" Importance="High"
Text="Skipping Linux ARM64 build: aarch64-linux-gnu-gcc not found." />

<Message Condition="'$(Arm64ToolchainCheckExitCode)' == '0'" Importance="High"
Text="Building Sentry Native SDK for Linux ARM64." />

<Exec Condition="'$(Arm64ToolchainCheckExitCode)' == '0'" WorkingDirectory="$(SentryNativeRoot)"
Command="cmake -B build-arm64 -D SENTRY_BACKEND=breakpad -D SENTRY_SDK_NAME=sentry.native.unity -D CMAKE_BUILD_TYPE=RelWithDebInfo -D CMAKE_SYSTEM_NAME=Linux -D CMAKE_SYSTEM_PROCESSOR=aarch64 -D CMAKE_C_COMPILER=aarch64-linux-gnu-gcc -D CMAKE_CXX_COMPILER=aarch64-linux-gnu-g++ -S ." />
<Exec Condition="'$(Arm64ToolchainCheckExitCode)' == '0'" WorkingDirectory="$(SentryNativeRoot)"
Command="cmake --build build-arm64 --target sentry --parallel" />

<MakeDir Condition="'$(Arm64ToolchainCheckExitCode)' == '0'" Directories="$(SentryLinuxArm64ArtifactsDestination)"/>

<Exec Condition="'$(Arm64ToolchainCheckExitCode)' == '0'" WorkingDirectory="$(SentryNativeRoot)"
Command="aarch64-linux-gnu-strip -s build-arm64/libsentry.so -w -K sentry_[^_]* -o $(SentryLinuxArm64ArtifactsDestination)libsentry.so" />
<Copy Condition="'$(Arm64ToolchainCheckExitCode)' == '0'"
SourceFiles="$(SentryNativeRoot)build-arm64/libsentry.so"
DestinationFiles="$(SentryLinuxArm64ArtifactsDestination)libsentry.dbg.so" />
<Exec Condition="'$(Arm64ToolchainCheckExitCode)' == '0'" WorkingDirectory="$(SentryLinuxArm64ArtifactsDestination)"
Command="aarch64-linux-gnu-objcopy --add-gnu-debuglink=libsentry.dbg.so libsentry.so" />
</Target>

<!-- Even with a successful build, Unity will error on 'usbmuxd' or log out to std-error which breaks msbuild.
Expand Down
12 changes: 9 additions & 3 deletions src/Sentry.Unity.Editor/Native/BuildPostProcess.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -173,10 +173,16 @@ private static void UploadDebugSymbols(IDiagnosticLogger logger, BuildTarget tar
}
break;
case BuildTarget.StandaloneLinux64:
var linuxSentryDbg = Path.GetFullPath($"Packages/{SentryPackageInfo.GetName()}/Plugins/Linux/Sentry/libsentry.dbg.so");
if (File.Exists(linuxSentryDbg))
// Add debug symbols for both x86_64 and ARM64 - sentry-cli will match by debug ID
var linuxSentryDbgX64 = Path.GetFullPath($"Packages/{SentryPackageInfo.GetName()}/Plugins/Linux/Sentry/x86_64/libsentry.dbg.so");
if (File.Exists(linuxSentryDbgX64))
{
paths += $" \"{linuxSentryDbg}\"";
paths += $" \"{linuxSentryDbgX64}\"";
}
var linuxSentryDbgArm64 = Path.GetFullPath($"Packages/{SentryPackageInfo.GetName()}/Plugins/Linux/Sentry/arm64/libsentry.dbg.so");
Comment thread
bitsandfoxes marked this conversation as resolved.
if (File.Exists(linuxSentryDbgArm64))
{
paths += $" \"{linuxSentryDbgArm64}\"";
Comment thread
bitsandfoxes marked this conversation as resolved.
}
break;
case BuildTarget.StandaloneOSX:
Expand Down
Loading