Popcorn-desktop-legacy 开源项目启动与配置教程

1. 项目目录结构及介绍

Popcorn-desktop-legacy 是一个开源项目，其目录结构如下：

popcorn-desktop-legacy/
├── app/                        # 应用程序主目录
│   ├── components/             # Vue组件目录
│   ├── main/                   # 应用程序入口文件和启动相关文件
│   ├── renderer/               # 渲染进程相关文件
│   ├── static/                 # 静态资源目录，如图片、字体等
│   └── store/                  # Vuex状态管理目录
├── build/                      # 构建脚本和配置文件
├── dist/                       # 构建后的文件目录
├── docs/                       # 文档目录
├── node_modules/               # 项目依赖的Node模块
├── package.json                # 项目配置文件
├── package-lock.json           # 依赖锁定文件
└── README.md                   # 项目说明文件

• app/: 项目的主要目录，包含应用程序的所有源代码。
• components/: 存放Vue.js组件的目录。
• main/: 包含应用程序的主入口文件和启动相关代码。
• renderer/: 渲染进程的代码，通常是Vue应用的主体。
• static/: 存放静态资源的目录，例如图片和字体。
• store/: Vuex状态管理相关的文件。
• build/: 构建脚本和配置文件，用于构建和打包应用程序。
• dist/: 构建后的文件目录，包含可发布的文件。
• docs/: 项目文档目录。
• node_modules/: 存放项目依赖的Node模块。
• package.json: 项目配置文件，定义了项目的依赖、脚本和其他元数据。
• package-lock.json: 依赖锁定文件，确保在不同环境中安装相同的依赖版本。
• README.md: 项目说明文件，包含了项目的描述、如何使用和安装等信息。

2. 项目的启动文件介绍

项目的启动文件位于 app/main/index.js。以下是启动文件的基本内容：

import { app, BrowserWindow } from 'electron';
import path from 'path';

let mainWindow;

function createWindow () {
  // 创建浏览器窗口
  mainWindow = new BrowserWindow({
    width: 800,
    height: 600,
    webPreferences: {
      nodeIntegration: true
    }
  });

  // 并加载应用的 index.html
  mainWindow.loadURL(`file://${__dirname}/index.html`);

  // 当窗口关闭时退出应用
  mainWindow.on('closed', function () {
    mainWindow = null;
  });
}

app.on('ready', createWindow);

app.on('window-all-closed', function () {
  if (process.platform !== 'darwin') {
    app.quit();
  }
});

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

这段代码初始化了一个Electron应用，创建了一个浏览器窗口，并加载了应用的HTML文件。

3. 项目的配置文件介绍

项目的配置文件是 package.json，它位于项目根目录下。以下是配置文件的部分内容：

{
  "name": "popcorn-desktop-legacy",
  "version": "1.0.0",
  "description": "An Electron-based desktop application for Popcorn Time.",
  "main": "app/main/index.js",
  "scripts": {
    "start": "electron .",
    "build": "electron-builder --dir"
  },
  "dependencies": {
    "electron": "^1.4.13",
    "vue": "^2.5.16"
  },
  "devDependencies": {
    "electron-builder": "^20.38.5",
    "vue-electron": "^1.0.6"
  }
}

在这个文件中：

• "name" 和 "version" 定义了项目的名称和版本。
• "description" 提供了项目的描述。
• "main" 指定了应用程序的主入口文件。
• "scripts" 定义了一些可以执行的脚本，例如 "start" 脚本用于启动应用程序，"build" 脚本用于构建应用程序。
• "dependencies" 列出了项目依赖的主要库和版本。
• "devDependencies" 列出了开发时需要用到的依赖。