Linux first-run: atlas off PATH (bash), desktop not installed, AppImage blank window (EGL)

未关闭
#265 7 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
22/100
Issue 类型
缺陷
描述清晰度
基本清楚
活跃度
活跃
技术栈
bash, linux, rust, tauri

调研方向

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 内容生成。

描述

os: linux priority: 1 high type: bug

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_file picks the first of .bash_profile/.bash_login/.bashrc that exists. Omarchy ships ~/.bash_profile, so the PATH line went there.
  • Linux terminals start non-login bash, which reads only ~/.bashrc. Result: atlas is 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.sh ends with "Next: atlas desktop". Because of bug 1, the user can't even run that command.
  • Running ~/.atlas/bin/atlas desktop by hand works: it downloads the AppImage to ~/.local/bin/atlas-desktop in about 7s, writes a .desktop entry 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=1 does not fix it.
  • The AppImage bundles the build distro's libwayland-client/egl/cursor/server, and those conflict with the host Mesa. Deleting usr/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 desktop pick 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: false in tauri.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_allocation spam 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 update syncing the AppImage; atlas uninstall cleaning the .desktop entry, 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

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

codeatlasdev/atlas 的其他 Issue

查看 codeatlasdev/atlas 的全部 Issue

相似的 Issue

更多 Rust Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。