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

オープン
#265 コメント 7 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
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分
マージ済み PR(30日)
310

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

codeatlasdev/atlas のほかの issue

codeatlasdev/atlas の issue をすべて見る

似ている issue

Rust の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。