Repo (Script)
Encyclopedia
Repo is a tool that Google
built on top of Git
to manage the many Git repositories
, do the uploads to revision control system
, and automate 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 Android. The repo command is an executable Python
script that can be put anywhere in the development system.
), keeping this all in one Git
tree would've been problematic because these requirements would not have been met:
is an open-source version control system designed to handle very large projects that are distributed over multiple repositories
. In the context of Android, Git is used for local operations such as local branching, commits, diffs, and edits. Repo is used for across-network operations. For example, with a single Repo command it is possible to download files from multiple repositories into your local working directory
.
will automatically perform the operations described in the various Command Line Configuration and installation instructions, and will work with any of the package managers described therein.
Google
Google Inc. is an American multinational public corporation invested in Internet search, cloud computing, and advertising technologies. Google hosts and develops a number of Internet-based services and products, and generates profit primarily from advertising through its AdWords program...
built on top of Git
Git (software)
Git is a distributed revision control system with an emphasis on speed. Git was initially designed and developed by Linus Torvalds for Linux kernel development. Every Git working directory is a full-fledged repository with complete history and full revision tracking capabilities, not dependent on...
to manage the many Git repositories
Software repository
A software repository is a storage location from which software packages may be retrieved and installed on a computer.- Discussion :Many software publishers and other organizations maintain servers on the Internet for this purpose, either free of charge or for a subscription fee...
, do the uploads to revision control system
Revision Control System
The Revision Control System is a software implementation of revision control that automates the storing, retrieval, logging, identification, and merging of revisions. RCS is useful for text that is revised frequently, for example programs, documentation, procedural graphics, papers, and form...
, and automate 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 Android. The repo command is an executable Python
Python (programming language)
Python is a general-purpose, high-level programming language whose design philosophy emphasizes code readability. Python claims to "[combine] remarkable power with very clear syntax", and its standard library is large and comprehensive...
script that can be put anywhere in the development system.
Reason for creation
According to the Google OpenSource Blog the reason this tool was created was, with approximately 8.5 million lines of code (not including things like the Linux KernelLinux kernel
The Linux kernel is an operating system kernel used by the Linux family of Unix-like operating systems. It is one of the most prominent examples of free and open source software....
), keeping this all in one Git
Git (software)
Git is a distributed revision control system with an emphasis on speed. Git was initially designed and developed by Linus Torvalds for Linux kernel development. Every Git working directory is a full-fledged repository with complete history and full revision tracking capabilities, not dependent on...
tree would've been problematic because these requirements would not have been met:
- Delineate access control based on location in the tree.
- Ability to make some components replaceable at a later date.
- Trivial overlays for OEMOEMOEM means the original manufacturer of a component for a product, which may be resold by another company.OEM may also refer to:-Computing:* OEM font, or OEM-US, the original character set of the IBM PC, circa 1981...
s and other projects who either aren't ready or aren't able to embrace open source. - No need for technical people to spend their time as patch monkeys.
A tool on top of Git
GitGit (software)
Git is a distributed revision control system with an emphasis on speed. Git was initially designed and developed by Linus Torvalds for Linux kernel development. Every Git working directory is a full-fledged repository with complete history and full revision tracking capabilities, not dependent on...
is an open-source version control system designed to handle very large projects that are distributed over multiple repositories
Software repository
A software repository is a storage location from which software packages may be retrieved and installed on a computer.- Discussion :Many software publishers and other organizations maintain servers on the Internet for this purpose, either free of charge or for a subscription fee...
. In the context of Android, Git is used for local operations such as local branching, commits, diffs, and edits. Repo is used for across-network operations. For example, with a single Repo command it is possible to download files from multiple repositories into your local working directory
Directory (file systems)
In computing, a folder, directory, catalog, or drawer, is a virtual container originally derived from an earlier Object-oriented programming concept by the same name within a digital file system, in which groups of computer files and other folders can be kept and organized.A typical file system may...
.
Automated Installation
The google-repo-setup.sh shell scriptShell script
A shell script is a script written for the shell, or command line interpreter, of an operating system. It is often considered a simple domain-specific programming language...
will automatically perform the operations described in the various Command Line Configuration and installation instructions, and will work with any of the package managers described therein.
External links
- Get Android Source Code (scroll to Installing Repo section)
- Using Repo and Git