ukui-theme-customizer/README.md

# 主题制作工坊软件介绍
## 软件概述  
### 背景与意义  
主题制作工坊是一款专为 openKylin 系统设计的定制主题软件。openKylin  操作系统以其开源、自由的特性受到广泛欢迎，用户系统个性化的需求也非常重要。openKylin系统主题模块致力为整个麒麟操作系统提供优质装扮服务，包括主题、壁纸、光标、高亮色等多种美化类资源。主题制作工坊旨在提供用户一个灵活且直观的工具，满足用户对系统外观的高度自定义需求，帮助用户轻松定制个性化的系统外观。  
    
### 项目描述  
本项目基于openKylin操作系统，制作一款协助用户定制打包个性化主题的UI工具，并帮助用户在使用过程中了解熟悉系统主题模块。  
主题制作工坊采用前后端分离架构：前端负责获取用户信息、协助用户导入素材、协助用户定制个性化主题；后端获取前端提供信息制作相关主题包。该架构提高了开发效率、可维护性和可扩展性，同时也提供了更好的用户体验。  
  
### 使用场景  
主题制作工坊适用于个人用户、企业用户以及 openKylin 爱好者。个人用户可以通过该工具定制个性化的桌面环境，满足自身审美需求。企业用户可以在企业环境中使用该工具，为公司或团队创建统一的视觉风格。openKylin 爱好者则可以通过该工坊深度参与系统定制，探索更多创意和可能性。  
  
### 项目功能
该工具能够合理协助用户制作个性化系统主题，其中包含壁纸、光标、图标、系统样式、开机动画、grub界面、全局主题等。用户根据个人需求选择新建全局、图标、光标、开机动画、grub界面主题。其中全局主题包含图标、光标、开机动画、grub界面、系统样式和壁纸等主题，其他四个类型仅包含各自对应类型主题。  
  
在选择完需要制作的主题后，根据界面提示补充相关素材，点击制作补充用户相关信息后稍等一段时间，在右上角选择的保存路径中会生成对应主题包，点击安装后，在控制面板中即可进行选择。  
  
同时，当用户编辑了部分素材退出后会提示保存历史记录，如果选择保存，会需要补充部分用户信息用于记录，历史记录可保存30日，历史记录会在主界面中显示，点击历史记录即可再次编辑。  
  

### 特点
#### 多元主题修改  
主题制作工坊不仅提供全局主题的修改，还涵盖图标、光标、开机动画和 grub 界面等多个方面的定制。这一全面的主题修改功能使用户能够全方位地打造独一无二的系统外观。  
    
#### 直观用户界面    
软件采用直观、用户友好的界面设计，使得即使是初学者也能轻松上手。各个主题模块的设置清晰可见，用户通过简单的点击和拖拽即可完成各项修改，无需深入了解复杂的技术细节。配置主题修改内容可以实时预览， 用户在自定义主题设置中的每次修改都会立即反映在预览界面上。    
  
#### 支持多种格式  
壁纸模块支持 PNG 图片格式和 JPG 图片格式、开机动画模块支持 MP4 文件格式和 PNG 图片格式，为用户提供了更大的自由度。用户可以选择符合自己审美和需求的多种媒体格式。  
  
### 实时预览    
#### 即时生效  
用户在自定义主题设置中的每次修改都会立即反映在预览界面上。  
实时交互： 用户可以动态地查看和评估他们对主题的各种调整。  
  
#### 用户体验  
可视反馈： 提供实时预览，使用户能够直观地了解其对主题的修改效果，减少了试错的可能性。  
定制性体验： 用户可以根据实际需求调整主题设置，通过实时预览迅速找到最满意的外观。  
用户满意度： 增加用户满意度，因为他们能够在调整主题时立即看到结果，而无需不断保存和刷新。  
  
#### 预览界面功能  
交互式元素： 在预览界面上提供交互式元素，使用户能够直接在预览中与某些主题元素进行交互，以更全面地评估外观效果。  
比较功能： 提供比较功能，允许用户在不同主题设置之间切换，以更容易地选择最喜欢的外观。 
    
## 主题制作工坊软件功能概览  
主题制作工坊是专为 openKylin 系统设计的定制主题软件。它提供了修改五个主题的功能，包括全局主题、图标主题、光标主题、开机动画和 grub 主题。接下来将逐个介绍这些功能的使用位置以及要求限制。
  
### 全局主题
#### 封面设置
  
  系统使用位置：控制面板-个性化/主题，定制控制面板中全局主题的封面预览显示。  
  素材要求：  
   - 尺寸设置：   
     - 宽度： 1640 像素  
     - 高度： 1080 像素   
   - 文件大小限制： 5MB   
   - 文件格式：PNG   

  这样的参数设置将确保用户在定制控制面板显示时，能够上传满足特定尺寸和文件格式要求的图片。确保软件在接收用户上传的图片时，会检查并强制执行这些参数，以保证用户体验的一致性和最佳效果。  
  
![](img/1.png)  

#### 壁纸定制  
     
  系统使用位置：控制面板-个性化/主题，定制控制面板中全局主题的壁纸。  
  素材要求：
   - 尺寸设置：    
     - 宽度： 3840 像素   
     - 高度： 2160 像素    
   - 文件大小限制： 10MB  
   - 支持的文件格式：PNG、JPG  
  
  这样的参数设置确保了用户在选择壁纸时能够使用符合指定尺寸和文件格式的图片。这有助于保持壁纸的质量和兼容性，并确保在不同屏幕上都能够正常显示。  
  
![](img/2.png)  
  
![](img/3.png)  
  
![](img/4.png)  
  

#### 窗口外观
     
  系统使用位置：控制面板-个性化/主题：窗口透明度：调整窗口的透明度，实现更加个性化的窗口外观。  
  - 透明度范围：  
   - 最小值： 0  
   - 最大值： 100  
   - 默认透明度：65  
  
  这样的参数设置允许用户在一个 0 到 100 的范围内调整窗口的透明度，其中 0 表示完全透明，100 表示完全不透明。默认透明度设置为 65，以提供一个中等程度的透明效果。  
  
![](img/5.png)  
  
![](img/6.png)  
  
![](img/7.png)  
  
  系统使用位置：控制面板-个性化/主题：窗口圆角大小：定制窗口边角的圆角大小，营造不同的窗口风格。  
  - 大小限制：  
    - 大圆角：圆角大小： 12 像素 (px)  
    - 中圆角：圆角大小： 6 像素 (px)  
    - 小圆角：圆角大小： 0 像素 (px)  
    - 默认圆角：中圆角  
  
  这样的参数设置允许用户选择不同的圆角大小，分别为大、中、小三种。  
  
![](img/8.png)  
  
![](img/9.png)  
  
![](img/10.png)  
  
  系统使用位置：控制面板-个性化/主题：窗口深浅主题：定制窗口深浅主题  
  - 深主题：  
    - 提供深色调的主题，适合喜欢暗色调的用户。  
  - 浅主题：  
    - 提供浅色调的主题，适合喜欢明亮色调的用户。  
  - 默认主题：浅主题  
  
  用户可以在这两种主题之间进行选择，以满足用户对窗口外观的个性化喜好。  
  
![](img/11.png)  
  
![](img/12.png)  
  
#### 控件定制  
  
  系统使用位置：控制面板-个性化/主题：控件圆角大小：调整界面控件的圆角大小，增强整体视觉效果。  
  - 圆角大小范围：  
   - 最小值： 0 像素 (px)  
   - 最大值： 18 像素 (px)  
   - 默认圆角大小：6 像素 (px)  
   
  用户可以在 0 到 18 像素的范围内选择他们喜欢的圆角大小。默认圆角大小设置为 6 像素，以提供一个中等程度的圆角效果。  
  
![](img/13.png)  
  
![](img/14.png)  
  
![](img/15.png)  
  
  系统使用位置：控制面板-个性化/主题：强调色：选择强调色，用于突出显示界面中的重要元素。  
  - 可选的强调色：  
    - daybreakBlue、jamPurple、magentaSunRed、sunsetOrange、dustGold、polarGreen  
  - 默认强调色：  
    - daybreakBlue  

  用户可以在这些选项中选择他们喜欢的强调色，以使界面中的重要元素更为突出。  
  
![](img/16.png)  
  
![](img/17.png)  
  
![](img/18.png)  
  
![](img/19.png)  
  

### 图标主题
    
  应用图标：定制每个应用的图标，支持常见的应用如 biometric-manager、box-manager 等。  
  
![](img/20.png)  
  
  系统图标：修改系统控制面板中的图标，包括 kylin-settings-account、kylin-settings-application 等。  
  
![](img/21.png)  
  
### 光标主题  
  
  光标样式：从预设的光标样式中选择，也支持导入自定义的光标。  
  
![](img/22.png)  

### 开机动画  
  
  - 支持的格式  
    - MP4 文件格式：允许用户上传和应用 MP4 格式的开机动画
      - 支持的文件格式：MP4
      - 文件大小限制：10MB
    - PNG 图片：支持将一张 PNG 图片作为开机动画，为用户提供更多创意空间。
      - 支持的文件格式：PNG
      - 文件大小限制：20KB
  
![](img/23.png)

### Grub 主题
  
  上传自定义图片：选择并上传用户喜欢的图片作为 Grub 界面的背景。
  - 尺寸设置：
    - 宽度： 3840 像素
    - 高度： 2160 像素
  - 文件大小限制： 10MB
  - 支持的文件格式：PNG
  
![](img/24.png)
  
![](img/25.png)
  
  
通过主题制作工坊，用户能够将 openKylin 操作系统打造成符合自己独特品味和需求的个性化系统，从而提升整体的用户体验。