# electro_init

**Repository Path**: qiustudio/electro_init

## Basic Information

- **Project Name**: electro_init
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-09
- **Last Updated**: 2026-02-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Electro Test App

这是一个基于 Electron 构建的基础桌面应用程序模板，用于快速启动 Electron 项目开发。

## 技术栈

- **框架**: Electron ^38.3.0
- **开发语言**: JavaScript
- **前端技术**: HTML5, CSS3
- **包管理器**: Yarn

## 项目结构

```
electro_init/
├── index.js          # 主进程文件，负责创建窗口和管理应用生命周期
├── preload.js        # 预加载脚本，安全地暴露 API 给渲染器进程
├── index.html        # 渲染器进程文件，提供应用 UI 界面
├── package.json      # 项目配置和依赖管理
└── yarn.lock         # Yarn 依赖锁定文件
```

## 安装步骤

1. **克隆项目**

   ```bash
   git clone <repository-url>
   cd electro_init
   ```

2. **安装依赖**

   ```bash
   yarn install
   ```

## 使用方法

### 启动开发服务器

```bash
npm start
# 或
yarn start
```

这将启动 Electron 应用，打开一个包含基本界面的窗口。

### 应用功能

- **基本界面**: 显示应用标题和欢迎信息
- **交互功能**: 点击按钮显示 "Hello from Electron!" 消息
- **版本信息**: 显示应用版本号

## 项目架构

### 1. 主进程 (Main Process)

位于 `index.js` 文件中，负责：
- 创建和管理浏览器窗口
- 处理应用生命周期事件
- 配置应用窗口的参数和 WebPreferences

### 2. 预加载脚本 (Preload Script)

位于 `preload.js` 文件中，负责：
- 在渲染器进程和主进程之间建立安全的通信桥梁
- 使用 `contextBridge` 暴露安全的 API 给渲染器进程

### 3. 渲染器进程 (Renderer Process)

位于 `index.html` 文件中，负责：
- 提供用户界面
- 处理用户交互
- 显示应用内容

## 扩展指南

您可以通过以下方式扩展此应用：

1. **修改 UI 界面**
   - 编辑 `index.html` 文件以更改应用的外观和布局
   - 修改 CSS 样式以自定义视觉效果

2. **添加功能**
   - 在 `index.js` 中添加新的主进程功能
   - 在 `preload.js` 中暴露更多 API
   - 在 `index.html` 中添加新的交互功能

3. **添加依赖**
   - 使用 `yarn add <package-name>` 安装新的依赖包

4. **打包应用**
   - 安装打包工具：`yarn add electron-builder --dev`
   - 在 `package.json` 中配置打包选项
   - 运行打包命令：`yarn run build`

## 开发注意事项

- **安全最佳实践**: 始终使用 `contextBridge` 安全地暴露 API，避免直接启用 `nodeIntegration`
- **跨平台兼容性**: 考虑 Windows、macOS 和 Linux 平台的差异
- **性能优化**: 对于复杂应用，注意内存使用和渲染性能

## 许可证

ISC License

## 贡献

欢迎提交 Issue 和 Pull Request 来改进此项目！

## 联系方式

如果您有任何问题或建议，请随时联系项目维护者。