mirror of
https://github.com/citron-neo/PR.git
synced 2026-07-05 15:22:02 -07:00
12a7a81a8f
build-linux.yml: - Replace per-workflow build/package shell scripts (build-citron.sh, get-dependencies.sh, package-citron.sh) with a unified call to build-citron-linux.sh from the emulator repo, which handles dependency setup, CPM build, and AppImage/tar.zst packaging in one script - Remove Arch Linux container (ghcr.io/pkgforge-dev/archlinux:latest) from the linux build job; the job now runs directly on the Ubuntu GitHub-hosted runner, eliminating the nested container layer - Remove the 'Install Git' step (pacman -Syu git) that was only needed inside the Arch container - Remove the 'Install Packaging Dependencies' step (pacman gamemode) that was only needed inside the Arch container; gamemode handling is now delegated to build-citron-linux.sh Deleted files: - build-citron.sh: Arch-based build script replaced by build-citron-linux.sh - get-dependencies.sh: Arch pacman dependency installer, superseded - package-citron.sh: Arch-based AppImage/tar.zst packager, superseded - PKGBUILD: unused Arch Linux package build descriptor README.md: - Rewrite to reflect this repo's purpose as a PR test-artifact builder, not a nightly/stable release repo; redirect users to citron-neo/CI for releases - Describe the per-platform workflow_dispatch model: takes branch, PR number, and head repo as inputs; posts/updates a results comment on the PR with per-platform status and nightly.link download links - Document build-deduplication: skips re-building a commit already successfully built for that platform - Update title and badge references from 'Citron' to 'Citron Neo' - Mention tar.zst portable archive produced alongside the AppImage - Update AppImage section with uruntime fuse3/no-fuse compatibility notes - Replace bullet lists with dash lists; remove star history block, raison d'etre image, and Pkgforge attribution section
54 lines
3.5 KiB
Markdown
54 lines
3.5 KiB
Markdown
# 🍋 Citron Neo PR Builds
|
|
|
|
[](https://github.com/citron-neo/CI/actions/workflows/build-android.yml) [](https://github.com/citron-neo/CI/actions/workflows/build-windows.yml) [](https://github.com/citron-neo/CI/actions/workflows/build-linux.yml) [](https://github.com/citron-neo/CI/actions/workflows/build-macos.yml)
|
|
|
|
---
|
|
|
|
This repository builds **on-demand test artifacts for open pull requests** against the Citron Neo emulator — it does **not** produce the project's Nightly or Stable releases. For those, see [citron-neo/CI](https://github.com/citron-neo/CI).
|
|
|
|
Each platform workflow (Windows, Linux, Android, macOS) is triggered manually via `workflow_dispatch`, taking a target branch, a PR number, and a head repo as input. This lets a reviewer or contributor build a specific PR's branch — from any fork — without waiting for it to merge.
|
|
|
|
Once a build is requested, this repository:
|
|
|
|
- Builds the requested commit for the chosen platform.
|
|
- Posts (or updates) a single results comment on the corresponding pull request in [citron-neo/emulator](https://github.com/citron-neo/emulator), with a table tracking each platform's status (`Pending` → `Building...` → `Success`/`Failed`) and a direct download link to the artifact, powered by [nightly.link](https://nightly.link).
|
|
- Skips rebuilding a commit that's already been built successfully for that platform, to avoid duplicate work on repeated dispatches.
|
|
|
|
Would you like to submit a compatibility report for the emulator? You can do so here:
|
|
|
|
- [Submit Compatibility Report](https://github.com/citron-neo/Citron-Compatability)
|
|
|
|
---
|
|
|
|
Direct links for other information you may need can also be found below:
|
|
|
|
- [Latest Commits Can Be Found Here](https://github.com/citron-neo/emulator/commits/main)
|
|
- [citron-neo/CI — Nightly & Stable Releases](https://github.com/citron-neo/CI)
|
|
- [citron-neo/emulator — Open Pull Requests](https://github.com/citron-neo/emulator/pulls)
|
|
|
|
---
|
|
|
|
# READ THIS IF YOU HAVE ISSUES
|
|
|
|
If you are on wayland (specially GNOME wayland) and get freezes or crashes, you are likely affected by this issue that affects all Qt6 apps: [citron-neo/CI#50](https://github.com/citron-neo/CI/pull/50)
|
|
|
|
To fix it simply set the env variable `QT_QPA_PLATFORM=xcb`
|
|
|
|
**Also, are you looking for AppImages of other emulators? Check:** [AnyLinux-AppImages](https://pkgforge-dev.github.io/Anylinux-AppImages/)
|
|
|
|
---
|
|
|
|
Linux AppImage builds are made using [sharun](https://github.com/VHSgunzo/sharun), which makes it extremely easy to turn any binary into a portable package without using containers or similar tricks.
|
|
|
|
**These AppImages bundle everything and should work on any Linux distro, even on musl based ones.**
|
|
|
|
A `tar.zst` portable archive of the same build is also produced alongside the AppImage, for users who prefer an install-free tarball over the AppImage format.
|
|
|
|
These AppImages work without fuse2 as they can use fuse3 instead; they can also work without fuse at all thanks to the [uruntime](https://github.com/VHSgunzo/uruntime).
|
|
|
|
---
|
|
|
|
Thank-you for being a part of & using Citron Neo, we value all members of the community whom help shape the emulator into what it is today!
|
|
|
|
- The Citron Neo Team
|