mirror of https://github.com/topjohnwu/Magisk.git synced 2024-12-03 15:05:32 +00:00

The Magic Mask for Android

Go to file

topjohnwu 858e7bae2b More precise size for mmap		2017-11-20 03:40:37 +08:00
chromeos	Massive build script refactor	2017-06-03 20:31:02 +08:00
docs	Update docs	2017-09-28 05:39:10 +08:00
java@389299afd1	Properly and fully support dtbo patching	2017-11-15 05:48:31 +08:00
jni	More precise size for mmap	2017-11-20 03:40:37 +08:00
scripts	Properly and fully support dtbo patching	2017-11-15 05:48:31 +08:00
ziptools	MagiskManager -> java	2017-10-07 22:48:16 +08:00
.gitattributes	Build everything ourselves	2017-08-24 12:14:17 +08:00
.gitignore	Unify Magisk configuration	2017-11-06 06:22:45 +08:00
.gitmodules	Update external sources	2017-10-19 00:46:39 +08:00
build.py	Use real tmp files	2017-11-15 05:48:31 +08:00
LICENSE	Use GPL v3 license and update copyright messages	2017-04-22 17:12:54 +08:00
README.MD	Proper Windows building support	2017-11-12 04:17:56 +08:00

README.MD

Magisk

How to build Magisk

Building has been tested on 3 major platforms: macOS, Ubuntu, Windows 10

Environment Requirements

A 64-bit machine: cmake for Android is only available in 64-bit
Python 3.5+: run build.py script
Java Development Kit (JDK) 8: Compile Magisk Manager and sign zips
Latest Android SDK: ANDROID_HOME environment variable should point to the Android SDK folder
Latest Android NDK: Install NDK via sdkmanager, or via Android SDK Manager in Android Studio
(Windows Only) Colorama: Install Colorama with pip install colorama, used for ANSI color codes
(Unix only) C compiler: Build zipadjust. Windows users can use the pre-built zipadjust.exe

Instructions and Notes

The easiest way to setup a working environment is to open Magisk Manager with Android Studio. The IDE will download required components and construct the environment for you. Don't forget to set ANDROID_HOME environment variable to the SDK path.
Run the script with -h as an argument to see the built-in help message. The -h option also works for each supported actions, e.g. ./build.py binary -h
By default, the script will build binaries and Magisk Manager in debug mode. If you want to build Magisk Manager in release mode (through the flag --release), you will need to place your Java Keystore file at release_signature.jks to sign Magisk Manager's APK. For more information, check out Google's Official Documentation.

License

Magisk, including all git submodules are free software:
you can redistribute it and/or modify it under the terms of the 
GNU General Public License as published by the Free Software Foundation, 
either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

Credits

MagiskManager (java)

All contributors and translators

MagiskSU (jni/su)

MagiskPolicy (jni/magiskpolicy)

MagiskHide (jni/magiskhide)

resetprop (jni/resetprop)

ndk-busybox (jni/external/busybox)

Makefile for NDK, generated by ndk-busybox-kitchen: Copyright 2017, John Wu (@topjohnwu)
Patches for NDK: Many contributors along the way, all placed in osm0sis/android-busybox-ndk
The copyright message for busybox should be included in its own directory

Others Not Mentioned (exclude jni/external)