Skip to content

Latest commit

 

History

History
81 lines (64 loc) · 3.44 KB

README.adoc

File metadata and controls

81 lines (64 loc) · 3.44 KB

repo - The multiple repository tool

Repo is a tool that Google has built on top of Git. Repo helps us manage the many Git repositories, does the uploads to our revision control system, and automates parts of the Android development workflow. Repo is not meant to replace Git, only to make it easier to work with Git in the context of Yocto and Android. The repo command is an executable Python script that you can put anywhere in your path.

Origin

Note
This is a clone of the origin repository by Google, Inc.
Table 1. Origin URLs

Git:

https://gerrit.googlesource.com/git-repo

Overview:

https://source.android.com/source/developing.html

Documentation:

https://source.android.com/source/using-repo.html

Work with the clone

The clone is potentially out of sync to the origin. A safe and proper workflow of development needs to sync the clone with the origin from time to time. For this step you need a local sandbox with just these two repositories, the clone and the origin (upstream) together in one local repository. To achieve this working environment, the following steps are necessary:

  1. Prepare your Git alias track

    $ git config --global alias.track '!f() { ([ $# -eq 2 ] && \
          ( echo "Setting tracking for branch " $1 " -> " $2; \
            git branch --track $1 $2; git branch --set-upstream-to=$2 $1; \
          ) || ( \
            git for-each-ref \
                --format="local: %(refname:short) <--sync--> remote: %(upstream:short)" \
                refs/heads && echo --Remotes && git remote -v \
          )); }; f'
  2. Clone origin from GitHub

    $ git clone [email protected]:lipro-yocto/git-repo.git git-repo
    $ cd git-repo
  3. Add google from Google Source

    $ git remote add upstream https://gerrit.googlesource.com/git-repo
    $ git remote update upstream
  4. Track local master on origin master

    $ git track master upstream/master
    $ git track stable upstream/stable
    $ git track

    The last command will show you all branch tracking information. You will get something like:

    local: lpn-launcher <--sync--> remote: origin/lpn-launcher
    local: master <--sync--> remote: upstream/master
    local: stable <--sync--> remote: upstream/stable
    --Remotes
    origin	[email protected]:lipro-yocto/git-repo.git (fetch)
    origin	[email protected]:lipro-yocto/git-repo.git (push)
    upstream	https://gerrit.googlesource.com/git-repo (fetch)
    upstream	https://gerrit.googlesource.com/git-repo (push)

Note
There is only a simple README information from the origin project! A good start point for documentation about Googl’s repo tool would be: