Archives/FoxMagiskModuleManager
2
0
Fork 0
mirror of https://github.com/Fox2Code/FoxMagiskModuleManager synced 2024-11-10 13:10:25 +00:00
Code Issues Projects Releases Wiki Activity
ab5361a276
FoxMagiskModuleManager/DEVELOPERS.md

5.9 KiB
Raw Blame History

Fox's Magisk Module Manager (Developer documentation)

Note: This doc assume you already read the official Magisk module developer guide

Note: official repo do not accept new modules anymore, submit here instead.

Index:

Special notes

MitM: Certificate pinning is only available since Android 7.0, any issue regarding MitM that can only be performed of Android versions that doesn't support this feature will be ignored.

App hiding: I don't intent on hiding the app, the package names should always be com.fox2code.mmm or starts with com.fox2code.mmm., however I notice the presence of my app is causing issues due to it existing, I may add an hiding feature to the app.

Low quality module filter: Implemented at com.fox2code.mmm.utils.PropUtils.isLowQualityModule, it is a check that verify that the module is declaring the minimum required to allow the app to show your module to the user without hurting his experience.
Filling all basic Magisk properties is often enough to not get filtered out by it.

Properties

In addition to the following required magisk properties

# Magisk supported properties
id=<string>
name=<string>
version=<string>
versionCode=<int>
author=<string>
description=<string>

Note: The Fox's mmm will not show the module if theses values are not filled properly

This the manager support these new optional properties

# Fox's Mmm supported properties
minApi=<int>
maxApi=<int>
minMagisk=<int>
needRamdisk=<boolean>
support=<url>
donate=<url>
config=<package>
changeBoot=<boolean>

Note: All urls must start with https://, or else will be ignored Note²: For minMagisk, XX.Y is parsed as XXY00, so you can just put the Magisk version name.

  • minApi and maxApi tell the manager which is the SDK version range the module support
    (See: Codenames, Tags, and Build Numbers)
  • minMagisk tell the manager which is the minimum Magisk version required for the module (Often for magisk xx.y the version code is xxyzz, zz being non 00 on canary builds)
  • needRamdisk tell the manager the module need boot ramdisk to be installed
  • support support link to direct users when they need support for you modules
  • donate donate link to direct users to where they can financially support your project
  • config package name of the application that configure your module (Note: The icon won't appear in the module list if the module or target app is not installed)
  • changeBoot tell the manager the module may change the boot image

Note: Fox's Mmm use fallback here for some modules
Theses values are only used if not defined in the module.prop files
So the original module maker can still override them

Installer commands

The Fox's Mmm also allow better control over it's installer interface

Fox's Mmm define the variable MMM_EXT_SUPPORT to expose it's extensions support

All the commands start with it #!, by default the manager process command as log output unless #!useExt is sent to indicate that the app is ready to use commands

Commands:

  • useExt: Tell the manager you would like to use commands
    (Note: Any command executed before this one will just appear as log in the console)
  • addLine <arg>: Add line to the terminal, this commands can be useful if you want to display text that start with #! inside the terminal
  • setLastLine <arg>: Set the last line of text displayed in the terminal
    (Note: If the terminal is empty it will just add a new line)
  • clearTerminal: Clear the terminal of any text, making it empty
  • scrollUp: Scroll up at the top of the terminal
  • scrollDown: Scroll down at the bottom of the terminal
  • showLoading <max>: Show a progress bar with <max> as max value (Note: Status bar is indeterminate if nothing or 0 is provided)
  • setLoading <progress>: Set loading progress if the bar is not indeterminate.
  • hideLoading: Hide the indeterminate progress bar if previously shown
  • setSupportLink <url>: Set support link to show when the install finish
    (Note: Modules installed from repo will not show the config button if a link is set)

Variables:

  • MMM_EXT_SUPPORT declared if extensions are supported
  • MMM_USER_LANGUAGE the current user selected language
  • MMM_APP_VERSION display version of the app (Ex: x.y.z)
  • MMM_TEXT_WRAP is set to 1 if text wrapping is enabled

Note: The current behavior with unknown command is to ignore them, I may add or remove commands/variables in the future depending of how they are used

A wrapper script to use theses commands could be

if [ -n "$MMM_EXT_SUPPORT" ]; then
  ui_print "#!useExt"
  mmm_exec() { 
    ui_print "$(echo "#!$@")"
  }
else
  mmm_exec() { true; }
fi

And there is an instance of it in use

# mmm_exec only take effect if inside the loader
mmm_exec showLoading
ui_print "The installer doesn't support mmm_exec"
mmm_exec setLastLine "The installer support mmm_exec"
# Wait to simulate the module doing something
sleep 5
mmm_exec hideLoading
mmm_exec setSupportLink https://github.com/Fox2Code/FoxMagiskModuleManager

You may look at the example module code or download the module zip and try it yourself

Have fun with the API making the user install experience a unique experience

Also there is the source of the app icon here .