一日一技 | 让过时失效、无法刷入的 Magisk 模块重现生机

某次 Magisk 版本升级后，就陆续有读者来向我反馈字体模块失效的问题。当然，除了我们这些热衷于换字体的人，其它用户在这次更新后也会遇到模块刷入后没有任何效果的情况。
为什么会出现这样的现象呢？

如果你有自制 Magisk 模块的经验，应该或多或少接触过 Magisk 开发者早前为模块开发者提供的 Magisk 模块安装模板（magisk-module-installer）。在早前的 Magisk 版本中我们用到的大部分模块都基于这个模板进行制作，因此大部分情况下 Magisk Manager 都可以正常安装这些模块。

但 Magisk 在 v20.2 版本更新后对模块结构和安装方式进行了调整，上述模板文件所在的 GitHub 仓库目前已被归档并不再使用。

模块开发者转而需要根据 Magisk 作者 @topjohnwu 提供的开发指南对模块进行重新配置——所以 Magisk 模块的兼容性往往也是与 Magisk 版本紧密关联的，我以往所制作的字体模块后缀大多都写着 1500、1700 之类的字样，所代表其实正是其所对应的 Magisk 版本。

这自然就引出了一个大家可能会遇到的问题：

如果开发者无暇适配最新版模块模板导致模块不可用，我们除了等待开发者更新还有别的办法吗？

其实是有的。动手能力较强、拥有一定代码基础的朋友可以参考上面给出的新版开发指南对旧版模块进行拆包重写，在这个过程中你会发现，相比以往新版模块模板最大的不同在于它调整了不同功能模块的生效机制，在这个过程中，有一份名为 update-binary 的「导航」文件尤为重要。

所以不熟悉开发和代码的一般用户也可以从这个 update-binary 下手更新旧版模块的兼容性，以我的字体模块为例，具体的操作流程如下：

在电脑端使用压缩工具打开旧版的字体模块，注意，以下所有操作流程都建议直接在压缩工具中完成操作，不推荐解压、修改再压缩打包！

在压缩工具展示的目录中定位至 META-INF\com\google\android，你会看到有一个无扩展名的 update-binary 文件。

把这个 update-binary 文件直接拖拽到电脑桌面，然后使用文本/代码编辑器工具进行修改：

打开 Magisk 作者提供的模块安装脚本地址，选择页面中的「Raw」按钮，然后复制新页面中的所有内容
清空桌面上 update-binary 中的所有内容，然后使用上面复制的内容粘贴覆盖，保存退出

新的 update-binary 文本内容如下：

#!/sbin/sh

#################
# Initialization
#################

umask 022

# echo before loading util_functions
ui_print() { echo "$1"; }

require_new_magisk() {
  ui_print "*******************************"
  ui_print " Please install Magisk v20.0+! "
  ui_print "*******************************"
  exit 1
}

#########################
# Load util_functions.sh
#########################

OUTFD=$2
ZIPFILE=$3

mount /data 2>/dev/null

[ -f /data/adb/magisk/util_functions.sh ] || require_new_magisk
. /data/adb/magisk/util_functions.sh
[ $MAGISK_VER_CODE -lt 20000 ] && require_new_magisk

if [ $MAGISK_VER_CODE -ge 20400 ]; then
  # New Magisk have complete installation logic within util_functions.sh
  install_module
  exit 0
fi

#################
# Legacy Support
#################

TMPDIR=/dev/tmp
PERSISTDIR=/sbin/.magisk/mirror/persist

is_legacy_script() {
  unzip -l "$ZIPFILE" install.sh | grep -q install.sh
  return $?
}

print_modname() {
  local authlen len namelen pounds
  namelen=`echo -n $MODNAME | wc -c`
  authlen=$((`echo -n $MODAUTH | wc -c` + 3))
  [ $namelen -gt $authlen ] && len=$namelen || len=$authlen
  len=$((len + 2))
  pounds=$(printf "%${len}s" | tr ' ' '*')
  ui_print "$pounds"
  ui_print " $MODNAME "
  ui_print " by $MODAUTH "
  ui_print "$pounds"
  ui_print "*******************"
  ui_print " Powered by Magisk "
  ui_print "*******************"
}

# Override abort as old scripts have some issues
abort() {
  ui_print "$1"
  $BOOTMODE || recovery_cleanup
  [ -n $MODPATH ] && rm -rf $MODPATH
  rm -rf $TMPDIR
  exit 1
}

rm -rf $TMPDIR 2>/dev/null
mkdir -p $TMPDIR

# Preperation for flashable zips
setup_flashable

