- Quick Start
- Detailed Instructions
- Repository Layout
- A Bit of History
Announcement 07/16/2018: The ICU source code repository has been migrated from Subversion to Git, and is now hosted on GitHub.
You can view ICU source code online: https://github.com/unicode-org/icu
Make sure you have git lfs installed. See the following section.
For read-only usage, create a local clone:
git clone https://github.com/unicode-org/icu.git
git clone email@example.com:unicode-org/icu.git
This will check out a new directory
icu which contains icu4c and icu4j subdirectories as detailed below.
For ICU development, do not work directly with the Unicode ICU
main branch! See the git for ICU Developers page instead.
For cloning from your own fork, replace
unicode-org with your GitHub user name.
For fetching just the files for an ICU release tag, you can use a shallow clone:
git clone https://github.com/unicode-org/icu.git --depth=1 --branch=release-63-1
If you already have a clone of the ICU repository, you can add and extract release files like this:
mkdir /tmp/extracted-icu # or wherever you want to extract to cd local-git-repo-top-level-dir git fetch upstream git tag --list "*63*" # List tags relevant to ICU 63, e.g., release-63-1 git archive release-63-1 | tar -x -C /tmp/extracted-icu
(Note: you do not need a GitHub account to download the ICU source code. However, you might want such an account to be able to contribute to ICU.)
- Install a git client
sudo apt install git
- Install git-lfs if your git client does not already have LFS support (ICU uses git Large File Storage to store large binary content such as *.jar files.)
sudo apt install git-lfs
- MacOS: Consider using Homebrew or MacPorts.
- The command
git lfs versionwill indicate if LFS is installed.
- Setup git LFS for your local user account once on each machine:
git lfs install --skip-repo
There are many resources available to help you work with git, here are a few:
- https://git-scm.com/ - the homepage of the git project
- https://help.github.com/ - GitHub’s help page
- https://try.github.io/ - Resources to learn Git
Want to contribute back to ICU? See How to contribute.
The top level README.md contains the latest information about the repository’s layout. Currently:
- icu4c/ ICU for C/C++
- icu4j/ ICU for Java
- tools/ Tools
- vendor/ Vendor dependencies (copied here for reference)
The repository is tagged with different release versions of ICU.
For example, release-55-1 is the tag which corresponds to version 55.1 of ICU (for both C and J).
Branches in the main fork are used for maintenance branches of ICU.
For example, maint/maint-61 is a branch containing the latest maintenance work on the 61.x line of ICU.
There are other tags and branches which may be cleaned up/deleted at any time.
- branches/tags/releases from before the icu4c and icu4j trees were merged - items prefixed with “icu-“ are for icu4c, and “icu4j-“ for icu4j, etc.
- old personal work branches (with a person’s username, such as andy/6910)
- long running shared feature branches (In general, feature work is done on personal forks of the repository.)
See also the Tips (for developers) subpage.
ICU was first open sourced in 1999 using CVS and Jitterbug. The source files were imported from other source control systems internal to IBM at that time.
The ICU project moved to using a Subversion source code repository and a Trac bug database on Nov 30, 2006. These replace our original CVS source code repository and Jitterbug bug data base. All history from the older systems has been migrated into the new, so there should normally be no need to refer back to Jitterbug or CVS.
In July 2018, the ICU project moved again, this time from svn to git on GitHub, and from trac to Atlassian Cloud Jira. Many tools and much effort was involved in migration and testing. There is a detailed blog post on the topic (not an official ICU-TC document!) for those interested in the technical details of this move.