Skip to content

Commit

Permalink
Update to new Magisk Module Installer
Browse files Browse the repository at this point in the history
  • Loading branch information
AeonLucid committed May 28, 2019
1 parent 710bf86 commit e099036
Show file tree
Hide file tree
Showing 11 changed files with 276 additions and 879 deletions.
797 changes: 103 additions & 694 deletions base/META-INF/com/google/android/update-binary

Large diffs are not rendered by default.

Empty file removed base/common/install.sh
Empty file.
9 changes: 8 additions & 1 deletion base/common/post-fs-data.sh
Original file line number Diff line number Diff line change
@@ -1,2 +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
# More info in the main Magisk thread
9 changes: 8 additions & 1 deletion base/common/service.sh
Original file line number Diff line number Diff line change
@@ -1,3 +1,10 @@
#!/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
# More info in the main Magisk thread
frida-server -D
Empty file removed base/common/uninstall.sh
Empty file.
36 changes: 0 additions & 36 deletions base/common/unityfiles/addon.sh

This file was deleted.

10 changes: 0 additions & 10 deletions base/common/unityfiles/modid.sh

This file was deleted.

47 changes: 0 additions & 47 deletions base/common/unityfiles/modidsysover.sh

This file was deleted.

89 changes: 0 additions & 89 deletions base/config.sh

This file was deleted.

153 changes: 153 additions & 0 deletions base/install.sh
Original file line number Diff line number Diff line change
@@ -0,0 +1,153 @@
##########################################################################################
#
# 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=true

##########################################################################################
# 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 <msg>
# print <msg> to console
# Avoid using 'echo' as it will not display in custom recovery's console
#
# abort <msg>
# print error message <msg> to console and terminate installation
# Avoid using 'exit' as it will skip the termination cleanup steps
#
# set_perm <target> <owner> <group> <permission> [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 <directory> <owner> <group> <dirpermission> <filepermission> [context]
# if [context] is empty, it will default to "u:object_r:system_file:s0"
# for all files in <directory>, it will call:
# set_perm file owner group filepermission context
# for all directories in <directory> (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 " ********************************************"
ui_print " * MagiskFrida by AeonLucid *"
ui_print " ********************************************"
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

# Custom permissions
set_perm $MODPATH/system/xbin/frida-server 0 2000 0755 u:object_r:system_file:s0
}

# You can add more functions to assist your custom script code
5 changes: 4 additions & 1 deletion build.py
Original file line number Diff line number Diff line change
Expand Up @@ -78,6 +78,9 @@ def create_module(platform, frida_release):
# Copy base module into module dir.
shutil.copytree(PATH_BASE_MODULE, module_dir)

# cd into module directory.
os.chdir(module_dir)

# Create module.prop.
create_module_prop(module_dir, frida_release)

Expand All @@ -94,7 +97,7 @@ def create_module(platform, frida_release):
# Create flashable zip.
print("Building Magisk module.")

file_list = ["config.sh", "module.prop"]
file_list = ["install.sh", "module.prop"]

traverse_path_to_list(file_list, "./common")
traverse_path_to_list(file_list, "./system")
Expand Down

0 comments on commit e099036

Please sign in to comment.