aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-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 000000000..d1b24b11d
--- /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
+```