• 简体中文

      • 配置

      Rselectron 会自动解析 项目根目录 下名为 rselectron.config.{ts,js,mts,mjs,cts,cjs} 的配置文件。显式传入配置路径可使用其他文件名。加载委托给 Rsbuild 的配置加载器（默认 auto；见 CLI 的 --config-loader）。

      用 defineConfig 声明配置。外层是三个进程键 — main、preload、renderer — 以及可选的顶层 electron，用于应用启动与发现。

      每个进程键都是一份完整的 Rsbuild 配置，再叠上该进程的 Rselectron electron 选项。通用 Rsbuild 字段请查 Rsbuild 文档，Rselectron 增量见 进程（Processes）、Electron、环境（Environment）。

      最小示例

      rselectron.config.ts
      import { defineConfig } from '@rselectron/core';

export default defineConfig({
  main: {
    root: './src/main',
    source: { entry: { index: './index.ts' } },
  },
  preload: {
    root: './src/preload',
    source: { entry: { index: './index.ts' } },
  },
  renderer: {
    root: './src/renderer',
    source: { entry: { index: './index.ts' } },
  },
});

      配置函数

      defineConfig 也接受函数，参数为 { command, mode, envMode }：

      字段含义
      command当前操作：dev、build、preview 或 inspect
      modeRsbuild 构建模式：development、production 或 none
      envMode环境文件命名空间；与构建模式相互独立 — 见 环境
      rselectron.config.ts
      import { defineConfig } from '@rselectron/core';

export default defineConfig(({ command, mode, envMode }) => ({
  main: {
    root: './src/main',
    source: { entry: { index: './index.ts' } },
    output: {
      minify: command === 'build' && mode === 'production',
    },
  },
  preload: {
    root: './src/preload',
    source: { entry: { index: './index.ts' } },
  },
  renderer: {
    root: './src/renderer',
    source: { entry: { index: './index.ts' } },
  },
}));

      需要按环境文件命名空间分支时使用 envMode；文件加载规则仍见 环境。

      组合配置

      没有隐式的 shared 块。跨进程复用请显式组合：

      • mergeRselectronConfig — 合并外层进程键与应用级 electron
      • mergeRsbuildConfig — 在单个进程的 Rsbuild 面上合并（保留 Rsbuild 插件 / 函数合并规则）
      import {
  defineConfig,
  mergeRselectronConfig,
  mergeRsbuildConfig,
} from '@rselectron/core';

const withLegacyDecorators = {
  source: { decorators: { version: 'legacy' as const } },
};

export default defineConfig(
  mergeRselectronConfig(
    {
      main: mergeRsbuildConfig(
        { root: './src/main', source: { entry: { index: './index.ts' } } },
        withLegacyDecorators,
      ),
      preload: mergeRsbuildConfig(
        { root: './src/preload', source: { entry: { index: './index.ts' } } },
        withLegacyDecorators,
      ),
    },
    {
      renderer: {
        root: './src/renderer',
        source: { entry: { index: './index.ts' } },
      },
    },
  ),
);