mirror of
https://github.com/l0ng-ai/openidea.git
synced 2026-11-19 00:10:00 +00:00
When the system WebKit predates Safari 15.4 (macOS 11, and 12 before 12.3) and Safari's update has staged a newer WebKit, main re-execs once with DYLD_FRAMEWORK_PATH pointing at the staged frameworks and clears it again in the second process, so child processes keep the system frameworks. macOS 12.3+ and 13+ keep the system engine without a restart; an unreadable system version also keeps it. - Entitlements: allow-dyld-environment-variables only; library validation stays on (the staged framework is Apple-signed). - Bundle and link minimum back to 11.0 so Launch Services opens the app on Big Sur; .cargo/config.toml sets MACOSX_DEPLOYMENT_TARGET as a default a developer can override. - The staged copy is checked with a stat before the system version is read, so current macOS never spawns defaults at startup. - Debug builds skip the bindings export when the build checkout is absent. - Boot error page, install and contributor docs describe the Big Sur case. Tested by the contributor on macOS 11.7.11 (Safari 16.6.1 staged) and 26.5; by us on macOS 15.7.8 (no re-exec). Co-authored-by: qq471754603 <23146592+qq471754603@users.noreply.github.com>
103 lines
5.0 KiB
Plaintext
103 lines
5.0 KiB
Plaintext
---
|
||
title: "Install"
|
||
description: "Download and install OpenIDEA on macOS, Windows or Linux, and keep it up to date."
|
||
---
|
||
|
||
Every release on the [GitHub releases page](https://github.com/l0ng-ai/openidea/releases/latest) has builds for macOS, Windows and Linux, each for x64 and arm64. Releases are also mirrored to [CNB](https://cnb.cool/l0ng-ai/openidea/-/releases), which is usually faster from mainland China.
|
||
|
||
In the file names below, `<version>` is the release version, for example `0.1.40`.
|
||
|
||
## macOS
|
||
|
||
macOS 12 Monterey or later. macOS 11 Big Sur also works: install the latest Safari update in Software Update first, and OpenIDEA will load the newer WebKit Apple stages alongside it (the system engine predates Safari 15.4). On macOS 12, install that update too if its system WebKit is older than Safari 15.4; otherwise the built-in engine is used as is.
|
||
|
||
| Mac | File |
|
||
| ------------- | -------------------------------- |
|
||
| Apple silicon | `OpenIDEA_<version>_aarch64.dmg` |
|
||
| Intel | `OpenIDEA_<version>_x64.dmg` |
|
||
|
||
<Steps>
|
||
<Step title="Open the disk image">Double-click the `.dmg` file.</Step>
|
||
<Step title="Copy the app">Drag **OpenIDEA** into **Applications**.</Step>
|
||
<Step title="Start OpenIDEA">
|
||
Open it from Applications or Launchpad. Release builds are signed and notarized, so macOS opens them without extra
|
||
steps.
|
||
</Step>
|
||
</Steps>
|
||
|
||
<Tip>
|
||
Move OpenIDEA to Applications before you install the `openidea` shell command: the command links into the app bundle,
|
||
so it must stay where it is. See [Command line](/en/reference/cli).
|
||
</Tip>
|
||
|
||
## Windows
|
||
|
||
Three packages per architecture (`x64` or `arm64`):
|
||
|
||
| Package | File | Notes |
|
||
| ------------- | --------------------------------------------- | --------------------------------------------------------------------------------------- |
|
||
| Setup program | `OpenIDEA_<version>_x64-setup.exe` | Installs for the current user or for all users. |
|
||
| MSI | `OpenIDEA_<version>_x64_en-US.msi` | For managed or scripted installs. |
|
||
| Portable zip | `OpenIDEA_<version>_windows_x64_portable.zip` | No installer: unpack and run `openidea.exe`. A `.sha256` checksum file sits next to it. |
|
||
|
||
OpenIDEA uses the Microsoft Edge WebView2 runtime, which Windows 10 and 11 include. The setup program installs it if it is missing.
|
||
|
||
<Warning>
|
||
The Windows packages are not code-signed yet, so Microsoft Defender SmartScreen may warn about an unknown publisher
|
||
the first time you run one. Choose **More info**, then **Run anyway**.
|
||
</Warning>
|
||
|
||
## Linux
|
||
|
||
Three packages per architecture:
|
||
|
||
| Package | x64 | arm64 |
|
||
| ------------------------ | ----------------------------------- | ------------------------------------- |
|
||
| Debian / Ubuntu | `OpenIDEA_<version>_amd64.deb` | `OpenIDEA_<version>_arm64.deb` |
|
||
| Fedora / RHEL / openSUSE | `OpenIDEA-<version>-1.x86_64.rpm` | `OpenIDEA-<version>-1.aarch64.rpm` |
|
||
| AppImage | `OpenIDEA_<version>_amd64.AppImage` | `OpenIDEA_<version>_aarch64.AppImage` |
|
||
|
||
<CodeGroup>
|
||
|
||
```sh Debian / Ubuntu
|
||
sudo apt install ./OpenIDEA_<version>_amd64.deb
|
||
```
|
||
|
||
```sh Fedora / RHEL
|
||
sudo dnf install ./OpenIDEA-<version>-1.x86_64.rpm
|
||
```
|
||
|
||
```sh AppImage
|
||
chmod +x OpenIDEA_<version>_amd64.AppImage
|
||
./OpenIDEA_<version>_amd64.AppImage
|
||
```
|
||
|
||
</CodeGroup>
|
||
|
||
The app needs WebKitGTK 4.1; the `.deb` and `.rpm` packages pull it in as a dependency.
|
||
|
||
<Note>
|
||
Keep an AppImage in a permanent location. The `openidea` shell command points at the AppImage file, so after moving
|
||
it, install the command again.
|
||
</Note>
|
||
|
||
## Updates
|
||
|
||
OpenIDEA checks for a new version at startup and every 4 hours while it runs, and shows a notification when one is available. Choose **Install and Restart** in the notification: OpenIDEA downloads the update in the background, installs it and restarts. If a window has unsaved changes and cancels the restart, the update applies the next time you start OpenIDEA. You can also check by hand:
|
||
|
||
- macOS: **OpenIDEA › Check for Updates…**
|
||
- Windows and Linux: **Help › Check for Updates…**
|
||
|
||
Configure updates in **Settings › Appearance & Behavior › System Settings › Updates**:
|
||
|
||
- **Check for updates automatically**: turn off the background checks. **Check Now** still works.
|
||
- **Update source**: **GitHub**, **CNB (China mirror)**, or **Automatic**, which uses CNB when the IDE language is Chinese and GitHub otherwise. When the chosen source can't be reached, the other one is tried.
|
||
|
||
To update a portable Windows copy, download the newer zip and replace `openidea.exe`.
|
||
|
||
Updates go through the proxy set in **Settings › Appearance & Behavior › System Settings › HTTP Proxy**.
|
||
|
||
## Build from source
|
||
|
||
To build and run OpenIDEA from a checkout, see [Development setup](/en/contribute/setup).
|