[特殊字符] Android AAB 一键安装工具配置指南

一、 环境准备 (核心依赖)

1. Java : 终端输入 java -version 确认已安装。

2. Android SDK : 确保包含 platform-tools（即 adb 命令）。

3. Bundletool : 下载后统一重命名为 bundletool.jar。

4. 目录规范 : 创建 ~/Desktop/android_tools 文件夹，放入 bundletool.jar、signatures.conf 及 .jks。

---

二、 核心脚本 (install_aab.sh)

将代码保存为 install_aab.sh。关键点 ：确保脚本开头有 export PATH 声明，否则右键操作时会找不到 adb。

Bash

#!/bin/zsh
# 补全环境变量
export ANDROID_HOME="${ANDROID_HOME:-$HOME/Library/Android/sdk}"
export PATH="$PATH:$ANDROID_HOME/platform-tools:/usr/local/bin"

TOOL_DIR="$HOME/Desktop/android_tools"
BUNDLETOOL="$TOOL_DIR/bundletool.jar"
CONFIG_FILE="$TOOL_DIR/signatures.conf"

AAB_PATH="$1"
FILENAME=$(basename "$AAB_PATH")

# 自动匹配签名逻辑
MATCH_KEY="${FILENAME%%_*}"
MATCH=$(grep -i "$MATCH_KEY" "$CONFIG_FILE")

if [ -n "$MATCH" ]; then
    IFS=':' read -r KEY KS_PATH ALIAS PASS <<< "$MATCH"
    SIGN_ARGS=(--ks="$TOOL_DIR/$KS_PATH" --ks-key-alias="$ALIAS" --ks-pass="pass:$PASS")
else
    SIGN_ARGS=()
fi

# 执行转换与安装
java -jar "$BUNDLETOOL" build-apks --bundle="$AAB_PATH" --output="$AAB_PATH.apks" --connected-device "${SIGN_ARGS[@]}" --overwrite
java -jar "$BUNDLETOOL" install-apks --apks="$AAB_PATH.apks" --allow-downgrade

# 结果反馈
if [ $? -eq 0 ]; then
    osascript -e "display notification \"项目：$FILENAME 已安装成功\" with title \"📦 AAB 安装器\""
    rm -f "$AAB_PATH.apks"
else
    osascript -e "display notification \"安装失败，请查看桌面日志\" with title \"❌ AAB 安装器\""
fi

---

三、 访达右键菜单集成 (Automator)

这是将脚本变成"右键点击"的关键步骤：

1. 新建 : 打开 Automator -> 快速操作 (Quick Action)。

2. 配置:

   • "工作流程收到当前"选择 文件或文件夹。

   • "位于"选择 访达.app。

3. 添加动作 : 拖入 "运行 Shell 脚本"。

   • Shell : /bin/zsh

   • 传递输入 : 作为自变量 (as arguments)

   • 代码内容:

     Bash

     /Users/你的用户名/Desktop/android_tools/install_aab.sh "$1" > ~/Desktop/aab_debug.txt 2>&1

4. 命名保存 : 保存名称为 "安装 AAB 到手机"。

---

四、 权限与使用步骤 (重点：如何操作)

在新电脑上配置完成后，请按以下顺序操作：

1. 权限激活 (仅需一次)

• 终端执行：chmod +x ~/Desktop/android_tools/install_aab.sh。

• 系统设置 -> 隐私与安全性 -> 完全磁盘访问权限：

  • 勾选 自动操作 (Automator) 、访达 (Finder) 、zsh (/bin/zsh)。

2. 正确的使用姿势 (测试流程)

当你有了打包出的 .aab 文件后，只需两步：

1. 手机连接: 确保安卓手机已连接且开启 USB 调试。

2. 执行安装:

   • 在生成的 .aab 文件上点击 右键。

   • 在菜单中选择 "快速操作" (Quick Actions)。

   • 点击 "安装 AAB 到手机"。

---

五、 预期效果与故障排查

• 成功 : 屏幕右上角滑出通知横幅："项目：xxx 已安装成功"。

失败: 如果没反应或弹出错误警告，请检查：

• aab_debug.txt : 查看桌面这个日志文件，确认是否报 More than one device（连了多台手机）或 Operation not permitted（没给完全磁盘访问权限）。
• signatures.conf: 确认文件名和配置里的关键字是否匹配。