設定#

安裝與設定 Git#

Arrow 專案使用 Git 進行版本控制，Git 易於在所有常見的作業系統上取得。

您可以依照 GitHub 上的指示安裝 Git，Arrow 儲存庫託管於 GitHub，請依照 快速入門指示操作。

當 Git 設定完成後，別忘了設定您的姓名和電子郵件

$ git config --global user.name "Your Name"
$ git config --global user.email your.email@example.com

並使用 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 建立。

複製儲存庫#

接下來您需要複製儲存庫

$ 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 分支 (origin) 和官方 Arrow 儲存庫 (upstream)。