repo-git.ppt

1、Android source code management,An introduction to Git, Repo, and Gerrit for Android developers.,Toolchain overview,Our Android source code is managed very differently from the OSE phones. Weve fully embraced the Google toolchain, which means a whole new set of tools to work with.,ClearCase,Git,CME,R

2、epo,DeliveryWeb,Gerrit,Version control,Repository mgmt,Delivery,Code review,Android 是谷歌（Google）开发的适合手持设备的操作系统，提供了当前最吸引眼球的开源的手持设备操作平台，大有超越苹果（A）专有的 iOS 系统的趋势。而 Android 的源代码就是使用 Git 进行维护的。Android 项目在使用 Git 进行源代码管理上有两个伟大的创造，一个 是用 Java 开发的名为 Gerrit 的代码审核服务器,另外一个就是本章要重点介绍的repo。,Introducing Repo,Repo is a

3、Google-developed tool for managing multiple Git repositories and submitting code for review to the Gerrit code review system. The Android platform source code consists of hundreds of repositories. Repo keeps track of the available repositories and helps us perform tasks on all of these usually with

4、one single command. Like CME, Repo wraps but does not replace the underlying version control system. In your daily work youll use both Git and Repo. The collection of git repositories is recorded in a manifest file. The manifest file is an XML file with a list of repositories and corresponding branc

5、hes, revisions, or tags. It is quite similar to the Modules section of a 1551 file.,The most common Repo commands,$ repo syncDownloads the latest changes in all repositories, rebasing your own branches as necessary. $ repo startCreate a new branch for working on a topic. $ repo uploadUpload one of m

6、ore changes to the Gerrit code review system.,Introducing Gerrit,Gerrit is a Google-developed tool thats used by their Android open source project (AOSP). It is purely web based and relies on Git for storing the source code. Each Git commit becomes a change when uploaded to Gerrit. A change is subje

7、ct to review and verification by one or more parties. The uploader of a change can at any time update the change. When the change is verified and approved, the uploader will submit the change to the designated branch. After the change has been submitted, it is no longer possible to update it. Gerrit

8、 automatically tracks dependencies between changes in the same git.,Integrated change,The life of a source code change,Git,Hack hack hack,git commit,repo upload,Reviewable,Code reviewed,Verified,Code reviewed repo upload Now Gerrit takes over and you start over on a new branch $ repo start newtopic0

9、58 .,Repo init,repo init u -b Running repo init will download the manifest and repo repositories. Where repo can find the manifest repository is handled with the -u option. If a manifest branch is specified with the -b option, this branch of the manifest git will be checked out. If no branch is spec

10、ified, the master branch of the manifest will be used. Example: repo init -u git:/ b ohd-cupcake-deckard,Repo sync,repo sync . repo sync will iterate through the specified or all repositories listed in the manifest and download the latest changes. After all changes are downloaded, your topic branch

11、will be rebased on top of the latest version of the branch listed in the manifest for that repository. Normally, this version will be the latest approved version on the parent (release/integration) branch. Only non-delivered topic branches will be rebased with repo sync. Never manually resolve any u

12、pload conflicts with git merge!,Repo start,repo start -all | . repo start creates a new branch starting from the revision (of the corresponding project) that is listed in the manifest. When using Gerrit, this means that the branch will always be based on the latest approved software without any depe

13、ndencies to changes that have not passed review.,Repo upload,repo upload . | -replace repo upload will push your changes to Gerrit for review. All commits not already delivered will be uploaded. Each commit will be a new change. If you have amended your commit, you can replace the change set for a G

14、errit change by using the -replace option.,Repo download,repo download project / Downloads and checks out the specified change from Gerrit This commit can be amended and uploaded again using repo upload -replace,Repo abandon,repo abandon If you realize that what you were working on should be scrappe

15、d, you can abandon this topic. repo abandon only affects your local repository. You can also abandon a change in Gerrit. This will only affect that change in Gerrit and not affect any Git repository.,Repo prune,repo prune . When you have uploaded your topics and they have been merged by Gerrit, you

16、can run repo prune. repo prune will delete topic branches that are already merged to the integration branch. Only topic branches that have been merged to the integration branch will be deleted this is a safe command to run.,Repo forall,repo forall . -c . Runs a loop which will execute on every git r

17、epository. This is handy when there is no corresponding repo command for what you want to do.,Gerrit doesnt merge my commit,Your commit was approved and you submitted the change, but Gerrit still says “Review in progress” Check the change comments. If Gerrit had problems merging the commit, it will

18、be listed here. If a merge conflict was the problem, make sure you have the latest changes synced to your workspace. Checkout your topic branch with the change in question on it and rebase it against the parent branch. The you can replace the old commit.,$ repo sync $ git checkout my-old-topic $ git

19、 rebase m/sw-integration $ git mergetool $ git rebase -continue $ repo upload -replace .,I forgot repo startwheres my commit?,If you forget to run repo start to create a topic branch, you will by default work on a “detached head”. I.e. any commits you make after that will float around headless. You

20、can recover. Run git reflog and find the commit you made. Start a new topic branch Then cherry-pick the commit using the first characters from the hash key as listed in the reflog and you are back on track.,$ git reflog d230d0e. HEAD0: commit: Removed Camera/Album app. Its in the Camera apk. $ repo

21、start new-topic . $ git cherry-pick d230d0e,Changeset abuse Scenario One,You made a really cool change and committed it. Unfortunately, that last “harmless” edit you made turned out to break everything If you worked on a topic branch, you have only harmed yourself You edit the file so that it works

22、again and commit the fix. Now you want to share your nice new and working feature with others You upload your topic branch to Gerrit. Repo will upload ALL your commits on the topic branch including the broken one Someone discovers the error in the first commit during review. What happens?,Multiple c

23、ommits in one change,Multiple commits multiple changes to review in Gerrit Which commit should be approved? How does the reviewer know what happened? If the broken commit is rejected, the second, containing the fix, can never be merged as it depends on the rejected one.,Integration branch,Two commit

24、s,Upload,Two changes,Amending commits,If you discover that your previous commit was incomplete or broken you canAmend it! Check out the relevant topic branch Make your fix Add the changes to the index with git add Now create a new commit, where you “fuse” your changes in the index with the previous commit: git commit -amend Presto changeo! You have a new comm