93787f8389
fix: add win version checks for DWM attr api This adds version checking before using Windows 11-specific DWM APIs. Closes HFE-821 The desktop app crashes on startup on older Windows versions (pre-Windows 11) due to unsupported DWM API calls for dark mode and caption styling. According to docs at https://learn.microsoft.com/en-us/windows/win32/api/dwmapi/ne-dwmapi-dwmwindowattribute, both `DWMWA_USE_IMMERSIVE_DARK_MODE` and `DWMWA_CAPTION_COLOR` attributes are only supported starting with Windows 11 Build 22000. > DWMWA_USE_IMMERSIVE_DARK_MODE: [...] This value is supported starting > with Windows 11 Build 22000" and > DWMWA_CAPTION_COLOR: [...] This value is supported starting > with Windows 11 Build 22000. See https://github.com/hoppscotch/hoppscotch/discussions/4984 for more details, for reports of app crashing immediately on startup with these errors: ``` Failed to set dark mode: Error { code: HRESULT(0x80070057), message: "The parameter is incorrect." } note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace [0417/150158.530:ERROR:window_impl.cc(122)] Failed to unregister class Chrome_WidgetWin_0. Error = 1412 ``` The tests were all over the place, both attributes (sometimes!) seems to be present on Windows 10 1809 and even earlier, only if it was installed with network access, so perhaps this is due to Windows updates? Other times, they weren't, especially on VMs. The issue is reproducible on Windows Server 2019 Datacenter (v10.0.17763), which is equivalent to Windows 10 version 1809. This version is too old to support DWMWA_USE_IMMERSIVE_DARK_MODE, which is only **officially supported** starting with Windows 11 Build 22000 according to Microsoft's documentation. So at the moment, relying on official docs seems to be the right call, and themes are definitely something app shouldn't crash for regardless. |
||
|---|---|---|
| .. | ||
| crates/webapp-bundler | ||
| plugin-workspace | ||
| public | ||
| src | ||
| src-tauri | ||
| .gitignore | ||
| connection-to-self-hosted-instance.png | ||
| desktop-app.png | ||
| index.html | ||
| package.json | ||
| postcss.config.js | ||
| README.md | ||
| tailwind.config.ts | ||
| tsconfig.json | ||
| tsconfig.node.json | ||
| vite.config.ts | ||
Hoppscotch Desktop App ALPHA
Hoppscotch Desktop App is a cross-platform Hoppscotch app built with Tauri V2
Now with the ability to connect to Self-Hosted instances
Install Hoppscotch Desktop App
- Download the latest version of Hoppscotch Desktop App
- Open the downloaded file.
- Follow the on-screen instructions to install Hoppscotch Desktop App.
- Open Hoppscotch Desktop App.
Access Hoppscotch
Hoppscotch Cloud Edition for Individuals
Access Hoppscotch Cloud Edition from Hoppscotch Desktop App:
- Open Hoppscotch Desktop App.
- Click the Hoppscotch logo in the top-left corner.
- Click "HOPPSCOTCH CLOUD".
- Sign in with your Hoppscotch Cloud account to access your workspaces and collections.
Hoppscotch Self-Hosted Edition for Community
Note
To enable desktop app support for your self-hosted Hoppscotch instance, make sure to update the
WHITELISTED_ORIGINSenvironment variable in your.envfile with your deployment URL.e.g. to allow connection to
https://hoppscotch.mydomain.comyou need to addapp://hoppscotch_mydomain_com(MacOS, Linux) andhttp://app.hoppscotch_mydomain_com(Windows) to theWHITELISTED_ORIGINSenvironment variable.WHITELISTED_ORIGINS=...existing_origins,app://hoppscotch_mydomain_com,http://app.hoppscotch_mydomain_com
Add your self-hosted Hoppscotch Community Edition instance to Hoppscotch Desktop App:
- Open Hoppscotch Desktop App.
- Click the Hoppscotch logo in the top-left corner.
- Click "Add an instance".
- Enter the URL of your self-hosted Hoppscotch instance.
- Click "Connect".
Tip
You can also self-host Hoppscotch Desktop App.
- Install and generate the selfhost web app:
cd ../hoppscotch-selfhost-web pnpm install pnpm generate- Build the webapp bundler:
cd crates/webapp-bundler cargo build --release- Bundle the web app:
cd target/release ./webapp-bundler --input [path-to-dist-directory] --output [path-to-hoppscotch-desktop]/bundle.zip --manifest [path-to-hoppscotch-desktop]/manifest.json- Run the Tauri development server:
or the following for production build:cd src-tauri pnpm tauri devcd src-tauri pnpm tauri dev
Note
[path-to-dist-directory]should point to thedistdirectory created by thepnpm generatecommand in step 1.
Hoppscotch Self-Hosted Edition for Enterprise
Note
To enable desktop app support for your self-hosted Hoppscotch instance, make sure to update the
WHITELISTED_ORIGINSenvironment variable in your.envfile with your deployment URL.e.g. to allow connection to
https://hoppscotch.mydomain.comyou need to addapp://hoppscotch_mydomain_com(MacOS, Linux) andhttp://app.hoppscotch_mydomain_com(Windows) to theWHITELISTED_ORIGINSenvironment variable.WHITELISTED_ORIGINS=...existing_origins,app://hoppscotch_mydomain_com,http://app.hoppscotch_mydomain_com
Add your self-hosted Hoppscotch Enterprise Edition instance to Hoppscotch Desktop App:
- Open Hoppscotch Desktop App.
- Click the Hoppscotch logo in the top-left corner.
- Click "Add an instance".
- Enter the URL of your self-hosted Hoppscotch instance.
- Click "Connect".
Note
For docker setup, the desktop app uses a server at port
3200, and it is part of the frontend container:❯ docker run -p 3000:3000 -p 3200:3200 hoppscotch/hoppscotch-frontendOnce the container is live, you can enter
[your-ip]:3200or simply the base address of the instance if you are using subpath access.