# Mount partitions
mount_partitions

# Detect version and architecture
api_level_arch_detect

# Setup busybox and binaries
$BOOTMODE && boot_actions || recovery_actions

##############
# Preparation
##############

# Extract prop file
unzip -o "$ZIPFILE" module.prop -d $TMPDIR >&2
[ ! -f $TMPDIR/module.prop ] && abort "! Unable to extract zip file!"

$BOOTMODE && MODDIRNAME=modules_update || MODDIRNAME=modules
MODULEROOT=$NVBASE/$MODDIRNAME
MODID=`grep_prop id $TMPDIR/module.prop`
MODNAME=`grep_prop name $TMPDIR/module.prop`
MODAUTH=`grep_prop author $TMPDIR/module.prop`
MODPATH=$MODULEROOT/$MODID

# Create mod paths
rm -rf $MODPATH 2>/dev/null
mkdir -p $MODPATH

##########
# Install
##########

if is_legacy_script; then
  unzip -oj "$ZIPFILE" module.prop install.sh uninstall.sh 'common/*' -d $TMPDIR >&2

  # Load install script
  . $TMPDIR/install.sh

  # Callbacks
  print_modname
  on_install

  # Custom uninstaller
  [ -f $TMPDIR/uninstall.sh ] && cp -af $TMPDIR/uninstall.sh $MODPATH/uninstall.sh

  # Skip mount
  $SKIPMOUNT && touch $MODPATH/skip_mount

  # prop file
  $PROPFILE && cp -af $TMPDIR/system.prop $MODPATH/system.prop

  # Module info
  cp -af $TMPDIR/module.prop $MODPATH/module.prop

  # post-fs-data scripts
  $POSTFSDATA && cp -af $TMPDIR/post-fs-data.sh $MODPATH/post-fs-data.sh

  # service scripts
  $LATESTARTSERVICE && cp -af $TMPDIR/service.sh $MODPATH/service.sh

  ui_print "- Setting permissions"
  set_permissions
else
  print_modname

  unzip -o "$ZIPFILE" customize.sh -d $MODPATH >&2

  if ! grep -q '^SKIPUNZIP=1$' $MODPATH/customize.sh 2>/dev/null; then
    ui_print "- Extracting module files"
    unzip -o "$ZIPFILE" -x 'META-INF/*' -d $MODPATH >&2

    # Default permissions
    set_perm_recursive $MODPATH 0 0 0755 0644
  fi

  # Load customization script
  [ -f $MODPATH/customize.sh ] && . $MODPATH/customize.sh
fi

# Handle replace folders
for TARGET in $REPLACE; do
  ui_print "- Replace target: $TARGET"
  mktouch $MODPATH$TARGET/.replace
done

if $BOOTMODE; then
  # Update info for Magisk Manager
  mktouch $NVBASE/modules/$MODID/update
  cp -af $MODPATH/module.prop $NVBASE/modules/$MODID/module.prop
fi

# Copy over custom sepolicy rules
if [ -f $MODPATH/sepolicy.rule -a -e $PERSISTDIR ]; then
  ui_print "- Installing custom sepolicy patch"
  # Remove old recovery logs (which may be filling partition) to make room
  rm -f $PERSISTDIR/cache/recovery/*
  PERSISTMOD=$PERSISTDIR/magisk/$MODID
  mkdir -p $PERSISTMOD
  cp -af $MODPATH/sepolicy.rule $PERSISTMOD/sepolicy.rule || abort "! Insufficient partition size"
fi

# Remove stuffs that don't belong to modules
rm -rf \
$MODPATH/system/placeholder $MODPATH/customize.sh \
$MODPATH/README.md $MODPATH/.git* 2>/dev/null

#############
# Finalizing
#############

cd /
$BOOTMODE || recovery_cleanup
rm -rf $TMPDIR

ui_print "- Done"
exit 0

至此，我们就得到了一份新的 update-binary 文件，把这个文件直接拖拽进入压缩管理器窗口替换旧版模块中对应的原文件，然后保存、关闭压缩管理器即可——一个兼容新版 Magisk，能够正常安装并成功生效的新版模块就制作完成了。

本文看着好像篇幅挺长，但实际操作流程无非就是「复制 > 粘贴 > 拖拽覆盖」，将 update-binary 这个用来给模块安装过程「指路」的文件更新为最新版本。由于 update-binary 通用，除了我的字体模块，这个方法同样也适用于其它不兼容新版 Magisk 框架的旧模块。

关联阅读：

> 下载少数派客户端、关注少数派公众号，发现更多实用 Android 技巧 👀