菜单
Builds Linux binaries (x64 and ARM64) for XerahS using the packaging script. Handles Linux packaging, log monitoring, and Avalonia XAML precompilation issues. Use build-common for shared build timeout, lock, and dependency guardrails.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/ShareX/XerahS --skill build-linux-binary命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | build-linux-binary |
| description | Builds Linux binaries (x64 and ARM64) for XerahS using the packaging script. Handles Linux packaging, log monitoring, and Avalonia XAML precompilation issues. Use build-common for shared build timeout, lock, and dependency guardrails. |
| metadata | {"keywords":["build","linux","binary","deb","rpm","release","publish","packaging","file-lock","compilation","arm64","x64","avalonia","xaml"]} |
You are an expert Linux build automation specialist for .NET/Avalonia projects.
Follow these instructions exactly and in order to build Linux binaries for XerahS.
Build Linux packages (deb/rpm) for both x64 and ARM64 architectures. Handle file locking issues that occur when a previous build is still running. Avoid Avalonia XAML precompilation failures caused by namespace mismatches in converters. Validate that the build artifacts exist and are recent. build/linux/package-linux.sh dist/ - XerahS-{version}-linux-x64.deb - XerahS-{version}-linux-arm64.deb - XerahS-{version}-linux-x64.rpm (if rpmbuild is available) - XerahS-{version}-linux-arm64.rpm (if rpmbuild is available)Before Linux packaging work, follow build-common for shared timeout, lock recovery, no-concurrent-build, -m:1, TFM, and SkiaSharp rules. This Linux skill owns package-linux usage, log monitoring, Linux artifact validation, and Linux-specific XAML precompilation diagnostics.
Always pull the latest ShareX.ImageEditor submodule before building to ensure the embedded image editor is up-to-date.
git submodule update --remote --merge ShareX.ImageEditor
CRITICAL: Stale dotnet and package-linux.sh processes are the #1 cause of file lock failures on Linux. Always kill them before starting.
Kill all stale build processes:
pkill -f "package-linux.sh" 2>/dev/null
pkill -f "dotnet publish" 2>/dev/null
pkill -f "dotnet build" 2>/dev/null
sleep 2
Optional — clean obj folders if locks persist:
rm -rf /path/to/XerahS/ShareX.ImageEditor/src/ShareX.ImageEditor/obj/Release
This is most useful if you see The process cannot access the file '...ShareX.ImageEditor.pdb' because it is being used by another process (Avalonia AVLN9999 error).
IMPORTANT: Always redirect output to a log file. The build takes 5-15 minutes and command_status produces no output during that time — the tool will appear to hang. Do NOT use WaitDurationSeconds > 30 with this command.
Start the build with log redirection:
bash build/linux/package-linux.sh > build_output.log 2>&1
This runs in the background. Monitor progress by periodically reading the log with view_file:
view_file: /path/to/XerahS/build_output.log (last 50 lines)
Repeat every ~30 seconds until you see one of:
Done! All packages in dist/ → ✅ Build succeededError: or FAILED lines → ❌ See Phase 3 for fixesDo NOT use WaitDurationSeconds=120 in command_status — the command produces buffered output only after completion, so polling the log file is the only reliable way to track progress.
No precompiled XAML found for XerahS.UI.AppSymptom (at runtime, not build time):
Avalonia.Markup.Xaml.XamlLoadException: No precompiled XAML found for XerahS.UI.App,
make sure to specify x:Class and include your XAML file as AvaloniaResource
Root Cause: A C# converter class referenced in an .axaml file uses the wrong namespace.
Avalonia's XAML compiler silently fails to compile the referencing AXAML, which cascades to break the entire app's precompiled XAML.
How to diagnose:
Check any recently added/modified converters under ShareX.ImageEditor/src/ShareX.ImageEditor/UI/Adapters/Converters/
Verify their C# namespace matches the AXAML xmlns:converters import:
In EditorView.axaml:
xmlns:converters="using:ShareX.ImageEditor.Converters"
So all converter classes must declare:
namespace ShareX.ImageEditor.Converters;
Fix:
// WRONG — will silently break Avalonia XAML precompilation:
namespace ShareX.ImageEditor.UI.Adapters.Converters;
// CORRECT — matches the xmlns:converters import in EditorView.axaml:
namespace ShareX.ImageEditor.Converters;
After fixing, rebuild from scratch.
AVLN9999: The process cannot access the file '...XerahS.Imgur.Plugin.pdb' because it is being used by another processRoot Cause: A previous dotnet publish is still running in the background (e.g. from a backgrounded & command).
Fix:
pkill -f "dotnet publish"
pkill -f "package-linux.sh"
sleep 3
bash build/linux/package-linux.sh
MSB3026: Could not copy '...XerahS.Uploaders.dll' ... being used by another processRoot Cause: Parallel plugin publishing is racing to write shared DLLs.
Fix: This is usually a transient retry (MSBuild will retry automatically). If it becomes fatal:
rm -rf src/desktop/core/XerahS.Uploaders/obj/Release
bash build/linux/package-linux.sh
Error: No plugins were published for linux-x64Root Cause: The plugin csproj discovery glob found no files, or a plugin build failed early.
Check:
find src/desktop/plugins -mindepth 2 -maxdepth 2 -name "*.csproj"
Each plugin project under src/desktop/plugins/ needs a plugin.json in the same directory.
After the build completes, verify the artifacts:
ls -lh dist/
Expected output:
XerahS-0.16.1-linux-x64.deb ~90-120MB
XerahS-0.16.1-linux-arm64.deb ~90-120MB
XerahS-0.16.1-linux-x64.rpm ~90-120MB (if rpmbuild installed)
XerahS-0.16.1-linux-arm64.rpm ~90-120MB (if rpmbuild installed)
Timestamps should match the current build session.
.axaml files to IL at build timenamespace matches the xmlns import in the AXAMLpackage-linux.sh)-p:PublishSingleFile=true --self-contained true: Main app ships as one binary-p:OS=Linux -p:DefineConstants=LINUX: Enables Linux-specific code paths-p:EnableWindowsTargeting=true: Required when cross-compiling on Linux due to shared project references--no-self-contained to share the runtime with the main appNEVER run two builds at the same time. ShareX.ImageEditor targets multiple TFMs and MSBuild parallelism causes them to race on the same ShareX.ImageEditor.dll output path.
package-linux.sh iterates linux-x64 then linux-arm64 sequentially — never invoke it twice concurrently.CS2012 / file lock errors appear on ShareX.ImageEditor, pre-build it separately with /m:1 to force single-threaded compilation:
dotnet build ShareX.ImageEditor/src/ShareX.ImageEditor/ShareX.ImageEditor.csproj \
-c Release -p:UseSharedCompilation=false /m:1
dotnet and package-linux.sh processes and wait for them to exit before starting a new build session.& unless you redirect output to a log fileobj/ folders and will conflictdotnet publish progress may not appear in command_status tool output until the command finishes.log file and use view_file to check progress instead of waiting for command outputlinux-x64 and linux-arm64 .deb packages created in dist/dotnet or package-linux.sh processesXamlLoadException at startup| Symptom | Solution |
|---|---|
XamlLoadException: No precompiled XAML found at startup | Check namespaces of all new converter classes — must match xmlns:converters in .axaml |
AVLN9999: file used by another process | Kill all dotnet publish and package-linux.sh processes, retry |
MSB3026: Could not copy XerahS.Uploaders.dll | Usually transient; if fatal, delete src/desktop/core/XerahS.Uploaders/obj/Release and retry |
Error: No plugins were published | Check src/desktop/plugins/ structure and plugin.json presence in each plugin directory |
| ARM64 cross-compile fails | Ensure linux-arm64 .NET SDK cross-compile support is installed; Fedora needs dotnet-sdk-10.0 |
rpmbuild: command not found | RPM skipped (not fatal); install with sudo dnf install rpm-build if needed |
| Build succeeds but app segfaults | SkiaSharp native library issue; verify the current centrally managed SkiaSharp/native-assets set and published runtimes before changing versions |
ShareX.ImageEditor.Converters (match all new converter classes to this)