aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDan Albert <danalbert@google.com>2015-11-05 06:47:19 (GMT)
committerDan Albert <danalbert@google.com>2015-11-05 18:20:54 (GMT)
commit6239c1ee0bd05602de249f99c7dbf30bc761cb2d (patch)
tree84bf36ecb263c9482becd0d8f5e1b60de5a86684
parent5d4204651a0012981a04387dfcbd17956f271ce5 (diff)
downloadtoolchain_gcc-6239c1ee0bd05602de249f99c7dbf30bc761cb2d.zip
toolchain_gcc-6239c1ee0bd05602de249f99c7dbf30bc761cb2d.tar.gz
toolchain_gcc-6239c1ee0bd05602de249f99c7dbf30bc761cb2d.tar.bz2
Add a README.md for building Android's GCC.
Bug: http://b/25191787 Change-Id: Ifa79236dd144496419f079ddac18259ead607844
-rw-r--r--README.md48
1 files changed, 48 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d1b24b1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,48 @@
+Building GCC for Android
+========================
+
+The following process is used to build the GCC that is used by both the Android
+platfrom and the NDK.
+
+Both Linux and Windows toolchains are built on Linux machines. Windows host
+binaries are built with mingw. Building binaries for Mac OS X should be built
+using 10.8 to ensure compatibility with Android's minimum supported hosts.
+
+Prerequisites
+-------------
+
+* [Android GCC Repository](http://source.android.com/source/downloading.html)
+ * Check out the branch `gcc`
+
+ ```bash
+ repo init -u https://android.googlesource.com/platform/manifest -b gcc
+
+ # Googlers, use
+ repo init -u \
+ persistent-https://android.git.corp.google.com/platform/manifest \
+ -b gcc
+ ```
+
+* Additional Linux Dependencies (available from apt):
+ * texinfo
+ * gcc-mingw32
+ * bison
+ * flex
+ * libtool
+* Mac OS X also requires Xcode.
+
+Host/Target prebuilts
+---------------------
+
+### For Linux or Darwin:
+
+```bash
+# Additional options and toolchain names will be show with --help.
+$ python build.py --toolchain TOOLCHAIN_NAME
+```
+
+### For Windows, from Linux:
+
+```bash
+$ python build.py --system windows TOOLCHAIN_NAME
+```