Grive2 项目使用教程

Grive2 项目使用教程

grive2 Google Drive client with support for new Drive REST API and partial sync 项目地址: https://gitcode.com/gh_mirrors/gr/grive2

1. 项目的目录结构及介绍

Grive2 是一个开源的 Google Drive 客户端，支持新的 Drive REST API 和部分同步功能。项目的目录结构如下：

grive2/
├── cmake/                # CMake 相关文件
├── debian/               # Debian 包构建文件
├── grive/                # Grive 主程序文件
├── icon/                 # 项目图标文件
├── libgrive/             # Grive 库文件
├── package/              # 软件包相关文件
├── systemd/              # systemd 服务文件
├── .dockerignore         # Docker 忽略文件
├── .gitignore            # Git 忽略文件
├── CMakeLists.txt        # CMake 主配置文件
├── COPYING               # GPL-2.0 许可文件
├── Dockerfile            # Docker 构建文件
├── README.md             # 项目说明文件
├── completion.zsh        # Zsh 补全脚本

• cmake/：包含 CMake 模块和脚本，用于构建项目。
• debian/：包含构建 Debian 包所需的文件。
• grive/：Grive 主程序代码。
• icon/：项目图标资源。
• libgrive/：Grive 使用的库代码。
• package/：包含软件包的元数据和安装脚本。
• systemd/：包含 systemd 服务和计时器文件，用于后台同步。
• .dockerignore：定义在构建 Docker 镜像时应该忽略的文件和目录。
• .gitignore：定义在 Git 版本控制中应该忽略的文件和目录。
• CMakeLists.txt：CMake 的主配置文件，用于构建项目。
• COPYING：项目使用的 GPL-2.0 许可文件。
• Dockerfile：用于构建 Docker 镜像的文件。
• README.md：项目的自述文件，包含项目描述和使用说明。
• completion.zsh：为 Zsh 提供命令补全的脚本。

2. 项目的启动文件介绍

Grive2 的启动文件是 grive 主程序。首次运行时，您需要使用 -a 参数来授权 Grive 访问您的 Google Drive：

cd ~/google-drive
grive -a

这会打印一个 URL，您需要访问这个链接并授权 Grive 访问您的 Google Drive。授权后，Grive 会创建 .grive 和 .grive_state 文件，并开始下载 Google Drive 中的文件到当前目录。

同步本地目录中的更改，只需要再次运行 grive 命令：

cd ~/google-drive
grive

3. 项目的配置文件介绍

Grive2 使用 .grive 文件作为配置文件，存储与 Google Drive 同步的必要信息。此文件在首次运行 Grive 并授权后自动创建。

此外，Grive2 支持使用 .griveignore 文件来排除特定的文件和目录。.griveignore 的规则与 Git 的 .gitignore 类似，但有一些细微的差异：

• 以 # 开头的行被视为注释。
• 首尾空格被忽略，除非用 \ 转义。
• 不包含 ! 的非空行被视为排除模式。
• 包含 ! 的非空行被视为包含模式，并优先于所有排除模式。
• 模式与相对于 Grive 根的文件名匹配。

例如，如果您想要排除一个名为 example.txt 的文件，可以在 .griveignore 文件中添加以下内容：

example.txt

如果要包含某个文件，可以使用：

!include.txt

这样，include.txt 文件即使被其他排除规则匹配，也会被包含在同步中。

grive2 Google Drive client with support for new Drive REST API and partial sync 项目地址: https://gitcode.com/gh_mirrors/gr/grive2