某次 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 框架的舊模塊。

關聯閱讀：

• Magisk Manager 詳解
• Magisk 模塊字體爲什麼這麼好用，因爲它有這些優點！
• 爲 Android 換上任意喜歡的字體，你可以試試這個 Magisk 模塊

> 下載少數派客戶端、關注少數派公衆號，發現更多實用 Android 技巧 :eyes:

相關文章