Aquesta és la versió actual. · Data de publicació:
Fitxers d’instal·lació 2.0.0
| Arquitectura | Tipus | Àmbit | Mida del fitxer | Baixa | SHA256 |
|---|---|---|---|---|---|
| 64 bits | EXE (NSIS) · en-US | Usuari actual | — | github.com | VirusTotal |
| 64 bits | EXE (NSIS) · en-US | Tots els usuaris | — | github.com | VirusTotal |
| ARM64 | EXE (NSIS) · en-US | Usuari actual | — | github.com | VirusTotal |
| ARM64 | EXE (NSIS) · en-US | Tots els usuaris | — | github.com | VirusTotal |
L’enllaç i l’SHA256 provenen del manifest comunitari del Gestor de paquets del Windows. Convé comparar el hash del fitxer baixat abans d’executar-lo.
Notes de la versió
The major release that modernizes Freelens internals and unlocks further development.
v2.0.0 is a full internal rewrite of how Freelens is built, bundled, and tested. The application, its internal packages, and the extension API are now ESM-first, compiled by a single [Vite](https://vite.dev/) (electron-vite) pipeline directly from TypeScript sources, and tested with [Vitest](https://vitest.dev/). The UI runs on React 19, and the extension API has been redesigned as a specified, frozen contract, checked by porting real extensions to it. Most of the work is in the foundation, but the release also brings a standalone terminal, faster and more reliable cluster connections over HTTP/2, custom resources for users who may not list their definitions, verified binary downloads, and a long list of fixes. The extension API is **not compatible with v1 extensions**.
## What's new:
### Breaking Changes
* The extension API has been reorganized and is **not compatible with Freelens v1 extensions**. Extensions must be updated for v2 before they will load. Extensions may now be authored as either ESM or CommonJS, and must target React 19. See the [migration guide](https://github.com/freelensapp/freelens/blob/main/docs/extensions/migrating-from-v1.md). See #2102, #2110, #2304, #2465
* Extensions are now installed under the application data directory (`<userData>/extensions`) instead of `~/.freelens/extensions`. Extensions installed for v1 are not migrated and have to be installed again in their v2 versions. See #2400, #2467
* Renderer extensions get no guarantee of Node or Electron, `require()` included; Node work belongs in the main process, reached over IPC. See #2483, #2484
* Freelens is now ESM-first throughout — the main process, the renderer, all internal modules, and the extension API ship as ES modules. See #2102, #1718
* macOS 13 Ventura or later is required: Electron 44 no longer supports macOS 12. See #2864
* Removed the hierarchical-namespaces (HNC) tree view from the namespace details, together with the deprecated `@mui/lab` it was built on. See #2290
* Downloaded kubectl versions start at Kubernetes 1.22, and the China package mirror option is gone (the mirror stopped syncing). Older clusters use the bundled kubectl. See #2348, #2351
### New Features
* Open a terminal outside a cluster session: a standalone terminal page with its own tabs, reachable from the Welcome page, the Catalog, the hotbar and the command palette. It uses your own shell environment, `KUBECONFIG` and `kubectl`/`helm`, and the application's proxy as `HTTPS_PROXY`. See #2359, #2364
* Custom resources work for users who may list them but not their `CustomResourceDefinitions`: the sidebar, the list views and the details are built from the cluster's API discovery instead. See #2675, #2676, #2677, #2679
* Resource search matches across dashes and underscores, so `nginxingress` finds `nginx-ingress`. See #1937, #2711
* Cluster settings to skip the namespace authorization and metrics endpoint checks, for faster connection to large clusters. See #1699
* Terminal tabs show startup progress, including the kubectl download and its verification, instead of a stalled "Connecting ...". See #2357, #2358, #2367, #2368
* macOS natural text editing shortcuts in the embedded terminal (Option+Arrow word navigation, Command+Arrow line navigation, Command/Option+Delete). See #1051, #2338, #2354, #2355
* Installing an extension that is already installed and enabled offers to replace it, or to reinstall the same version, instead of failing with "Disable or uninstall it first". See #2798, #2799
* The Extensions page shows "Failed to load" for an enabled extension whose code did not load, with the process, the stage and the error in its tooltip, and labels each install as `verified`, `unverified` or `development` in colour. See #2780, #2787, #2788
* Downloaded log files have a timestamp in their name, so repeated downloads no longer overwrite each other. See #1884, #2565
* The Node Group column of the nodes list recognizes kops instance groups. See #2454
* The installers have their own icon, the application icon with an install badge, so they are no longer mistaken for the application. See #2838
* The HTTP Proxy preference accepts `socks5://` proxies as well as `http://` and `https://`, and becomes `HTTPS_PROXY` in the terminal outside clusters, as the proxy of a cluster already is in its terminal. Both proxy settings now say what goes through them. See #2433, #2878
### Extensions API
* **A specified contract.** The v2 API is described by normative contracts — the guarantee, the stable surface and the failure mode of each part — and everything it exports stays frozen until the next major. See [api.md](https://github.com/freelensapp/freelens/blob/main/docs/extensions/api.md), [binaries.md](https://github.com/freelensapp/freelens/blob/main/docs/extensions/binaries.md) and the [migration guide](https://github.com/freelensapp/freelens/blob/main/docs/extensions/migrating-from-v1.md) with the v1 → v2 rename table. See #2304, #2465, #2501, #2562
* **Proven by porting real extensions.** The contract and the migration guide were checked by porting the example, Gateway API, Flux CD, AI, Karpenter, Velero and Freelens for Claude extensions to v2, and every gap found on the way was fixed in the host or in the documentation. The documentation points to [freelens-example-extension](https://github.com/freelensapp/freelens-example-extension) as the reference template, and to its agent skills for creating and porting an extension. See #2653, #2654, #2655, #2662, #2663, #2664, #2665, #2666, #2686, #2687, #2694, #2696, #2705, #2706, #2719, #2723, #2732, #2761, #2770
* **New delivery mechanism.** A built-in installer replaces pnpm (and drops 20 MB of it from every build): install from a package name, a URL, a `.tgz` file or a local directory, with integrity checked at install time. Extensions are served over a privileged `freelens-extension://` scheme and loaded by URL, and a development extension reloads when it is rebuilt — once per rebuild, also for a build that writes its main and renderer entries in two runs. Installing from a typed Windows drive path now works. See #2400, #2467, #2468, #2469, #2471, #2472, #2500, #2710
* **Host singletons.** React, ReactDOM, the JSX runtime, MobX, mobx-react and Monaco are shared with extensions through the `FreelensExtensionApi` global, so an extension never ships its own copy. `@ogre-tools/*` is no longer part of the contract; an extension that wants dependency injection bundles its own. See #2450, #2474, #2534, #2535
* **Complete Kubernetes types.** `K8sApi` re-exports the whole kube-object and kube-api type surfaces, and `KubeApi` and the other type-and-value pairs can be named as types again. The concrete host store classes are no longer exported. See #2365, #2475, #2478, #2480, #2504, #2505
* **Typed registrations.** `Renderer.K8sApi.detailsFor()` and `menuItemFor()` build detail and menu registrations from the model class, so a component written for another kind does not compile. Pages, preference inputs and hints, menu items and cluster frame components are typed with the props the host actually passes. See #2655, #2656, #2670, #2671, #2672, #2692
* **Custom resources.** A new `customResources` field lists the custom resources an extension presents with pages of its own, and hides them from the Custom Resources tree of the sidebar while the extension is enabled. The host registers an API and a store for every served version of a CRD, prefers the served storage version, and drops the APIs and stores of a deleted CRD. See #2655, #2656, #2668, #2674, #2698, #2700
* **The host's kubectl, helm and terminal environment** are available to main-process extensions through `Main.Shell`: the binaries Freelens runs for a cluster, with the download and verification phases reported, and the environment its terminals get. The same code now prepares the cluster, node shell and standalone terminals. See #2704, #2709, #2712, #2715
* **Renderer-safe utilities.** `Main.Util.fetch`, the host's proxy-aware `fetch`, typed as the standard `fetch` (the renderer uses Chromium's global `fetch`), `createReactKey`, `sha256Hex` and `kustomizeHash` hashing helpers, a Node-free event emitter for `CatalogCategory`, and the Node-bound members removed from `Util`. `Catalog.getAllClusters()` and `getClusterById()` are observable by contract in both processes. See #2395, #2396, #2481, #2482, #2487, #2488, #2489, #2490, #2723, #2732
* **Fixes found by the ports.** `KubeJsonApi.forCluster` is callable, `objectConstructor` of an API object is the class itself, so a store over a host API applies its watch events, `ExtensionStore` accepts a model declared as an interface, disabling an extension stops the sync of its stores instead of leaving two copies saving each other in an endless loop, stylesheets load without console errors, and `Renderer.Navigation.navigate` warns about a relative pathname. An unset boolean query value of `KubeApi` (`follow`, `watch`, `previous`, `timestamps`) is no longer sent as `true`, and `PodApi.deleteWithFinalizers()` really clears the finalizers. See #2651, #2652, #2667, #2669, #2707, #2708, #2721, #2722, #2759, #2767, #2770
* **A leaner published package.** `@freelensapp/extensions` ships a self-contained declaration built with TypeScript 7 and rolldown-plugin-dts. Unused members that pulled Electron, `react-window`, `@xterm/xterm`, MUI, `forRemoteCluster` and several abandoned packages into the declaration are gone, every external package it imports is declared, and the build fails if it ever references Node. See #2360, #2363, #2375, #2388, #2445, #2446, #2485, #2486, #2498, #2499, #2545, #2557, #2559
* An in-repo fixture extension tests the contract in the unit and integration suites on all three platforms. See #2451, #2452, #2492, #2500
...
Full release notes: https://github.com/freelensapp/freelens/releases/tag/v2.0.0