# win-program

**Repository Path**: liangkeming/win-program

## Basic Information

- **Project Name**: win-program
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 13
- **Created**: 2023-08-02
- **Last Updated**: 2023-08-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 应用程序配置文件定义规范

## 1. index.yml

index.yml 是本仓库中所有程序配置文件的汇总，每一个具体程序的 yml 配置文件必须在 index.yml 中注册完成才能被索引到。

index.yml 中配置信息格式如下所示：

```
Key:   # 每个应用的唯一标识，且必须与 Category对应的文件夹中的文件名称匹配，如果有desktop文件，则该名字是desktop对应的名字
  Arch: win32 # exe程序对应的架构，win32或win64
  Name: 显示名称
  Description: 程序描述性信息
  Grade: Gold # 适配等级，Gold，Silver，Copper
  Category: Software # 程序类别，目前支持Education 、Game、Software
  Icon: x.png
  LinuxArch:    # 该程序可以适配的平台，根据具体测试情况定
    - x86_64
    - aarch64

# 下面是具体应用的示例
YNotes桌面便签:
  Arch: win32
  Name: YNotes桌面便签
  Description: YNotes是Ysofts出品的一款桌面便签小软件,它使用方便,界面简洁,功能较全,非常实用。
  Grade: Gold
  Category: Software
  Icon: default.png
  LinuxArch:
    - x86_64
    - aarch64

屏幕录像专家:
  Arch: win32
  Name: 屏幕录像专家
  Description: 屏幕录像软件
  Grade: Silver
  Category: Software
  Icon: wechat.png
  LinuxArch:
    - x86_64
    - aarch64
```

## 2. 应用实际对应的配置

应用详细的配置文件以 index.yml 中的 Key 为文件名，存储在仓库中 Category 对应的文件夹下。具体示例如下:

```
$ cat win-program/Software/屏幕录像专家.yml
    |  仓库名    |Category|     Key    |    <---对应index.yml

Name: 屏幕录像专家V2021
Description: 屏幕录像软件
Grade: Silver
Arch: win32
LinuxArch:
- x86_64
- aarch64
Dependencies:
- commondlls
Executable:             # 程序启动对应的参数
  name: 非常重要.exe    # 安装之后Progrom Files 目录下的名字或者绿色软件本身的名字，非常重要
  path: Program Files (x86)/xxx/xx.exe  # 应用运行路径, dos 格式
  wineenv:
  arguments:
Steps:                  # action支持 install 和 run_script
- action: install       # 实际的安装动作
  file_type: 7z
  # url是压缩包file_name要填写解压后要执行的exe文件路径，如果有多级目录要包含上层目录,如果url是exe文件则可直接写文件名
  file_name: StarUML_Setup_3.2.2/StarUML Setup 3.2.2.exe
  url: https://dl.softmgr.qq.com/original/Picture/StarUML_Setup_3.2.2.7z
  file_checksum: 'false'
  arguments: null
  protable: true        # 若不是绿色软件，则false
- action: run_script    # 暂未实现
  filename: installed.sh
  script: echo 'install completed'
Version: 20210628       # 版本
Size: 17.29MB           # 文件大小
wine_version: 20230512  # 测试的wine版本
```

## 3. 其他注意事项

### （1）常用解压命令

常见类型及解压命令：
```
zip：unzip -O GBK -q $filePath -d $destDir
rar：unrar e -y $filePath $destDir
7z：7z x -y $filePath -o$destDir
cab：cabextract -d $destDir -q $filePath
gz：tar -xf $filePath -C $destDir
xz：tar -xf $filePath -C $destDir
bz2：bzip2 -d $filePath -c |tar -xf - -C $destDir

其中，$filePath和$destDir分别表示要解压的文件路径和临时解压目录，临时解压路径在填写配置时要忽略。
```