OneDriveGUI 技术文档

OneDriveGUI 技术文档

OneDriveGUI A simple GUI for OneDrive Linux client, with multi-account support. 项目地址: https://gitcode.com/gh_mirrors/on/OneDriveGUI

安装指南

1. 系统要求

• 确保已安装最新版本的 OneDrive for Linux，具体安装步骤请参考 官方文档。
• 最低支持的 OneDrive 客户端版本为 v2.4.15。

2. 安装方式

2.1 使用 AppImage 安装

1. 从 release assets 下载最新的 OneDriveGUI-*-x86_64.AppImage 文件。
2. 使用以下命令使 AppImage 文件可执行并运行：

   chmod +x ./OneDriveGUI-<版本号>-x86_64.AppImage
   ./OneDriveGUI-<版本号>-x86_64.AppImage
   

3. 对于 Ubuntu 22.04+ 用户，可能需要安装 FUSE2：

   sudo apt install libfuse2
   

2.2 使用 AUR 安装

• 对于 Arch Linux 用户，可以使用 AUR 包 onedrivegui-git 进行安装。

2.3 从源码运行

1. 确保系统已安装 Python3 和 pip。
2. 克隆或下载本仓库内容，并进入项目目录：

   git clone https://github.com/bpozdena/OneDriveGUI.git
   cd OneDriveGUI
   

3. 安装依赖项：

   python3 -m pip install -r requirements.txt
   

4. 启动 OneDriveGUI：

   cd src/
   python3 OneDriveGUI.py
   

   可选：使用以下命令将 GUI 与终端分离：

   cd src/
   nohup python3 OneDriveGUI.py > /dev/null 2>&1&
   

项目使用说明

1. 启动 GUI

• 启动 OneDriveGUI 后，您可以选择创建新的 OneDrive 配置文件或导入现有的配置文件。
• 按照向导步骤完成配置文件的创建或导入。

2. 配置 OneDrive 配置文件

• 您可以根据需要调整 OneDrive 配置文件的选项。
• 使用 GUI 中的“播放”按钮启动 OneDrive 同步监控模式。

3. 管理多个账户

• OneDriveGUI 支持管理多个 OneDrive 账户，并提供异步实时监控功能。
• 您可以导入和管理 Business Shared Folders 和 SharePoint Shared Libraries。

项目 API 使用文档

1. 配置文件导入

• 导入 OneDrive 配置文件时，所有注释将被移除，缺失的选项将使用 默认值 进行替换。
• 如果使用了多行选项（如 skip_file 和 skip_dir），它们将被合并为单行。

2. 配置文件管理

• 所有管理的 OneDrive 配置文件列表存储在 ~/.config/onedrive-gui/profiles 中。
• 您可以手动重命名配置文件或更改配置文件路径。

3. 日志记录

• 调试日志保存在 /tmp/onedrive-gui/onedrive-gui.log 中。
• 日志记录设置可以在 GUI 设置中进行更改。

其他注意事项

• 在使用 OneDriveGUI 之前，建议备份您的 OneDrive 配置文件和数据，以防止意外的文件删除。
• 欢迎提出问题、建议、贡献和错误报告。
• 本项目不提供任何担保。

OneDriveGUI A simple GUI for OneDrive Linux client, with multi-account support. 项目地址: https://gitcode.com/gh_mirrors/on/OneDriveGUI