Linux first-run: atlas off PATH (bash), desktop not installed, AppImage blank window (EGL)
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 5/5
- 预计耗时
- 一周以上
- 新手友好度
- 22/100
- Issue 类型
- 缺陷
- 描述清晰度
- 基本清楚
- 活跃度
- 活跃
- 领域
- desktop-dev, release, tooling
调研方向
This is a multi-bug tracking issue, not a single edit. Start with bug 1: run the already-written failing test shellrc::tests::bash_file_on_linux_is_bashrc_even_with_a_login_file and read ShellEnv::bash_file to see where the bash PATH target is chosen. Bugs 2-4 involve install.sh, tauri.linux.conf.json and the AppImage bundle step, and need maintainer decisions plus hand testing on Debian/Ubuntu/Fedora before anything is startable. Do not pick this up as a first contribution without scoping one sub-issue first.
由索引模型根据 Issue 内容生成。
描述
Hand-tested on Omarchy (Arch, Hyprland/Wayland, AMD Radeon 680M, Mesa 26.2.5, host webkit2gtk-4.1 2.54.1), fresh curl … install.sh | sh of 1.5.0-alpha.25. Tracking issue: the Linux first-run path breaks in several places. Debian/Ubuntu/Fedora still need the same hand test.
Reproduced
1. atlas: command not found after install (bash)
ShellEnv::bash_filepicks the first of.bash_profile/.bash_login/.bashrcthat exists. Omarchy ships~/.bash_profile, so the PATH line went there.- Linux terminals start non-login bash, which reads only
~/.bashrc. Result:atlasis missing in every new terminal, even though the installer printed✓ Added to PATH [bash ~/.bash_profile]. - The macOS rule (Terminal.app starts login shells) is wrong on Linux. On Linux the line belongs in
~/.bashrc, created if missing. - A regression test is written and fails as expected:
shellrc::tests::bash_file_on_linux_is_bashrc_even_with_a_login_file.
2. The installer does not install the desktop app; it only prints a hint
install.shends with "Next: atlas desktop". Because of bug 1, the user can't even run that command.- Running
~/.atlas/bin/atlas desktopby hand works: it downloads the AppImage to~/.local/bin/atlas-desktopin about 7s, writes a.desktopentry and an icon, and the app shows up in the launcher. - Decide: should install.sh offer or install the desktop app on Linux when a graphical session is present?
3. The AppImage opens a blank window: WebKitWebProcess crashes (EGL)
- stderr:
Could not create default EGL display: EGL_BAD_PARAMETER. Aborting...(×3), then a "Process crashed: WebKitWebProcess" toast over an empty dark window. WEBKIT_DISABLE_DMABUF_RENDERER=1does not fix it.- The AppImage bundles the build distro's
libwayland-client/egl/cursor/server, and those conflict with the host Mesa. Deletingusr/lib/libwayland-*from the extracted AppImage makes the app render (the Welcome screen loads). This is a known class of Tauri/linuxdeploy problem with AppImages on rolling distros. - Fix options:
- strip the bundled libwayland in the bundle step;
- on Arch, prefer the native package (
packaging/arch) or the .deb/.rpm over the AppImage; - have
atlas desktoppick the package format per distro.
4. WebKitNetworkProcess crash and missing GStreamer after the fix in bug 3
GStreamer element appsrc not found+ GStreamer CRITICALs; a "Process crashed: WebKitNetworkProcess" toast is still shown.bundleMediaFramework: falseintauri.linux.conf.json, while the bundled WebKit expects GStreamer plugins.
5. Smaller things
- There is no
atlas doctor, so nothing checks PATH, the desktop install, WebKitGTK/GStreamer, or the session type for the user. Gtk-CRITICAL gtk_distribute_natural_allocationspam at startup (cosmetic).- The "Process crashed… Click to diagnose with AI" toasts are the only signal on a blank window; the CLI exits 0.
Still to test by hand
- Ubuntu 24.04 / Debian 12 / Fedora (VM): install.sh, PATH, AppImage vs .deb/.rpm
- zsh and fish users on Linux (
.zshenv,conf.d) - X11 session
- NVIDIA (EGL/DMABUF)
-
atlas updatesyncing the AppImage;atlas uninstallcleaning the.desktopentry, icon and PATH lines - Onboarding past Welcome: open a project, terminals (xterm.js), services, hostd
- Arch package from
packaging/arch
- 主要语言
- Rust
- 星标
- 3
- 派生
- 1
- 平均合并
- 9 小时 51 分钟
- 30 天内合并 PR
- 310
环境准备
- 没有 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
codeatlasdev/atlas 的其他 Issue
-
type: bug
难度 2/5 1-3 小时 新手友好度 75/100
codeatlasdev/atlas#597 ·
维护者通常 1 天内回复
-
area: ci os: linux type: bug
难度 2/5 1-3 小时 新手友好度 78/100
codeatlasdev/atlas#496 ·
维护者通常 1 天内回复
-
area: ci type: bug
难度 3/5 1-2 天 新手友好度 68/100
codeatlasdev/atlas#596 ·
维护者通常 1 天内回复
-
os: linux type: bug
难度 3/5 1-2 天 新手友好度 68/100
codeatlasdev/atlas#591 ·
维护者通常 1 天内回复
-
area: ci os: windows type: bug
难度 3/5 1-2 天 新手友好度 56/100
codeatlasdev/atlas#550 · 1 条评论 ·
维护者通常 1 天内回复
查看 codeatlasdev/atlas 的全部 Issue
相似的 Issue
-
marketing
难度 2/5 1-3 小时 新手友好度 76/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 74/100
kinqsradio/orbyn-engineering#729 ·
-
Plans page scenario races Shift+Tab against the plan list being drawn again in Firefox and WebKit未关闭bug
难度 2/5 1-3 小时 新手友好度 83/100
nledford/Ladderback#1091 ·
维护者通常 1 天内回复
-
bug fix packaging ui user-sprint
难度 2/5 1-3 小时 新手友好度 78/100
Vondor/KassenSturz#1197 ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 82/100
维护者通常 1 天内回复