OneDriveGUI 技术文档
安装指南
1. 系统要求
- 确保已安装最新版本的 OneDrive for Linux,具体安装步骤请参考 官方文档。
- 最低支持的 OneDrive 客户端版本为 v2.4.15。
2. 安装方式
2.1 使用 AppImage 安装
- 从 release assets 下载最新的
OneDriveGUI-*-x86_64.AppImage
文件。 - 使用以下命令使 AppImage 文件可执行并运行:
chmod +x ./OneDriveGUI-<版本号>-x86_64.AppImage ./OneDriveGUI-<版本号>-x86_64.AppImage
- 对于 Ubuntu 22.04+ 用户,可能需要安装 FUSE2:
sudo apt install libfuse2
2.2 使用 AUR 安装
- 对于 Arch Linux 用户,可以使用 AUR 包 onedrivegui-git 进行安装。
2.3 从源码运行
- 确保系统已安装 Python3 和 pip。
- 克隆或下载本仓库内容,并进入项目目录:
git clone https://github.com/bpozdena/OneDriveGUI.git cd OneDriveGUI
- 安装依赖项:
python3 -m pip install -r requirements.txt
- 启动 OneDriveGUI:
可选:使用以下命令将 GUI 与终端分离:cd src/ python3 OneDriveGUI.py
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 配置文件和数据,以防止意外的文件删除。
- 欢迎提出问题、建议、贡献和错误报告。
- 本项目不提供任何担保。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考