设置#

安装和设置 Git#

Arrow 项目使用 Git 进行版本控制,所有常用操作系统均可轻松使用 Git。

您可以按照 GitHub(Arrow 仓库托管的地方)上的说明安装 Git,请遵循 快速入门说明

设置 Git 后,不要忘记配置您的姓名和电子邮件

$ git config --global user.name "Your Name"
$ git config --global user.email [email protected]

使用 GitHub 进行身份验证,这样您就可以与 GitHub 交互,而无需每次执行 git 命令时都输入用户名和密码。

注意

本指南假设您熟悉命令行操作。某些 IDE 允许您管理 Git 仓库,但在这样做时可能会隐式运行不需要的操作(例如创建项目文件)。

例如,在 RStudio 中克隆它假设整个仓库是一个 RStudio 项目,并将在根目录中创建一个 .Rproj 文件。因此,*强烈建议*使用命令行或 Git 客户端克隆仓库。

获取源码#

Fork 仓库#

Arrow GitHub 仓库包含 Arrow C++ 库以及其他语言(如 Go、Java、Matlab、Python、R 等)的库。贡献的第一步是在您自己的 GitHub 帐户中创建仓库的 fork。

  1. 前往 apache/arrow

  2. 点击右上角的 Fork 按钮。

    Fork the Apache Arrow repository on GitHub.

    在 GitHub 上 fork Apache Arrow 仓库的图标。#

  3. 选择将仓库 fork 到您的用户名,以便在 https://github.com/<您的用户名>/arrow 创建 fork。

克隆仓库#

接下来,您需要克隆仓库

$ git clone https://github.com/<your username>/arrow.git

并将 Apache Arrow 仓库添加为名为 upstream 的远程仓库。

$ cd arrow
$ git remote add upstream https://github.com/apache/arrow

验证您的 upstream#

您的 upstream 应该指向 Arrow GitHub 仓库。

在 shell 中运行

$ git remote -v

应该会得到类似于以下的结果

origin    https://github.com/<your username>/arrow.git (fetch)
origin    https://github.com/<your username>/arrow.git (push)
upstream  https://github.com/apache/arrow (fetch)
upstream  https://github.com/apache/arrow (push)

如果您正确完成了所有操作,现在您应该在 arrow 目录中拥有代码副本,以及两个分别引用您自己的 GitHub fork (origin) 和官方 Arrow 仓库 (upstream) 的远程仓库。