Add README
continuous-integration/drone Build is passing Details

Signed-off-by: PeroSar <perosar1111@gmail.com>
This commit is contained in:
PeroSar 2022-05-02 16:21:51 +05:30
parent 86b776d38f
commit 3ee39789b0
Signed by: PeroSar
GPG Key ID: 5C2D258445DA8B58
1 changed files with 49 additions and 0 deletions

49
README.md Normal file
View File

@ -0,0 +1,49 @@
# Emerald GCC
[![Drone CI](https://img.shields.io/drone/build/PeroSar/emerald-gcc?logo=drone&logoColor=blue&server=https%3A%2F%2Fdrone.tildegit.org)](https://drone.tildegit.org/PeroSar/emerald-gcc)
## About
A toolchain to cross compile to Android. This outputs executables that link against Android's libc(bionic).
This is a personal project.
## Why
Androids GCC was deprecated in favor of LLVM Clang and removed from Android in January 2020.
Some projects still require GCC for building.
## How to use
- Get tarball from latest [gitea release](https://tildegit.org/PeroSar/emerald-gcc/releases)
- Extract
```bash
$ tar -xJf file.tar.xz
```
- Modify PATH
```bash
$ export PATH="$(pwd)/aarch64-linux-android-emerald/bin:$PATH"
```
- Test
```bash
$ aarch64-linux-android-gcc --version
$ aarch64-linux-android-gcc test.c -o test
```
- Run on Android (e.g. with Termux)
## Target
Compiled executables should run properly on Android 8 and above.
## Credits
- Patches from [its-pointless](https://github.com/its-pointless)
- Patches from [Android GCC 4.9](https://android.googlesource.com/toolchain/gcc)
- Sysroot from [NDK](https://github.com/android/ndk)
- Wiki pages from [Termux](https://github.com/termux)