B2: setup finish without hang, Open with for PHP files, 0.1.0-alpha
- Finish page starts Lutra through Explorer (Exec, returns at once) instead of RunAsUser/ShellExecute on the setup's UI thread. The 0.0.0 setup hung there while the new, unsigned exe was checked (Norton 360 active); Windows ended it and left lutra-desktop.exe suspended. The NSIS template is an adapted copy of tauri-bundler 2.10.2's. - installer/hooks.nsh registers Lutra only under OpenWithProgids and Applications\lutra-desktop.exe for .php/.phtml/.phpt/.inc; the default app stays. The uninstaller removes exactly those entries. macOS gets an Alternate-rank CFBundleDocumentTypes entry and handles RunEvent::Opened. - A file path argument opens the file inside its Git/Composer root (or folder); a running instance takes it over, switching projects only when the file lies outside (never over unsaved changes). - Version 0.1.0-alpha in the workspace, tauri.conf.json and ui; a test keeps tauri.conf.json in step with the crate version. - xtask bundle passes CARGO_TARGET_DIR to the Tauri CLI as an absolute path. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
parent
84ff80a89f
commit
b17d26b400
17 changed files with 1430 additions and 58 deletions
|
|
@ -23,15 +23,31 @@ Lutra installs for your user only: no administrator rights, no UAC prompt. It ne
|
|||
1. Start `Lutra_<version>_x64-setup.exe`.
|
||||
2. Windows SmartScreen says "Windows protected your PC", because the setup is not signed. Click **More info**, check that the app is `Lutra_<version>_x64-setup.exe` and the publisher is "Unknown publisher", then click **Run anyway**. If you downloaded the file with a browser, the browser may ask first whether to keep it.
|
||||
3. The setup runs in English or German, following Windows. Click **Next**, keep or change the folder (default `%LOCALAPPDATA%\Lutra`), click **Install**.
|
||||
4. On the last page, tick **Create desktop shortcut** if you want one, and click **Finish**.
|
||||
4. On the last page, tick **Create desktop shortcut** if you want one, keep or clear **Run Lutra**, and click **Finish**. The setup closes at once; Lutra starts through Explorer a moment later.
|
||||
|
||||
Lutra is now in the Start menu as **Lutra**. Installing a newer setup over it updates it in place and keeps your settings.
|
||||
Lutra is now in the Start menu as **Lutra** and in Settings → Apps → Installed apps. Installing a newer setup over it updates it in place and keeps your settings.
|
||||
|
||||
For scripts: `Lutra_<version>_x64-setup.exe /S` installs silently with both shortcuts, `/D=C:\path` (last argument) picks the folder, `/NS` skips the shortcuts.
|
||||
For scripts: `Lutra_<version>_x64-setup.exe /S` installs silently with both shortcuts, `/P` shows only the progress bar, `/D=C:\path` (last argument) picks the folder, `/NS` skips the shortcuts, `/R` starts Lutra afterwards.
|
||||
|
||||
### Opening PHP files from Explorer
|
||||
|
||||
The setup offers Lutra in Explorer's **Open with** menu for `.php`, `.phtml`, `.phpt` and `.inc` files. It does not become the default app: double-clicking a PHP file still opens whatever opened it before. To make Lutra the default, pick **Open with → Choose another app → Lutra** and tick **Always**.
|
||||
|
||||
A file opened this way opens in a tab, inside the project around it: the nearest folder above it that is a Git repository, else the nearest one with a `composer.json`, else the file's own folder. If Lutra is already running, the running window takes the file. A file outside its open project switches the project; if the open project has unsaved changes, Lutra refuses to switch and nothing is lost. The same works from a terminal: `lutra-desktop.exe C:\path\to\file.php`.
|
||||
|
||||
### If the setup stops responding on the last page
|
||||
|
||||
Seen once, with the 0.0.0 setup on a PC with Norton 360: after **Finish** with "Run Lutra" ticked, the setup window stopped responding, Windows closed it ("has stopped interacting with Windows", event AppHangB1), and Lutra did not open. What we found:
|
||||
|
||||
- The 0.0.0 setup started Lutra with Tauri's `RunAsUser` helper, which calls ShellExecute on the setup's window thread. The new `lutra-desktop.exe` process was created **suspended** (one thread, wait reason "Suspended", no CPU time, no window) while the freshly written, unsigned exe was being checked, and the setup waited inside that call. When Windows ended the hanging setup, nothing resumed the process: it stayed in Task Manager as a `lutra-desktop.exe` without a window.
|
||||
- The same kind of build installed on the same PC without a hang, by hand and from a script. The stall depends on the check of a new, unknown file and could not be reproduced on demand. Norton 360 was active; its settings were not changed.
|
||||
- In that run the Installed-apps entry (`HKCU\Software\Microsoft\Windows\CurrentVersion\Uninstall\Lutra`) was missing and `HKCU\Software\Lutra\Lutra` still pointed to an older test install, although the files, `uninstall.exe` and the Start-menu shortcut were written. Every later install on the same PC wrote both keys correctly; why they were missing in that one run is not known.
|
||||
|
||||
Since 0.1.0-alpha the finish page starts Lutra through Explorer (`explorer.exe "<install folder>\lutra-desktop.exe"`) and returns at once, so the setup no longer waits for those checks, and a slow check delays only Lutra's start. If you still find a `lutra-desktop.exe` without a window after a setup, end it in Task Manager and start Lutra from the Start menu. If Lutra is missing from Installed apps, run the setup again: it writes the entry anew.
|
||||
|
||||
### Uninstalling on Windows
|
||||
|
||||
Settings → Apps → Installed apps → **Lutra** → … → **Uninstall**, or run `uninstall.exe` in the install folder. The uninstaller removes the app and its shortcuts. Your settings, recovery journal and Phpactor stay unless you tick **Delete the application data**.
|
||||
Settings → Apps → Installed apps → **Lutra** → … → **Uninstall**, or run `uninstall.exe` in the install folder. The uninstaller removes the app, its shortcuts, its Installed-apps entry and the **Open with** entries. Your settings, recovery journal and Phpactor stay unless you tick **Delete the application data**.
|
||||
|
||||
## macOS
|
||||
|
||||
|
|
@ -47,6 +63,10 @@ xattr -dr com.apple.quarantine /Applications/Lutra.app
|
|||
|
||||
You need to do this once per installed version.
|
||||
|
||||
### Opening PHP files from Finder
|
||||
|
||||
Lutra registers as an alternate editor for `.php`, `.phtml`, `.phpt` and `.inc` files: it appears under **Open With** without becoming the default. A file opens as on Windows, in the project around it.
|
||||
|
||||
### Uninstalling on macOS
|
||||
|
||||
Quit Lutra and drag **Lutra** from **Applications** to the Trash. Your data stays; delete the folders below to remove it.
|
||||
|
|
@ -70,3 +90,4 @@ An instance started with `--control PORT` or `--data-dir DIR` keeps its files in
|
|||
| Date | Change | Summary |
|
||||
|---|---|---|
|
||||
| 2026-10-31 | major | B1: initial version, NSIS setup and DMG, unsigned |
|
||||
| 2026-10-31 | minor | B2: finish-page hang found and fixed, Open with for PHP files, version 0.1.0-alpha |
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue