# BlueShield2.0

**Repository Path**: wyf1011/BlueShield2.0

## Basic Information

- **Project Name**: BlueShield2.0
- **Description**: 一个python的QQ9风格实例项目
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2025-02-16
- **Last Updated**: 2025-02-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

### 1 基本介绍

![poster](git_src/poster.png)

- B站视频：[点击查看视频](https://www.bilibili.com/video/BV1ZiNZewEMC/?spm_id_from=333.1387.homepage.video_card.click&vd_source=2c58526ce1c2651905f0966bd98d18e1)
- 本项目是参考最新版`QQ9`的设计风格记账应用实例项目，**项目持续更新中**
- 主要框架：`PySide2`, `PySide2-Fluent-Widgets`，其中`PySide2-Fluent-Widgets`为二次开发版本
- 本项目使用`GPLv3`开源协议，`GPLv3` 用于非商业项目



### 2 项目组成

- 项目中包含项目**源码**以及使用  **`pyinstaller`  打包好的  `win`  平台  `exe`  应用程序（支持  `win7-64bit`  或以上系统）**
- 截至2025年2月10日**打包版本**程序路径  `./bin/BlueShield2.0_EXE.zip`



### 3 项目下载

##### 3.1 地址介绍

|                 下载内容                 |                  链接                   |
| :--------------------------------------: | :-------------------------------------: |
|                 开源地址                 | https://gitee.com/madi520/BlueShield2.0 |



##### 3.2 下载项目源代码

- **方式一：** 使用`Git`客户端下载源码：下载命令如下(`master`分支为当前稳定版)

  ```shell
  git clone https://gitee.com/madi520/BlueShield2.0.git
  ```

- **方式二：** 直接下载：点击项目链接进入项目主页，在打开的项目主页中点击**克隆/下载**按钮，在弹出的二级窗口中点击**下载ZIP**即可下载。



##### 3.3 安装项目虚拟环境

- 打开`shell`定位到项目的根目录（  `main.py`  所在目录）

  ```shell
  cd "根目录路径"
  ```

- 使用`python`创建虚拟环境，**以下命令均在本项目根目录执行**

  - 安装`virtualenv`(如果已经存在请忽略)

    ```sh
    pip install virtualenv
    ```

  - 创建虚拟环境（命名为`.venv`方便`PyCharm`自动识别）

    ```
    virtualenv.exe ./.venv
    ```

  - 激活虚拟环境

    ```shell
    ./.venv/Scripts/activate
    ```

  - 安装第三方`Lib`

    ```shell
    pip install -r requirements.txt
    ```

- 复制  `PySide2-Fluent-Widgets`  的二开包（`./backup`中的三个文件夹）到虚拟环境的 `.venv/Lib/site-packages` 目录中

  - `PySide2_Fluent_Widgets-1.7.4.dist-info`
  - `qfluentwidgets`
  - `qframelesswindow`
  
- 完成后就可以启动项目`main.py`啦



### 4 开源项目目录介绍

- **`backup`**：代码：备份的`qfluentwidget`二次开发版
- **`bin`**：打包后的程序存放位置
- **`boot`**：代码：项目全局配置
- **`data`**：`sqlite3`项目本地数据库及此数据库创建脚本
- **`db`**：代码：项目数据库增删改查方法
- **`font`**：字体库，本字体为微信支付金额数字字体，用于数字金额显示
- **`img`**：项目依赖的图片资源
- **`temp`**：代码：临时代码存放区域（暂未使用）
- **`utils`**：代码：全局依赖的工具或功能
- **`view`**：代码：视图（`UI`）目录，项目`PySide2`的开发目录
  - **`com`**：代码：项目页面组件目录
  - **`com_0`**：代码：项目公共组件目录
  - **`pages`**：代码：页面布局及用户操作信号处理
  - **`widget`**：代码：`QQ9`风格基础控件
  - **`__init__.py`**：代码：`UI`入口
- **`main.py`**：代码：项目入口