From f9bd37f7f2a7469ad2b2990f40f1589359acfe09 Mon Sep 17 00:00:00 2001 From: topjohnwu Date: Thu, 28 Mar 2019 10:00:56 -0400 Subject: [PATCH] Magisk Module Installer --- .gitattributes | 8 ++ META-INF/com/google/android/update-binary | 10 ++ META-INF/com/google/android/updater-script | 1 + README.md | 8 +- common/post-fs-data.sh | 9 ++ common/service.sh | 9 ++ common/system.prop | 3 + install.sh | 154 +++++++++++++++++++++ module.prop | 6 + system/placeholder | 1 + 10 files changed, 208 insertions(+), 1 deletion(-) create mode 100644 .gitattributes create mode 100644 META-INF/com/google/android/update-binary create mode 100644 META-INF/com/google/android/updater-script create mode 100644 common/post-fs-data.sh create mode 100644 common/service.sh create mode 100644 common/system.prop create mode 100644 install.sh create mode 100644 module.prop create mode 100644 system/placeholder diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 000000000..8980df1a0 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,8 @@ +# Declare files that will always have LF line endings on checkout. +META-INF/** text eol=lf +*.prop text eol=lf +*.sh text eol=lf +*.md text eol=lf + +# Denote all files that are truly binary and should not be modified. +system/** binary diff --git a/META-INF/com/google/android/update-binary b/META-INF/com/google/android/update-binary new file mode 100644 index 000000000..08bd14f06 --- /dev/null +++ b/META-INF/com/google/android/update-binary @@ -0,0 +1,10 @@ +#!/sbin/sh +# This is a dummy file that should be replaced with a proper installer script + +# If you are creating a module locally for personal usage or testing, +# download the script in the following URL: +# https://github.com/topjohnwu/Magisk/blob/master/scripts/module_installer.sh +# And replace this script with the downloaded script + +# Error, this script should always be replaced +exit 1 diff --git a/META-INF/com/google/android/updater-script b/META-INF/com/google/android/updater-script new file mode 100644 index 000000000..11d5c96e0 --- /dev/null +++ b/META-INF/com/google/android/updater-script @@ -0,0 +1 @@ +#MAGISK diff --git a/README.md b/README.md index 972b47310..ea2333c92 100644 --- a/README.md +++ b/README.md @@ -1 +1,7 @@ -# Magisk Module Template +# Magisk Installer + +**Update `README.md` if you want to submit your module to the online repo!** + +For more information about how to use this module installer, please refer to [documentations](https://topjohnwu.github.io/Magisk/guides.html) + +If you are not familiar with the Markdown syntax, you can start by experimenting on GitHub's online Markdown editor, which will let you preview before publishing. If you need more help, the [Markdown Cheat Sheet](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) will be handy. diff --git a/common/post-fs-data.sh b/common/post-fs-data.sh new file mode 100644 index 000000000..a347e4c4b --- /dev/null +++ b/common/post-fs-data.sh @@ -0,0 +1,9 @@ +#!/system/bin/sh +# Do NOT assume where your module will be located. +# ALWAYS use $MODDIR if you need to know where this script +# and module is placed. +# This will make sure your module will still work +# if Magisk change its mount point in the future +MODDIR=${0%/*} + +# This script will be executed in post-fs-data mode diff --git a/common/service.sh b/common/service.sh new file mode 100644 index 000000000..e891a9bd6 --- /dev/null +++ b/common/service.sh @@ -0,0 +1,9 @@ +#!/system/bin/sh +# Do NOT assume where your module will be located. +# ALWAYS use $MODDIR if you need to know where this script +# and module is placed. +# This will make sure your module will still work +# if Magisk change its mount point in the future +MODDIR=${0%/*} + +# This script will be executed in late_start service mode diff --git a/common/system.prop b/common/system.prop new file mode 100644 index 000000000..3d427899d --- /dev/null +++ b/common/system.prop @@ -0,0 +1,3 @@ +# This file will be read by resetprop +# Example: Change dpi +# ro.sf.lcd_density=320 diff --git a/install.sh b/install.sh new file mode 100644 index 000000000..e999dcf58 --- /dev/null +++ b/install.sh @@ -0,0 +1,154 @@ +########################################################################################## +# +# Magisk Module Installer Script +# +########################################################################################## +########################################################################################## +# +# Instructions: +# +# 1. Place your files into system folder (delete the placeholder file) +# 2. Fill in your module's info into module.prop +# 3. Configure and implement callbacks in this file +# 4. If you need boot scripts, add them into common/post-fs-data.sh or common/service.sh +# 5. Add your additional or modified system properties into common/system.prop +# +########################################################################################## + +########################################################################################## +# Config Flags +########################################################################################## + +# Set to true if you do *NOT* want Magisk to mount +# any files for you. Most modules would NOT want +# to set this flag to true +SKIPMOUNT=false + +# Set to true if you need to load system.prop +PROPFILE=false + +# Set to true if you need post-fs-data script +POSTFSDATA=false + +# Set to true if you need late_start service script +LATESTARTSERVICE=false + +########################################################################################## +# Replace list +########################################################################################## + +# List all directories you want to directly replace in the system +# Check the documentations for more info why you would need this + +# Construct your list in the following format +# This is an example +REPLACE_EXAMPLE=" +/system/app/Youtube +/system/priv-app/SystemUI +/system/priv-app/Settings +/system/framework +" + +# Construct your own list here +REPLACE=" +" + +########################################################################################## +# +# Function Callbacks +# +# The following functions will be called by the installation framework. +# You do not have the ability to modify update-binary, the only way you can customize +# installation is through implementing these functions. +# +# When running your callbacks, the installation framework will make sure the Magisk +# internal busybox path is *PREPENDED* to PATH, so all common commands shall exist. +# Also, it will make sure /data, /system, and /vendor is properly mounted. +# +########################################################################################## +########################################################################################## +# +# The installation framework will export some variables and functions. +# You should use these variables and functions for installation. +# +# ! DO NOT use any Magisk internal paths as those are NOT public API. +# ! DO NOT use other functions in util_functions.sh as they are NOT public API. +# ! Non public APIs are not guranteed to maintain compatibility between releases. +# +# Available variables: +# +# MAGISK_VER (string): the version string of current installed Magisk +# MAGISK_VER_CODE (int): the version code of current installed Magisk +# BOOTMODE (bool): true if the module is currently installing in Magisk Manager +# MODPATH (path): the path where your module files should be installed +# TMPDIR (path): a place where you can temporarily store files +# ZIPFILE (path): your module's installation zip +# ARCH (string): the architecture of the device. Value is either arm, arm64, x86, or x64 +# IS64BIT (bool): true if $ARCH is either arm64 or x64 +# API (int): the API level (Android version) of the device +# +# Availible functions: +# +# ui_print +# print to console +# Avoid using 'echo' as it will not display in custom recovery's console +# +# abort +# print error message to console and terminate installation +# Avoid using 'exit' as it will skip the termination cleanup steps +# +# set_perm [context] +# if [context] is empty, it will default to "u:object_r:system_file:s0" +# this function is a shorthand for the following commands +# chown owner.group target +# chmod permission target +# chcon context target +# +# set_perm_recursive [context] +# if [context] is empty, it will default to "u:object_r:system_file:s0" +# for all files in , it will call: +# set_perm file owner group filepermission context +# for all directories in (including itself), it will call: +# set_perm dir owner group dirpermission context +# +########################################################################################## +########################################################################################## +# If you need boot scripts, DO NOT use general boot scripts (post-fs-data.d/service.d) +# ONLY use module scripts as it respects the module status (remove/disable) and is +# guaranteed to maintain the same behavior in future Magisk releases. +# Enable boot scripts by setting the flags in the config section above. +########################################################################################## + +# Set what you want to display when installing your module + +print_modname() { + ui_print "*******************************" + ui_print " Magisk Module Template " + ui_print "*******************************" +} + +# Copy/extract your module files into $MODPATH in on_install. + +on_install() { + # The following is the default implementation: extract $ZIPFILE/system to $MODPATH + # Extend/change the logic to whatever you want + ui_print "- Extracting module files" + unzip -o "$ZIPFILE" 'system/*' -d $MODPATH >&2 +} + +# Only some special files require specific permissions +# This function will be called after on_install is done +# The default permissions should be good enough for most cases + +set_permissions() { + # The following is the default rule, DO NOT remove + set_perm_recursive $MODPATH 0 0 0755 0644 + + # Here are some examples: + # set_perm_recursive $MODPATH/system/lib 0 0 0755 0644 + # set_perm $MODPATH/system/bin/app_process32 0 2000 0755 u:object_r:zygote_exec:s0 + # set_perm $MODPATH/system/bin/dex2oat 0 2000 0755 u:object_r:dex2oat_exec:s0 + # set_perm $MODPATH/system/lib/libart.so 0 0 0644 +} + +# You can add more functions to assist your custom script code diff --git a/module.prop b/module.prop new file mode 100644 index 000000000..8b32b58a2 --- /dev/null +++ b/module.prop @@ -0,0 +1,6 @@ +id=template +name=Template Module +version=v1 +versionCode=1 +author=topjohnwu +description=A short description diff --git a/system/placeholder b/system/placeholder new file mode 100644 index 000000000..1a693958c --- /dev/null +++ b/system/placeholder @@ -0,0 +1 @@ +This file will be deleted in Magisk Manager, it is only a placeholder for git