BetterDiscordApp 启动与配置教程

1. 项目的目录结构及介绍

BetterDiscordApp 的目录结构大致如下：

BetterDiscordApp/
├── assets/              # 存放项目资源文件，如图标、图片等
├── config/              # 配置文件目录
├── data/                # 存储数据文件
├── dist/                # 构建后的文件存放目录
├── index.js             # 项目入口文件
├── license.txt          # 项目许可证文件
├── package.json         # 项目依赖和配置文件
├── plugins/             # 插件目录
├── themes/              # 主题目录
└── util/                # 工具函数和模块目录

主要目录说明：

• assets/：包含项目的静态资源，如图标、图片等。
• config/：存放项目的配置文件。
• data/：用于存储项目运行过程中产生的数据文件。
• dist/：构建后的项目文件存放于此，通常用于部署。
• plugins/：存放 BetterDiscordApp 的插件。
• themes/：存放 BetterDiscordApp 的主题文件。
• util/：包含项目中使用的工具函数和模块。

2. 项目的启动文件介绍

项目的启动文件是 index.js。以下是 index.js 的基本结构：

// 引入必要的模块和依赖
const { app, BrowserWindow } = require('electron');
const path = require('path');

// 创建一个新的浏览器窗口
function createWindow () {
    // 创建一个浏览器窗口
    const win = new BrowserWindow({
        width: 800,
        height: 600,
        webPreferences: {
            preload: path.join(__dirname, 'preload.js')
        }
    });

    // 并且为你的应用加载index.html
    win.loadFile('index.html');
}

// 当 Electron 完成初始化并准备创建浏览器窗口时，将调用此方法
app.whenReady().then(createWindow);

// 所有窗口关闭时退出应用
app.on('window-all-closed', () => {
    if (process.platform !== 'darwin') {
        app.quit();
    }
});

app.on('activate', () => {
    // 在 macOS 上，当点击 dock 图标并且没有其他窗口打开时，通常会在应用程序中重新创建一个窗口
    if (BrowserWindow.getAllWindows().length === 0) {
        createWindow();
    }
});

启动文件说明：

• 使用 Electron 的 app 和 BrowserWindow 模块创建应用窗口。
• createWindow 函数用于创建窗口并加载 index.html 文件。
• app.whenReady() 用于监听 Electron 初始化完成事件，然后调用 createWindow 函数。
• app.on('window-all-closed') 监听所有窗口关闭事件，用于退出应用。
• app.on('activate') 在 macOS 上处理应用激活事件。

3. 项目的配置文件介绍

项目的配置文件位于 config/ 目录下，通常包含以下文件：

• config.json：项目的通用配置。
• userconfig.json：用户自定义配置。

以下是 config.json 的示例内容：

{
    "api": {
        "url": "https://api.example.com"
    },
    "features": {
        "enableFeatureX": true,
        "enableFeatureY": false
    }
}

配置文件说明：

• config.json：存储项目级别的配置，例如 API URL、功能启用标志等。
• userconfig.json：存储用户自定义的配置，如主题、插件设置等。

配置文件在项目启动时被读取，并根据配置内容初始化应用环境和功能。