From dc548f27964b33462197b2f4040eb385aad41dcf Mon Sep 17 00:00:00 2001 From: David Harder Date: Fri, 8 Mar 2024 11:03:27 -0600 Subject: [PATCH] Remove the "Building Android on Solus" page (#509) Reasoning and discussion [here](https://github.com/getsolus/help-center-docs/issues/508) Resolves https://github.com/getsolus/help-center-docs/issues/508 Resolves https://github.com/getsolus/help-center-docs/issues/278 --- docs/user/software/development/android.md | 102 ---------------------- docs/user/software/development/index.md | 4 - 2 files changed, 106 deletions(-) delete mode 100644 docs/user/software/development/android.md diff --git a/docs/user/software/development/android.md b/docs/user/software/development/android.md deleted file mode 100644 index 739324e7d..000000000 --- a/docs/user/software/development/android.md +++ /dev/null @@ -1,102 +0,0 @@ ---- -title: Android -summary: A quick guide to getting set up for Android development on Solus ---- - -# Building Android™ on Solus - -This article covers building the [Android Open Source Project](https://source.android.com/) (AOSP) on Solus, the instructions can also be tweaked to also install forks of Android such as [LineageOS](https://lineageos.org/). - -:::note -Note that Solus is not an officially supported Linux distribution for building Android. -::: - -## Prerequisites - -Before we can start we need to setup our build environment ready for building Android. You'll need a minimum of `100GB` of free space to download and compile Android. - -### Installing Build Dependencies - -Android 7 (Nougat) and Android 8 (Oreo) require OpenJDK 8. Android 5 (Lollipop) and Android 6 (Marshmallow) require OpenJDK 7. Both OpenJDK 7 and OpenJDK 8 are not currently in the repository. - -Next we need to install packages from the `system.devel` component, these provide common build tools for general software development. - -```bash -sudo eopkg it -c system.devel -``` - -Now we'll need to install the rest of the required build dependencies. - -```bash -sudo eopkg it curl-devel git gnupg gperf libgcc-32bit libxslt-devel lzop ncurses-32bit-devel ncurses-devel readline-32bit-devel rsync schedtool sdl1-devel squashfs-tools unzip vboot-utils vim wxwidgets-devel zip zlib-32bit-devel -``` - -Not a build dependency, but you'll definitely want ADB and Fastboot capabilities if you're developing for AOSP. - -```bash -sudo eopkg it android-tools -``` - -### Installing the `repo` Tool - -`repo` is a tool from Google to manage multiple git repositories. We'll need to install it to download the Android source code. - -```bash -mkdir ~/bin -curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo -chmod a+x ~/bin/repo -``` - -We now need to export `~/bin` to our PATH so we can run `repo` from any directory. Paste the following into your `~/.bashrc` file. - -```bash -if [ -d "$HOME/bin" ] ; then - PATH="$HOME/bin:$PATH" -fi -``` - -Run `source ~/.bashrc` for the changes to apply. - -Now our build environment is prepared, we can download the source code. - -## Downloading the Source Code - -First we need to create a directory where we want to download Android. - -```bash -mkdir ~/android && cd ~/android -``` - -Next we'll need to initialize the repository with what version of Android you want to build. You can find a list of versions you can checkout [here](https://source.android.com/docs/setup/reference/build-numbers#source-code-tags-and-builds). - -```bash -repo init -u https://android.googlesource.com/platform/manifest -b android-8.0.0_r34 -``` - -Now we can finally download the source code, this will take a long time and depends on the speed of your internet connection. The `-j` option downloads as many repos simultaneously as you have processor cores, and, the `-c` option only downloads the current branch. - -```bash -repo sync -j `nproc` -c -``` - -_If you have a slow or unreliable internet connection using `j 1` may be more reliable._ - -## Building Android - -Once the source has finished downloading we can build Android. The following commands will not build android for any specific device. For building Android specifically for your device you'll need to find additional instructions. - -```bash -source build/envsetup.sh -lunch full-eng -make -j`nproc` -``` - -## More Information - -Google has provided build instructions for building AOSP on Ubuntu and MacOS, you may find additional useful information there, not stated here. - -https://source.android.com/docs/setup/start/requirements - -If your device is supported by LineageOS you can choose your device and follow the device specific build instructions at the LineageOS Wiki. - -https://wiki.lineageos.org/devices/ diff --git a/docs/user/software/development/index.md b/docs/user/software/development/index.md index c02ed9eb1..7109e9827 100755 --- a/docs/user/software/development/index.md +++ b/docs/user/software/development/index.md @@ -21,10 +21,6 @@ The `system.devel` component installs libraries and packages for software develo --- -[**Android**](android) - -A quick guide to getting set up for Android development on Solus. - [**Containers**](containers) Install and configure containerization software on Solus.