# wine-assistant

**Repository Path**: openkylin/wine-assistant

## Basic Information

- **Project Name**: wine-assistant
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: LGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 6
- **Created**: 2023-06-27
- **Last Updated**: 2026-01-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# wine-assistant

openKylin wine 助手

## 1. 开发环境介绍

IDE 建议使用 VSCode，目建议安装插件如下：

prettier：代码格式化

Vue - Official：Vue 语法支持

eslint：语法检查

Cloudfoundry Manifest YML Support：yaml 语法高亮

> 关于代码格式化的配置详见.vscode/settings.json

## 2. 整体架构简介

本项目基于:

[Electron](https://www.electronjs.org/): 是使用 JavaScript，HTML 和 CSS 构建跨平台的桌面应用程序框架。 [1]Electron 兼容 Mac、Windows 和 Linux，可以构建出三个平台的应用程序

[Vue3](https://cn.vuejs.org/): 是一款用于构建用户界面的 JavaScript 框架。它基于标准 HTML、CSS 和 JavaScript 构建，并提供了一套声明式的、组件化的编程模型，帮助开发者高效地开发用户界面。

[Vitejs](https://vitejs.dev/): 前端开发与构建工具。 [1]Vite 意在提供开箱即用的配置，同时它的插件 API 和 JavaScript API 带来了高度的可扩展性，并有完整的类型支持。

[Acrodesign](https://arco.design/): 前端 UI 库

[Electron-Builder](https://www.electron.build/): 是一个可以将 Electron 应用程序打包为各种格式（Windows、Mac、Linux 等）安装程序的开源工具

架构开发，开发语言统一使用 [Typescript](https://www.typescriptlang.org/) (JavaScript 超级，提供面向对象的语法支持)

### 2.0 环境部署

#### 2.0.1 nodejs 安装

nodejs[官网](https://nodejs.org/en)下载安装包后执行:

```
xz -d /path/to/node-{version}-linxu-{arch}.tar.xz
tar zvf /path/to/node-{version}-linxu-{arch}.tar
sudo mv /path/to/node-{version}-linxu-{arch} /usr/local/ #可选步骤
sudo ln -s /usr/loca//path/to/node-{version}-linxu-{arch} /usr/local/nodejs #可选步骤
vim ~/.bashrc
#在文件最后一行加入如下内
export PATH=/usr/local/nodejs/bin:$PATH
#保存退出后执行
. ~/.bashrc
node --version 检查是否安装成功，安装成功会显示nodejs版本号
```

#### 2.0.2 yarn 安装

2.0.1 执行成功后执行如下命令

```

npm config set registry https://registry.npmmirror.com
npm install -g yarn

yarn --version #检查是否安装成功，安装成功会显示yarn版本号
```

### 2.1 yarn 镜像设置

yarn 下载依赖包时候，可以设置国内镜像来加速下载，配置方法如下：

```
yarn config set registry "https://registry.npm.taobao.org"
yarn config set electron_builder_binaries_mirror "https://npm.taobao.org/mirrors/electron-builder-binaries/"
yarn config set electron_mirror "http://npm.taobao.org/mirrors/electron/"
```

或者直接修改~/.yarnrc, 如:

```
registry "https://registry.npmmirror.com/"
electron_builder_binaries_mirror "https://npmmirror.com/mirrors/electron-builder-binaries/"
electron_mirror "http://npmmirror.com/mirrors/electron/"
```

> ps:其它包管理类似，yarn 只是笔者常用的软件包管理器

### 2.2 构建运行命令

```
yarn install #安装依赖
yarn dev #开发模式，可以实时构建
yarn build  #编译
yarn package #打包

#如要新增或修改命令，修改package.json中的scripts字段即可
```

## 3. 项目文件和目录介绍

### 3.1 主要配置文件介绍:

```
package.json #nodejs主配置文件
tsconfig.json #typescript编译器配置文件
vite.config.ts  #vite编译框架配置文件
```

### 3.2 主要源码目录介绍

```
renderer:UI界面源码目录
main:Electron主代码目录
preload:Electron预加载源码目录
```

## 4. 代码架构

### 4.1 UI 部分(renderer 目录)

```
renderer/
├── App.vue #页面主框架文件
├── assets #静态资源
│   └── vue.svg
├── components #Vue组件目录，主要定义各个子功能页面
│   ├── Components.vue
│   ├── Dependencies.vue
│   └── Programs.vue
├── i18n.ts #多语言支持
├── langs #多语言字典文件
│   ├── en.ts
│   └── zh.ts
├── main.ts #Vue入口主程序
├── routes.ts #Vue-router配置
├── style.css #主样式单
└── vite-env.d.ts
```

### 4.2 Electron 部分(main 目录)

```
main/
├── commons #通常用来定义一些公共类型，或常量
│   ├── catalogs.ts
│   ├── config.ts
│   └── define.ts
├── internal #调用本地程序逻辑源码目录， 如执行系统命令等
│   ├── Base.ts
│   ├── DependencyInternal.ts
│   ├── DependencySteps.ts
│   ├── ProgramExec.ts
│   ├── ProgramInternal.ts
│   └── ProgramSetps.ts
├── main.ts #Electron主程序入口
├── managers #数据管理相关源码目录，如从社区应用列表仓库拉去应用信息，查询应用信息等。。。
│   ├── Base.ts
│   ├── DependencyManager.ts
│   ├── DownloaderManager.ts
│   ├── FileStatusManager.ts
│   ├── IpcManager.ts
│   ├── ProgramManager.ts
│   └── RelationManager.ts
└── utils #通常定义一些通用的工具
    ├── Downloader.ts
    ├── FileTypeDetector.ts
    ├── ProcessManager.ts
    ├── Reg.ts
    ├── setWine.ts
    ├── Utils.ts
    ├── Wineboot.ts
    └── WineCommand.ts
```

### 4.3 Preload 部分

```
preload
└── preload.ts #目前只定义一个文件就够了
```

## 5. 构建生成目录

以下目录都是构建时生成的目录，请不要提交的 git 仓库，如以后还有其它类似目录请添加到.gitignore 文件中

```
dist:构建输出目录
node_modules:依赖安装目录
release:打包输出目录
```

## 6. 调试环境变量

1. WIN_PROGRAM_LOCAL 和 WIN_DEPENDENCY_LOCAL 可以使 wine 助手读取本地应用配置仓库和依赖配置仓库，用于调试， 如下示例配置：

```
export WIN_PROGRAM_LOCAL='/home/keming/work/code2/openKylin/win-program'
export WIN_DEPENDENCY_LOCAL='/home/keming/work/code2/openKylin/win-dependency'
```

2.WINE_ASSISTANT_DEBUG 变量可以打开调试模式，目前打开调试模式的作用是，wine 助手可以显示 Publish 为 False 的应用：设置如下：

```
export WINE_ASSISTANT_DEBUG=true #打开调试
export WINE_ASSISTANT_DEBUG=false #关闭调试
```

3.可以通过 WIN_PROGRAM_BRANCH 环境变量来指定调试的 win-program 分支，例如
export WIN_PROGRAM_BRANCH=0823_dev

## 7. 社区版与商用版

- 修改 main/commons/config.ts 内 \_WorkDirConfig.BuildVersion 的值，来设置版本信息
- 值以 Community 开头为社区版本 以 Commercial 开头为商用版本
- 社区版本 \_WorkDirConfig.Wine 与 \_WorkDirConfig.Wineboot 的值指向 okylin-wine； 开源版本指向 kylin-wine
- renderer/App.vue 页面内根据 preload.js getVersion() 获取当前是哪一种版本，并且显示不同的页面
- 编译商业版本应该在 package.json 定义的版本号后添加-commercial,来区分开源版本

## 8. 基于 Arm64 环境打包

基于第 2 节环境部署后，由于 electron-builder 的 fpm 没有 arm64 版本 不支持直接在 arm 主机打包。可以采取以下方法

- [方案 1](https://github.com/electron-userland/electron-builder/issues/5154)

```
#华为L410
sudo apt-get install ruby-full
sudo gem install dotenv -v 2.8.1
sudo gem install fpm
```

package.json 修改 package 的 electron-builder 为

```
USE_SYSTEM_FPM=true electron-builder --arm64 --linux deb
```