1.3.1 二进制(可执行)分发来源

App Manager 通过以下渠道发布。 非官方来源可能分发 App Manager 的修改版本，使用这样版本的后果由你自己单独承担。

1. F-Droid ¹
   Link: https://f-droid.org/packages/io.github.muntashirakon.AppManager

2. GitHub repository.
   Normal releases: https://github.com/MuntashirAkon/AppManager/releases
   Debug releases: https://github.com/MuntashirAkon/AppManager/actions

3. Telegram.
   Normal releases: https://t.me/AppManagerChannel
   Debug releases: https://t.me/AppManagerDebug

1.3.2 源码链接

除了GitHub外其他都是镜像链接。tags 应当始终是最新的，但 master 分支也许不是。 如果计划克隆 master 分支，请使用 GitHub 链接而不是其他链接。

1. GitHub: https://github.com/MuntashirAkon/AppManager

2. GitLab: https://gitlab.com/muntashir/AppManager

3. Codeberg: https://codeberg.org/muntashir/AppManager

4. Riseup: https://0xacab.org/muntashir/AppManager

1.3.3 翻译

App Manager 不接受通过 pull/merge 请求进行的翻译。 翻译通过 Hosted Weblate 管理。 要翻译App Manager，请访问 https://hosted.weblate.org/engage/app-manager/。开始前请阅读 信息 部分。

1.4.1 构建说明

在位于源码根目录下的BUILDING文件中可以获得编译教程。

1.4.2 提交补丁

除GitHub之外的仓库目前被视为镜像，在这些网站提交的 PR/MR 将不被接受. ² 相反，patches (.patch 文件) 可以通过电子邮件附件提交。请务必对Commits签名(Signing-off) 更多信息请参见位于源码根目录下的CONTRIBUTING文件.

2.1.1 批处理

批处理或者多应用处理也可以在这个页面内进行。 多选模式可以由点击任何应用图标或长按列表中的任意一项进入。 进入多选模式后，仅需单击列表中的任意一项便可选中，而不是打开应用程序详情页。 该模式下，批处理操作位于页面底部的多选菜单。操作包括：

• 将选中应用添加到 配置

• 备份、恢复或删除应用程序

• 阻止应用中的追踪器

• 清除应用数据或缓存

• 导出App Manager中的屏蔽规则

• 以MarkDown，CSV，JSON或XML格式导出应用列表

• 启用/停用/强制停止/卸载应用程序

• 对应用执行运行时优化 (Android 7 及更高版本)

• 阻止应用的后台操作 (Android 7 及更高版本)

• 导出APK文件到 AppManager/apks

• 设置联网规则

2.1.2 颜色代码含义

• 红色 (日间模式下) / 深红色 (夜间模式下) –已卸载的应用程序

• 浅红色 (日间模式下) / 暗红色 (夜间模式下) – 已停用的应用程序

• 暗青色 – 已强行停止的应用程序

• 黄色星标 – 可调试的应用程序

• 橙色 日期 – 可读取日志的应用程序

• 橙色 UID – UID在多个应用程序中被共享

• 橙色 SDK – 使用明文网络通信(即 HTTP)

• 亮橙色 包名 – 有一个或多个跟踪器的应用程序

• 红色 应用标签 – 不允许清空数据的应用程序

• 暗青色 版本 – 未运行的应用程序

• 紫红色 – 常驻应用(即一直运行的应用程序)

• 红色 备份标识 – 已卸载的应用程序存在一个或多个备份 在App Manager中

• 橙色 备份标识 – 存在的备份已过期， 即基本备份中包含已安装应用程序的旧版本

• 暗青色 备份标识 – 存在的备份已更新， 即基本备份中包含已安装应用程序的相同版本或更高版本

2.1.3 应用类型

一个应用程序可以是 用户 或 系统 应用，同时存在以下后缀:

• X – 支持多种架构

• 0 – 应用程序中不存在dex文件

• ° – 已暂停的应用程序

• # – 应用程序请求系统分配一个大堆，即大运行时内存

• ? – 应用程序请求虚拟机处于安全模式。

2.1.4 版本信息

版本名称有以下前缀:

• _ – 无硬件加速（减缓应用程序中的过渡动画或透明效果）

• ~ – 仅用于测试的应用程序

• debug – 可调试的应用程序

2.1.5 选项菜单

选项菜单提供了若干个选项，以用于对列出的应用程序进行排序和过滤， 以及转到 App Manager 内或外的不同页面。

2.2.1 颜色代码含义

本页中使用的颜色列表，以及对应的含义:

• 红色 (日间模式) / 深红色 (夜间模式) – 表示任何应用操作(App ops)或权限存在危险的标志(flag)，或者任何组件在 App Manager 中被阻止， 又或者是任何需要却又不受支持的功能特性。

• 亮红色 (日间模式) / 暗红色 (夜间模式) – 表示组件在 App Manager 外被禁用，或任何不受支持的 可选功能特性。

  注意.

  标记为禁用（停用/阻止）的组件并不意味着它被用户禁用，它也可能被系统禁用， 或者在其清单(Android-Manifest.xml)中被标记为禁用（停用/阻止）。 被禁用（停用/阻止）的应用程序也会被系统（和App Manager）视为禁用（停用/阻止）。

• 鲜橙色 (日间模式) / 暗橙色 (夜间模式) – 表示存在跟踪器组件

• 紫色 (日间模式) / 深紫色 (夜间模式) – 表示存在正在运行的服务。

• 绿色 – 表示当前应用程序中的所有跟踪器 已在 跟踪器指示器 标签页内被阻止。

2.2.2 应用信息

应用信息 选项卡包含关于一个应用程序的基本信息, 许多操作可以在此标签中执行.

2.2.3 组件选项卡

活动(Activities)、服务(Services)、接收器 (即广播接收器) 和 提供者 (例如内容提供者) 统称为应用程序组件， 因为它们提供类似的功能并共享类似的属性， 例如它们都有一个 名称、 标签、 图标、 可被启用或禁用、并且通过 意图(Intent) 执行。 应用程序组件是应用的组成部分， 必须在应用程序清单中声明 (也有一些例外情况)。 应用程序清单是存储应用程序特定元数据的文件，Android 通过读取元数据来处理应用。

这些选项卡中使用的颜色在 §2.2.1应用详情颜色代码 中进行了解释。 也可以通过位于三点菜单的 排序 选项，对组件列表进行排序， 以在列表顶部显示已阻止组件或者跟踪器组件。

2.2.4 权限选项卡

App Ops, 使用权限 and 权限 选项卡与权限相关。 安卓中，在不具有相同身份（称为 shared ID）的应用或进程之间进行通信常常需要权限，其由权限控制器管理。 一些被视为普通 的权限，若它们出现在应用程序清单中，则会自动授予，但危险权限 和 开发 权限需要用户确认。 选项卡中使用的颜色在 §[subsec:app-details-color-codes] 中有解释。

2.2.5 签名选项卡

签名 实际上被称作签名信息。 一个应用程序在发布前，会被开发者用一个或多个签名密钥对该应用程序进行签名。 一个应用程序的完整性，即该应用程序是否来自实际开发者且未被其他人改动， 可通过使用内置在 APK 文件中的签名证书进行校验。 这是因为当一个应用程序被未经授权的实体改动时，由于签名密钥对该实体而言是未知的， 该应用程序就已经无法使用源签名密钥进行签名了。 一种验证应用程序完整性的方式就是验证证书生成的检验和 (checksums)。 若开发者提供签名证书的检验和，则它们可以 通过 签名 标签页生成的检验和进行比较的方式校验该应用程序。 举个例子，如果你从 GitHub 或 Telegram 频道中下载了 App Manager， 你可以通过简单匹配 SHA256 检验和与显示在此标签的这一个作比较， 以验证该应用程序是否真是由我发布：

320c0c0fe8cef873f2b554cb88c837f1512589dcced50c5b25c43c04596760ab

在此标签页中，使用了几种哈希算法以生成校验和， 包括 MD5 、 SHA1 、 SHA256 和 SHA512。

2.2.6 使用特性选项卡

使用功能 该标签页列出了由该应用程序声称的功能列表，比如 OpenGL ES、电话和 leanback。 应用程序可能需要某些功能，而有些功能对应用程序而言则是可选的。 所需功能必须与所需版本一起存在于系统中。 否则，任何安装应用程序的尝试会被系统拒绝。 用于此标签的颜色在 §2.2.1 有详细解释。

2.2.7 配置选项卡

配置 标签页列出了应用程序需要的配置， 比如输入法类型 (qwerty、12键)，触屏方式 (手指、触摸笔等等)，以及导航方式 (拨号盘、跟踪球、滚轮) 对绝大多数应用程序而言，该标签页将会是空页面。

2.2.8 共享库选项卡

共享库 该标签页列出了传统 JAR 依赖、 任意静态共享库依赖 (目前唯一一个已知的实例是基于Chromium的浏览器和WebViews ) 以及 JNI (Java 本地接口) 库。对于JNI 库，有明确规定特定的平台 (x86/x86_64/ARM/AArch64)、 架构 (32/64 bit)、对象 (共享对象或可执行代码) 等。

2.3.1 阻止/取消阻止跟踪器

该选项可被用于阻止或解除阻止已安装应用程序的广告/跟踪器组件。 选择此项时，App Manager 会询问是否需要列出所有应用程序的跟踪器，或者仅列出用户应用程序的跟踪器。 新手用户应避免阻止系统应用程序的跟踪器以避免产生不良后果。 之后会弹出多选对话框，以将排除一个或多个应用程序从该操作中排除。 当按下 阻止 或 解除阻止 按钮时，这些变更会立刻生效。

2.3.2 阻止组件…

该选项用于阻止某些应用程序的组件，而判断依据是它们的签名。 一个组件的签名是组件的全称或部分名称。 安全起见，推荐在每一部分的签名结尾添加 . (点)， 因为底层算法以贪婪的方式搜索和匹配组件。 也可以插入多个签名，在这种情况下，所有签名都要被空格隔开。 类似于上面的选项，此处也会提供对系统应用程序应用阻止的选项。

2.3.3 设置 App Ops 模式 …

该选项用于对所有或者已选中的应用程序配置某些 应用操作 (App Ops)。 存在两个字段，第一个字段用于插入多个被空格隔开的应用操作常量 (名称或值)。 由于可用的应用操作因设备和操作系统而异，并非所有的应用操作常量都能被事先了解。. 需要的应用操作常量可在位于 应用详情页 中的 App Ops 标签页内查阅。 第二个字段可用于插入或根据特定的应用操作选择 模式。

2.3.4 备份

一键备份操作。以防万一，在执行任何操作前会列出所有受影响的备份。

2.3.5 恢复

一键还原。以防万一，在执行任何操作前会列出所有受影响的备份。

2.3.6 清理所有应用的缓存

清除所有应用程序的缓存，包括 Android 系统。在执行此操作期间， 所有正在运行的应用程序的缓存可能不会如预期般被清除。

2.4.1 选项菜单

通过 App Manager 顶部右上角的三点菜单打开全局选项菜单。 其中有一个选项，用于导入先前从 App Manager 导出的已有配置文件。

长按任意配置文件项目会弹出另一个选项菜单。该选项菜单提供以下选项：

• 立即应用…. 该选项用于直接应用配置文件。 点击时会显示一个对话框，在对话框内可选择 配置文件状态。 选择其中一个状态后，配置文件会被立即应用。

• 删除 点击该选项会在无警告的情况下直接移除配置文件。

• 复制 该选项用于复制配置文件。 点击时会显示一个对话框，在对话框内可为新的配置文件命名。 单击“OK”后，会复制当前配置文件的所有配置信息并加载到 新的 配置文件页面 。 尽管如此，复制的配置文件在手动保存之前都不会被保存。

• 复制配置文件ID 该选项用于复制配置文件的唯一配置ID。 该配置ID可用于 从第三方应用程序 触发配置文件 。

• 导出 导出配置文件到外部存储。 通过该方式导出的配置文件可以通过之前提到的 导入 选项导入。

• 创建快捷方式 该选项用于 创建该配置文件的快捷方式。 该功能提供两个选项： 简单 和 高级 。 选择 高级 时，会提示用户选择快捷方式被调用时的配置文件状态。 选择 简单 时，则总是使用配置文件上一次保存时设置的默认状态。

2.5.1 选项菜单

顶部右上角的三点菜单会打开选项菜单。其中包含若干个选项，例如–

• 应用 该选项用于直接应用配置文件。 点击时，会显示一个可以选择 配置文件状态 的对话框。 在选择其中一个状态后，配置文件会立即生效。

  注意.

  当你应用配置文件时，如果存在某些不符合标准的应用，它们会被直接忽略。

• 保存 保存对配置文件的更改。

• 丢弃 丢弃自上次保存后产生的全部更改。

• 删除 点击此选项将将在无警告的情况下直接移除配置文件。

• 复制 该选项用于复制配置文件。 点击时会显示一个对话框，在对话框内可为新的配置文件命名。 单击“OK”后，会复制当前配置文件存储的配置信息 并加载到新的 配置文件页面 。 尽管如此，复制的配置文件在手动保存之前都不会被保存。

• 创建快捷方式 该选项用于创建该配置文件的快捷方式。 该功能提供两个选项： 简单 和 高级 。 选择 高级 进行配置时，会提示用户选择快捷方式被调用时的配置文件状态。 选择 简单 进行配置时，则总是使用上一次保存的配置文件设置的默认状态。

2.5.2 应用程序选项卡

应用标签页会列出所有为该配置文件配置的包。 包可以通过位于屏幕底部附近的 添加 按钮添加或移除。 一个包可以通过长按该按钮的方式移除 (以防万一，会弹出一个仅显示 删除 选项的对话框)。

2.5.3 配置选项卡

配置标签可用于配置选中的包。

2.6.1 界面语言

配置应用内语言。App Manager 目前支持 22 种语言。

2.6.2 外观

2.6.3 隐私

2.6.4 操作模式

操作模式定义了 App Manager 整体的工作模式，其有以下选项：

• 自动 让 App Manager 决定最佳选项。 尽管这是默认选项，对于无 Root 用户而言应该使用 无 Root 模式。

• Root 以 Root 模式运行 App Manager。若未检测到 Root 权限，App Manager 会回退至 无 Root 模式。在极少数个例中，当通过 Root 发起的 Binder 通信被禁用时 (例如 Phh SuperUser)，App Manager 也会回退至 无 Root 模式。

• TCP 启动 ADB 通过 TCP 启动 ADB 的方式，在 ADB 模式下运行 App Manager。 若未通过 TCP 启动 ADB ，App Manager 会回退至 无 Root 模式。

• 无线调试 通过无线调试启用 ADB 。首先会自动尝试连接之前配置的端口， 如失败会提示用户手动配对，或者手动连接到 ADB daemon。 若通过该方式无法成功连接到 ADB daemon，App Manager会回退至 无 Root 模式。

  信息.

  由于无线调试在 Android 11 才被引入，该选项仅在运行 Android 11 及更高版本的设备上显示。

• 无 Root 以无 Root 模式运行 App Manager。虽然 App Manager 在此模式中表现更佳， 但所有 Root 或 ADB 相关的功能会被禁用。

也会在顶部显示实际操作模式。 实际操作模式是指 Root、ADB 和 无 Root 。

2.6.5 APK 签名

2.6.6 安装器

配置安装器的默认行为。在应用程序安装时， 你也可以通过点击 齿轮 图标并找到绝大多数设置。

2.6.7 备份/恢复

与 备份恢复 相关的设置.

2.6.8 规则

2.6.9 高级

2.6.10 关于设备

显示 Android 版本、安全、CPU、GPU、电池、内存、屏幕、语言、用户信息等。

2.8.1 意图(Intent)过滤器

应用程序使用意图过滤器来指定它们能够执行的任务或者它们将使用其他应用程序执行的任务。 举个例子，当你使用文件管理器打开一个 PDF 文件时，文件管理器会尝试寻找能够打开 PDF 的应用程序。 为了找到正确的应用程序，文件管理器会创建一个带有MIME类型等过滤器的意图 (Intent)，并要求系统检索能够打开该过滤器的应用程序。 系统会通过检索已安装应用程序的清单 (Manifest)匹配过滤器，并列出能够打开该过滤器 (该例子中是PDF)的应用程序组件。 此时，文件管理器将自行打开所需的应用程序组件或者使用系统提供的选项打开它。 若多个应用程序组件能打开它并且没有设置默认的打开方式，则你可能会看到一个选择正确的应用程序组件打开的提示。

http://search.disroot.org/?q=URI%20in%20Android%20scheme&categories=general&language=en-US
https://developer.android.com/reference/android/net/Uri
file:///sdcard/AppManager.apk
mailto:email@example.com
content://io.github.muntashirakon.AppManager.provider/23485af89b08d87e898a90c7e/AppManager.apk

2.8.2 匹配的活动(Activity)

列出匹配意图的所有活动组件。这是由系统内部决定的 (而不是 App Manager) 。 每个组件旁边的启动按钮可用于从 App Manager 直接启动它们。

2.8.3 重置为默认

重置意图至其初始化状态。

2.8.4 发送编辑过的意图(Intent)

将编辑过的意图重新发送到目标应用程序。这可能会打开需要选择所需应用程序的应用程序列表。 从目标应用程序接收的结果会被发送到源应用程序。因此，源应用程序将不会知道是否存在中间人。

3.1.1 启用开发者选项

3.1.2 启用USB调试

在 定位开发者选项 后， 启用 开发者选项 (如果尚未启用)。然后一点点往下划， 直到你看见 USB 调试 选项。点击右侧的切换按钮启用它。 此时你可能会看见一个需要点击 OK 按钮才能实际启用 USB 调试的警示信息。 基于设备供应商和ROM，你可能还需要启用一些其他的选项。以下是一些例子：

3.1.3 在PC或Mac上配置ADB

为了使用通过 TCP 启动 ADB 功能，你需要在你的 PC 或 Mac 设备上安装并设置 ADB。 Lineage OS 用户可参考 §3.1.4.1。

 winget install --id Google.PlatformTools

brew install --cask android-platform-tools

3.1.4 配置经由TCP的ADB

3.2.1 启用开发者选项和 USB 调试

参阅 §3.1.1启用开发者选项 和 §3.1.2启用 USB 调试。

3.2.2 启用无线调试

在 开发者选项 页面，找到 无线调试 并单击以打开它。 在新打开的页面中，打开 使用无线调试 。取决于你的操作系统，你可能会看到一个提示对话框，要求你验证你的决定。 若遇到此情况，请单击 允许 。

3.2.3 用 App Manager 匹配 ADB

在 App Manager 中，转到 设置 > 操作模式 ，接着开启 无线调试。启用后，App Manager 会试着自动建立 无线调试连接，如果先前未配对，那么该尝试会失败。尝试失败后， 应用会请你连接或配对 ADB。选择配对 会出现新的对话框。 对话框会让你转到 无线调试 页面。

在无线调试 页面， 选择 用配对码配对设备. 之后会展示 一个包含配对码的对话框。一个请求配对码的通知也会几乎立马变得可见。 将配对码输入通知中的输入框， 单击 配对。如配对成功，App Manager 会显示 “已配对” 的消息通知， 无线调试 页中的对话框将被自动 忽略。你也可以在相同页面中看到 App Manager 被列为 ADB 客户端。

3.2.4 连接 App Manager 到 ADB

若运行模式设置为 自动, 通过 TCP 启动的 ADB 或 无线调试， App Manager 应该能够自动连接到 ADB。 若并非如此，则在设置 > 操作模式 中选择 无线调试 。 若 App Manager 无法检测或连接到 ADB ， 则会显示一个提示对话框以用于连接或配对 ADB 。 选择 连接 。

现在，从 Android 设置中转到 无线调试 页面，记下页面显示的端口号。 在 App Manager 的提示对话框中， 用你记下的端口号替换当前端口号，然后点击 连接 。

一旦成功建立连接，你就能够禁用 Android 设置的 无线调试。

3.3.1 位置

备份/还原是 批处理操作 的一部分。 它也位于 应用信息标签页 的 选项菜单 中。 Clicking on Backup/Restore opens the Backup Options. 默认情况下，备份存放在 /storage/emulated/0/AppManager 。 你可以在 设置页面 配置自定义的备份位置。 无论如何配置，备份都会存放在所选卷的 AppManager 文件夹。

3.3.2 备份选项

你可以通过备份选项 (内部称为备份标志) 自定义云端备份。 然而，在将来的备份中不会记得这些自定义设置。 如果你想定制此对话框，在 设置页面 中使用 备份选项。

下面给出了备份选项的完整描述：

• APK 文件 是否备份 APK 文件。 这包括 Base APK 文件以及 APK 分包 文件 (如果有)。

• 内部数据 是否备份内部数据目录。 这些目录位于 /data/user/<用户ID> 以及 (对 Android 7 及更高版本) /data/user_de/<用户ID>.

• 外部数据 是否备份位于内部存储和SD 卡 (如果有) 的数据目录。 外部数据目录通常包括非必要的应用数据或媒体文件 (而不是使用专用的媒体文件夹)，若选择备份则可能增加备份文件的大小。 然而，对一些应用来说可能是有必要的。 尽管默认情况下不会选中该项 (因为它可能会显著增加备份文件的大小)，你可能需要检查此项以确保能够顺利还原你的备份。

  小心.

  若你要备份外部数据文件夹，则应该总是备份内部数据文件夹。 然而，如果所讨论的应用会从网络下载大量资源，那么仅备份外部文件夹也会很有用。

• OBB 和媒体 是否备份或还原 OBB 和位于 外部存储或 SD 卡的媒体。 这对实际使用这些文件夹的游戏和图形软件而言很有用。

• 缓存 Android 应用在每个数据目录 (内部和外部) 中都有多个缓存目录。 有两种类型的缓存： 缓存 (Cache) 和 代码缓存 (Code Cache)。 禁用此选项会将这两个缓存目录从所有数据目录中排除。 一般情况下建议排除缓存目录，因为大多数应用程序并不会定期清除缓存，缓存通常是由操作系统自身处理。 像 Telegram 之类的应用可能会使用非常大的缓存(由存储空间决定)，这显著增加了备份文件大小。 当该项被禁用时，App Manager 也会忽略 no_backup (无备份)目录。

• 额外信息 备份/还原应用权限、网络规则、电池优化、SSAID，等等，默认启用。 注意：阻止规则在还原应用的额外信息 后 应用。 所以，如果某个条目在两个地方(阻止规则和额外信息备份)同时存在，那么它将会被覆盖。(即会使用源自阻止规则的条目)。

• 规则 你可以通过该选项备份在 App Manager 内配置的阻止规则。 若你通过 App Manager 配置了权限或阻止了一些组件，则当你启用该选项时， 这些规则也会被备份或还原。

• 多重备份 这是否为多重备份。 默认情况下，备份使用其用户 ID 保存。 启用该选项将允许你创建多个备份。 这些备份使用当前的时间日期作为默认备份名称，但你也可以指定自定义备份名称。 当你点击 备份 按钮时，使用输入框以自定义备份名称。

• 自定义用户 为所选的用户进行备份或还原，而不仅仅是当前用户。 该选项仅在系统有多个用户的情况下显示。

• 跳过签名检查 当进行备份时，会生成每个文件的检验和 (以及基础 APK 文件的签名证书) 并保存在 checksums.txt 文件中。 当你还原备份时，会再度生成检验和，并用于匹配保存在先前提及的文件内的检验和。 启用此选项以禁用签名检查。 该选项仅在你恢复备份时被应用 (即启用该选项仅禁用恢复时的签名检查)。 无论此处如何设置，备份时始终会生成用于签名检查的检验和。

  小心.

  你应该总是禁用此选项，以确保你的备份不被任何第三方应用程序修改。 然而仅在你启用了加密才起作用。

3.3.3 备份

备份功能会遵守除了 跳过签名检查 以外的所有备份选项。 若基本备份 (即并未选择多重备份 选项) 已存在，由于备份会被覆盖，你会看到一条警告信息。 若设置了 多重备份 ，你需要在选项中输入(指定)备份名称，或者你也可以留空以使用当前日期时间作为备份名称。

3.3.4 恢复

还原会遵守全部备份选项，并在出现以下情况时失败：若设置了 APK 文件 选项， 备份内容却不包括 APK 文件选项设定的内容，或者其他情况下，未安装该应用程序。 当为多个应用还原备份时，你只能选择还原基础备份 (参阅 备份 章节以了解更多)。 然而，当为单个应用程序还原备份时，你需要通过选项选择还原哪个备份。 若设定了 所有用户 选项，则 App Manager 将在后一种情况为所有用户还原所选备份。但是在前一种情况中，将会为各个用户还原基础备份。

3.3.5 删除备份

删除备份仅遵守 所有用户 选项。当被选中时，仅会提示后删除所有用户的基础备份。 当为单个应用删除备份时，会显示另外一个可供你选择要删除的备份的对话框。

3.4.1 生成授权密钥

为了确保适当的安全性，需要授权密钥。前往 设置 页面，接着是 隐私 > 授权管理器 以生成授权密钥。 若并未生成过授权密钥，则会自动生成。该密钥可根据需求重新生成。

3.4.2 配置任务

活动 io.github.muntashirakon.AppManager.crypto.auth.AuthFeatureDemultiplexer 负责处理所有的自动化意图。 发送意图到该活动，让 App Manager 通过重定向 意图 到指定活动或服务的方式执行指定操作。

3.4.3 功能特性

目前 App Manager 支持的一个功能，即 配置文件。

3.4.4 触发配置文件

为了触发配置文件， feature (功能) 字段必须具有 profile (配置文件) 值。 此外，接下来的 extras (额外选项) 可包括：

1. prof. (字符串值 – 必须) 显示在 配置页面 的配置名称。

2. state. (字符串值 – 可选) 配置文件的状态 – 目前 on (启用) 或者 off (禁用) – 如文档所述。. 若此时未设置额外选项，则 App Manager 会提示需要选择的状态。 因此，为了完全自动化，应该设置该选项。

4.1.1 什么是应用组件？

活动、服务、广播接收器 (或者仅接收器) 和内容提供者 (或仅提供者) 统称为应用程序组件。 技术上来说，它们都继承了 ComponentInfo 类 并可以通过意图被启动。

4.1.2 追踪器和其他组件在App Manager中是如何被禁用的？其局限性是什么？

App Manager 通常使用一个称作 Intent Firewall (IFW)，意图防火墙 的方法阻止应用程序组件 (或跟踪器组件)， 它比其他诸如 pm (PackageManager，包管理器)、 Shizuku 或其他任何使用包管理器启用或禁用组件的办法更优秀。 若组件被后者的办法禁用，应用程序自身可以检测到组件被阻止并能重新启用，因为应用程序有自身组件的完整访问权限。 (许多欺骗性应用程序这样做，实际上是为了让跟踪器组件保持不被阻止的状态。) 另一方面，意图防火墙 (IFW) 是一个真正的防火墙，应用程序无法检测自身组件是否被阻止。 这也是 App Manager 使用术语 阻止 而非 禁用 的原因。

就算是意图防火墙也有一些局限性，主要适用于系统应用程序：

• 相关应用程序被系统加入白名单。 即没有这些应用程序，系统将无法正常运行，并可能导致随机崩溃。 这些应用程序包括但不限于 Android 系统、系统界面、电话服务。 即使禁用或阻止，它们仍然会运行。

• 另外一部分系统应用程序或系统进程通过进程间通信 (Interprocess Communication，IPC) 激活了被加入白名单的系统应用程序的应用程序组件。 此情况下组件会被激活，并无视组件的阻止状态甚至是整个应用程序被禁用。 若有不需要的系统应用程序，阻止其运行的唯一办法就是摆脱 (卸载/移除)它。

4.1.3 被其他工具禁用的应用程序组件是否保留在App Manager中？

不。 但是被系统或任何其他工具阻止的应用程序组件会在组件标签页 显示。 这些规则可从 设置 导入。 然而，App Manager 无法区分组件是被第三方工具阻止还是被系统阻止。 因此，在导入页面中显示的应用程序列表应谨慎选择。

4.1.4 现在被 App Manager 拦截但先前被其他工具禁用的组件会发生什么？

如果请求，App Manager 会再次阻止组件。 解除阻止的情况下，它们将恢复到应用程序清单中指定的默认状态。 但是如果组件是被 MyAndroidTools (MAT) 使用意图防火墙 (IFW) 阻止， 由于 MAT 使用不同的格式，它们不会被 App Manager 解除阻止。 为了修复这个问题，首先需要从 设置 导入规则 这种情况下，MAT 的配置文件会被永久移除。

4.1.5 什么是即时组件禁用？

当你在 应用详情页 中阻止组件时，默认情况下阻止规则不会立刻生效。 仅在你使用顶部右侧菜单的 应用规则 选项时，阻止规则才会生效。 若你启用 即时阻止组件 选项，则当你阻止组件时，阻止规则会立刻生效。 若你选择阻止跟踪器组件，阻止规则会自动生效，该选项设置会被忽略。 你也可以通过在应用详情页内同一菜单简单点击 移除规则 为该应用程序移除阻止规则。 由于默认行为使你更好地控制应用程序，保持选项 即时阻止组件 选项为禁用状态更好。

4.1.6 跟踪器类与跟踪器组件

所有应用程序组件都是类，但并非所有类都是组件。事实上，只有少数类是组件。 话虽如此， 扫描页面 展示的是跟踪器列表以及类的数量，而并非只是组件数。 在所有其他页面，跟踪器和跟踪器组件是同一个意思，都用于表示跟踪器。 即：阻止 tracker 是指阻止跟踪器组件，而不是跟踪器类。

4.2.1 我必须在每次重启后启用ADB over TCP吗？

很不幸的是，是的。这是因为响应 ADB 连接的 ADB daemon (ADB 守护进程) 也会在重新启动后重新开始。 而这并不会重新启用通过 TCP运行的 ADB。

4.2.2 无法启用 USB 调试，怎么办？

参阅位于 Chapter 3指引 的 §3.1.2启用 USB 调试 。

4.2.3 我可以使用 ADB over TCP 来禁用跟踪器或任何其他应用程序组件吗？

ADB 具有数量限制 权限 而并非它们其中一个控制应用程序组件。 然而，仅用于测试 的应用程序的组件可以通过 ADB进行控制。 若 App Manager 检测到此类应用程序，则会自动启用阻止选项。

4.2.4 哪些功能可以在ADB模式下使用？

在 ADB 模式下，受支持的功能会自动启用。 受支持的功能包括禁用、强制停止、清除应用程序数据、授予或撤销应用操作 (App Ops) 和权限等。 也可在无系统提示的情况下安装或卸载应用程序。

4.3.1 我不使用root/ADB，是否完全安全？

是的，App Manager 不能在无 Root 或 ADB时修改任何系统设置。

4.3.2 跟踪器和库是如何更新的？

在新版本发布前，会手动更新跟踪器和库。

4.3.3 APK 安装后是否被删除？

不会，在安装后，APK 不会被 App Manager 删除。

4.3.4 对于 Shizuku 有何计划？

现在 App Manager 使用隐藏 API 和执行特权代码变得更加复杂， 无法和 Shizuku 之类的其他第三方应用程序集成。 不考虑在 App Manager 中集成 Shizuku (现在具有 Apache 2.0 协议) 的理由如下：

1. 最初 Shizuku 是不自由软件，这也导致我 在 App Manager 中使用了类似的方法来支持 Root 和 ADB。

2. App Manager 已经支持 Root 和 ADB，并且在某些情况下比 Shizuku 更优秀。

3. 主要功能依赖于第三方应用并不是一个好的设计理念选择。

4. 集成 Shizuku 会增加 App Manager 的复杂性。

4.3.5 什么是预装(bloatware)软件以及如何删除？

臃肿软件（Bloatware）为不必要的预装应用，通常是系统应用。 一些臃肿软件通常用来跟踪用户并收集它们可能为了获利而出售的用户数据。 许多系统应用无需请求任何权限便可访问设备信息、联系人和消息数据，以及其他使用信息， 比如手机使用习惯和存储在共享存储空间中的一切。

臃肿软件同样包括 Google 地图、Meta 出品的应用，以及Twitter/X， 这些应用也可以在没有用户同意情况下跟踪和/或收集用户数据。 你可以在 Andeoid 系统设置那里禁用这些应用的一些权限， 但请知晓，系统设置藏有很多权限被安全研究者认为具潜在危险性 （比如联网、传感器等）。

如果臃肿软件是用户应用，可以轻易从系统设置或AM进行卸载。 而属于系统应用的臃肿应用没有特权是不可能卸载的。 即使有特权也无法完全卸载 这样的系统应用， 因为它们位于 system 分区，这是一个只读分区。 如果你有 root 权限，你可以重新挂载这个分区来手动 清除 这些应用，但这样做会破化系统的 OTA 更新， 因为系统分区中的数据已经被修改。 有两种更新，一种是 delta 更新（仅由两个系统版本间的差异构成，下载东西少）和完整更新。 你仍能使用完整更新，但更新后臃肿软件又会出现，你不得不再次彻底清理它们。

另一个解决方案是通过系统设置或 AM 停用这些应用， 但某些服务仍能在后台运行， 因为它们可以被其他系统应用使用进程间通信（IPC）方式启动。 一个可能的解决方案是停用所有臃肿软件，直到服务最终停止（在重启后）。 不过，由于厂商对 ANdroid 框架所做的巨大改动， 删除或停用某些臃肿软件可能导致系统 UI 崩溃甚至造成启动循环。 从 v4.0.0 版本起，AM 有了一个新功能，叫做 Debloater， 可以用作从专有权利的 Android 操作系统中监控、停用，及删除臃肿软件的基础。

5.1.1 背景介绍

App Manager 目前支持阻止活动、广播接收器、内容提供者、服务、应用操作 (App Ops) 和权限， 并且在将来可能会添加更多阻止选项。 为了增加更多便携性，导入/导出所有的这些数据是有必要的。

由于数据库专门用于存储数据，维护数据库是最佳选择。 目前为止有多个 tsv 文件，每个文件都有包名和 .tsv 扩展名。 RulesStorageManager (规则存储管理器) 类负责查询/处理相应的文件/数据库。 由于这种抽象概念，将来在不更改整个项目设计的情况下切换到数据库或加密数据库系统会更加容易。 目前所有的配置文件存储在 /data/data/io.github.muntashirakon.AppManager/Files/conf。

5.1.2 规则文件格式

 <name> <type> <mode>|<component_status>|<is_granted>

 <package_name> <component_name> <type> <mode>|<component_status>|<is_granted>

6.2.1 Overlay management

In the App Details page, a new tab “Overlays” is added where per-app overlays are displayed. They can also be enabled or disabled using the toggle button. In addition, if the App Details page of an overlay package is opened, a “Overlay” tag will be displayed in the App Info tab. Clicking on the tag opens a dialog containing additional info along with a button that allows navigating to the App Details page of the overlay target package if it is installed.

6.2.2 Unfreeze option in activity shortcuts

If the application corresponding to the shortcut being launched is frozen, App Manager will now offer you to unfreeze the app temporarily so that the shortcut can be launched. The app will be frozen again once the screen is locked.

6.2.3 market-like URL support

Third-party applications can now open the App Details page of any installed package by invoking an Intent with an URL with the following format:

app-manager://details?id=<pkg>&user=<user_id>

where <pkg> stands for package name, and <user_id> stands for the user ID which is optional.

6.2.4 Updated color codes

In order to improve accessibility, certain color codes have been improved. Visit Settings > About > Version/Changelog for details.

6.2.5 Others

• Avoided waiting for the remote server to respond when no-root mode is set

• Fixed downgrading apps in Android 10 onwards

• Fixed installer issues in the Huawei stock operating systems

• Improved text formatting in the “What’s New” dialog

• In the UI tracker window, fixed clicking on the icon after it is iconified

• Updated bloatware and suggestions

6.3.1 New logo!

The new logo is just a cursive “A”. The design is based on the Tengwar Telcontar font which was created to bring the Tengwar script, originally created by J. R. R. Tolkien, to the digital world. The letter has the classic App Manager color (i.e., #dcaf74) and uses a pure black background instead of a shade of grey.

6.3.2 Android 14 and 15 support

App Manager now targets Android 14 and fully supports Android 15.

6.3.3 Revamped debloater

Debloating profiles were available as “Presets” in the Profiles page which has now been replaced with the Debloater page and can be accessed from the three-dots menu in the Main page. ADL is a new project that focuses on maintaining a list of bloatware as well as potential open source alternatives. Contributions are welcome!

6.3.4 Introducing file manager

App Manager offers an (almost) fully-featured file manager with basic file operations, such as copy, cut, rename, and delete along with the batch operations. It also offers an extensive “Open with…” dialog to open a file with another app, and a comprehensive file properties viewer. Folders can also be added to the list of favorites for quick access. And many more.

6.3.5 Integrated code editor

Manifest and code viewers have been replaced with this new editor. Among other regular features, it includes proper syntax highlighting and advanced searching options. In addition, files from third-party apps can also be opened for editing.

6.3.6 History of operations

All 1-click operations, batch operations, and profile invocations are now stored as history. The history items can also be executed from the History page. To ensure consistency, the profile state, configurations, package list are also stored, and this stored version is executed instead of the actual profile. As a result, this works even if the profile is deleted.

6.3.7 Per-app freezing, and more

Freeze/unfreeze feature now supports setting per-app freezing method which is beneficial in certain scenarios, such as when a user want to suspend some apps while using the disable method as the default. In addition, an “Advanced suspend” option is added which force-stops an application before suspending it, thus, prevent it’s services from running in the background.

6.3.8 Log viewer enhancements

Log viewer now supports enhanced searching and filtering options, such as keyword- and regular expression-based searching and filtering. Please read the in-app changelog for details. Support for batch operations has also been added.

6.3.9 Launching non-exported activities

App Manager now supports launching non-exported activities in no-root and ADB mode. However, in no-root mode, android.permission.WRITE_SECURE_SETTINGS permission is required.

6.3.10 New tags in App Info tab

Five new tags are added in the App Info tab. They are: bloatware, Xposed, sensors disabled, open links, and static shared libs. Clicking on “bloatware” will display more information regarding the bloatware and suggest alternatives, “Xposed” tag will display dependency information, “open links” will display a list of links supported by the application, and “static shared libs” will display all version of the application installed in the system along with an option to uninstall them. The latter is useful for applications, such as Trichrome.

6.3.11 Per-session installer options

It is not possible to modify installer options during the installation by clicking on the “settings” button in the installation dialog. The installer options will be applied to all the applications installed in the same session (i.e., the installer queue).

6.3.12 Advanced mode of operations, ADB enhancements, …

App Manager now supports running its remote server (which is used as a proxy for running privileged operations) as any supported user (UID). This includes root (0), system (1000), and shell/ADB (2000) through the custom commands. This is also useful for Fire TVs which have disabled connecting to ADB from localhost through socket connection. In addition, ADB pairing is now done using notifications rather than split screen. ADB connection speed can also be improved by choosing to run App Manager in the background which can be configured in the settings.

6.3.13 Data usage widget, and more

Data usage widget display the total data usage for the day, similar to the screen time widget which displays the total screen time for the day. In addition, existing widgets have been improved.

6.3.14 Others

• Replaced log viewer, sys config, Terminal, etc. with Labs page

• Added an option to disable sensors for each app in the App Info tab

• Added an option to perform runtime optimization of applications in the 1-click Ops page and in the App Info tab

• Added support for Zstandard compression for backup/restore

• Enabling APK signing now automatically enables zip align feature

• Support exporting application list as CSV or JSON in the batch operations

• Added pure black theme support

• Display current activity name (when possible) in the UI Tracker window

• Added an option to filter apps by user in the Main page

• Display a link to Pithus report in the scanner page if available.

6.4.1 Android 13 support

App Manager now targets Android 13 which means most issues in Android 12 and 13 has been addressed, including SSAID and SAF issues as well as monochrome icons and other theming issues.

6.4.2 Introducing freeze/unfreeze

Enable/disable is replaced with freeze/unfreeze to allow greater control on the behaviours of an app. It supports suspend, disable and hide functionalities which can be controlled at Settings > Rules > Default freezing method. In order to make it easy to freeze or unfreeze an app, shortcuts can also be created from the App Info tab by long clicking on the freeze or unfreeze button.

6.4.3 Export app list

In the Main page, it is now possible to export the list of apps in either XML or Markdown format using batch operations. In the future, the XML file may also be imported to App Manager.

6.4.4 Elliptic Curve Crypography (ECC)

App Manager now fully supports encrypting backups using ECC in addition to offering AES, RSA and OpenPGP.

6.4.5 New languages

Two new languages are added: Korean and Romanian.

6.4.6 More list options

In the main page, more sorting and filtering options are added. Sorting options include sorting the apps by total size, total data usage, launch count, screen time and last usage time. Filtering options include filtering the apps having at least one item in the Android KeyStore, filtering apps with URIs granted via SAF, and filtering apps with SSAID.

6.4.7 Improved handling of mode of operation

Fixed various issues with ADB pairing, handled incomplete USB debugging. Some rooting methods cannot allow interprocess communication via Binder. In those cases, ADB mode is used as a fallback method by enabling it automatically if possible.

6.4.8 Handling multiple users

When possible, App Manager will be able to display apps from work profile in no-root mode in addition to allowing basic operations such as launching the app or navigating to the system settings. For backups, it is now possible to restore backups for other users, but for work profile, some apps may only work properly after re-enabling the work profile. In the installer page, selecting All users will now install the app for all users instead of only the current user. Finally, in the app info tab, current app can be installed in another profile using the Install for… option available in the three-dots menu. This is analogous to the pm install-existing command, thereby, making the installation process a lot faster.

6.4.9 Explorer enhancements

Explorer can now open DEX and JAR files in addition to APK files. Several sorting options as well as folder options are also added as the list options.

6.4.10 New tag: WX

In app info tab, a new tag called WX is added. It is displayed in Android 10 and later if the application targets Android 9 or earlier. It indicates W^X violation which allows the app to execute arbitrary executable files either by the modification of executables embedded within the app or by downloading them from the Internet.

6.4.11 App ops management

App ops are now managed automatically to avoid various app ops related crashes in various platforms. This will also lessen the amount of crashes in an unsupported operating system.

6.4.12 Batch uninstallation

In the Main page, enabled batch uninstallation in no-root mode.

6.4.13 Running apps

Enabled advanced searching. Searching now matches not only app labels but also package names.

6.4.14 Interceptor

Copy the intercepted Intent as am command which can be run from either an ADB shell or a terminal using root with the same effectiveness.

6.4.15 Device-specific changes

6.4.16 Others

• Improved Java-Smali conversion by including all the subclasses during conversion

• Improved scanning performance in the Scanner page

• Improved updating the list of apps in the Main page

• Scan all the available paths to detect systemless-ly installed system apps

• vacuum SQLite database before opening it for viewing or editing.

6.5.1 Material 3 and More

Material 3, somewhat similar to Material You, is a significant improvement over Material Design 2 with support for dynamic colours in Android 12 and later. In addition, many design changes have been made in App Manager without any significant changes in the overall user experience.

6.5.2 Wireless Debugging

Wireless debugging support has been fully implemented. Head over to §3.2 for instructions on how to configure wireless debugging.

6.5.3 Languages

App Manager is fully translated into Indonesian and Italian languages and can be enabled in settings. Bengali is removed due to lack of translators.

6.5.4 Introducing App Explorer

App Explorer can be used to browse the contents of an application. This includes binary XML files, DEX contents or any other media files. DEX contents can only be explored in Android Oreo (Android 8) and later. It’s also possible to convert an .smali file into .java for a better understanding of the reversed code. This feature, if not needed, can be disabled in Settings > Enable/disable features.

6.5.5 Import Backups from Other Applications

It is possible to import backups from discontinued or obsolete applications such as Titanium Backup, OAndBackup and Swift Backup (version 3.0 to 3.2). Go to Setting > Backup/restore to find this option.

6.5.6 VirusTotal

VirusTotal is a widely used tool to scan files and URLs for viruses. In the scanner page and in the running apps page, an option to scan files with VirusTotal has been added. But the option is hidden by default. To enable the option, it is necessary to obtain an API key from VirusTotal. Go to Settings > VirusTotal API Key for more information.

6.5.7 Trigger Profiles from the Automation Software

As the implementation of routine operations is being delayed, an option to trigger profiles from the external automation software is added. See §3.4 for instructions on how to configure profile automation.

6.5.8 Improved Application Installer

Application installer includes several improvements including the ability to downgrade applications in no-root mode, installing multiple applications at once and blocking trackers after installation. In Android 12 and later, no-root users can update applications without any user interactions.

6.5.9 Component Blocking

It is now possible to configure how App Manager should block a component. Visit Settings > Rules > Default blocking method for more information. In the components tab, long clicking the block/unblock button opens a context menu which allows per-component blocking in a similar manner. ADB users can also block the components of a Test only app.

6.5.10 Advanced Searching

In some pages, the search bar supports additional searching which includes searching via prefix, suffix or even regular expressions. In the main page, it is also possible to search for applications using the first letters of each word, e.g. App Manager can be listed by searching for am.

6.5.11 Shared Libraries

Shared libraries tab has received a significant improvements. It can display three types of libraries, such as native, jar and APK files.

6.5.12 Make the Best Use of Interceptor

Activity interceptor can be opened directly from the activities tab by long clicking on the launch button, and similarly, activities can be launched from the activity interceptor page with or without root, for any users.

6.5.13 Widget: Screen Time

Screen time widget is quite similar to Digital Wellbeing’s widget by the same name. It displays the total screen time for the day along with the top three apps from all users.

6.5.14 Widget: Clear Cache

Clear cache widget can be to clear cache from all the applications directly from the home screen.

6.6.1 Introducing Backups

Back up/restore feature is now finally out of beta! Read the corresponding guide to understand how it works.

6.6.2 Introducing Log Viewer

Log viewer is essentially a front-end for logcat. It can be used to filter logs by tag or pid (process ID), or even by custom filters. Log levels AKA verbosity can also be configured. You can also save, share and manage logs.

6.6.3 Lock App Manager

Lock App Manager with the screen lock configured for your device.

6.6.4 Extended Modes for App Ops

You can set any mode for any app ops that your device supports, either from the 1-click ops page or from the app ops tab.

6.6.5 New Batch Ops: Add to Profile

You can now easily add selected apps to an existing profile using the batch operations.

6.6.6 App Info: Improved

App info tab now has many options, including the ability to change SSAID, network policy (i.e. background network usage), battery optimization, etc. Most of the tags used in this tab are also clickable, and if you click on them, you will be able to look at the current state or configure them right away.

6.6.7 Advanced Sort and Filtering Options in the Main Page

Sort and filter options are now replaced by List Options which is highly configurable, including the ability to filter using profiles.

6.6.8 About This Device

Interested in knowing about your device in just one page? Go to the bottom of the settings page.

6.6.9 Enable/disable Features

Not interested in all the features that AM offers? You can disable some features in settings.

6.6.10 New Languages

AM now has more than 19 languages! New languages include Farsi, Japanese and Traditional Chinese.

6.6.11 Signing the APK Files

You can now import external signing keys in AM! For security, App Manager has its own encrypted KeyStore which can also be imported or exported.

6.6.12 New Extension: UnAPKM

Since APKMirror has removed encryption from their APKM files, it’s no longer necessary to decrypt them. As a result, the option to decrypt APKM files has been removed. Instead, this option is now provided by the UnAPKM extension which you can grab from F-Droid. So, if you have an encrypted APKM file and have this extension installed, you can open the file directly in AM.

6.7.1 Introducing Profiles

Profiles finally closes the related issue. Profiles can be used to execute certain tasks repeatedly without doing everything manually. A profile can be applied (or invoked) either from the Profiles page or from the home screen by creating shortcuts. There are also some presets which consist of debloating profiles taken from Universal Android Debloater.

6.7.2 The Interceptor

Intent Intercept works as a man-in-the-middle between source and destination, that is, when you open a file or URL with another app, you can see what is being shared by opening it with Interceptor first. You can also add or modify the intents before sending them to the destination. Additionally, you can double-click on any exportable activities in the Activities tab in the App Details page to open them in the Interceptor to add more configurations.

6.7.3 UnAPKM: DeDRM the APKM files

When I released a small tool called UnAPKM, I promised that similar feature will be available in App Manager. I am proud to announce that you can open APKM files directly in the App Info page or convert them to APKS or install them directly.

6.7.4 Multiple user

App manager now supports multiple users! For now, this requires root or ADB. But no-root support is also being considered. If you have multiple users enabled and click on an app installed in multiple profiles, an alert prompt will be displayed where you can select the user.

6.7.5 Vive la France!

Thanks to the contributors, we have one more addition to the language club: French. You can add more languages or improve existing translations at Weblate.

6.7.6 Report crashes

If App Manager crashes, you can now easily report the crash from the notifications which opens the share options. Crashes are not reported by App Manager, it only redirects you to your favourite Email client.

6.7.7 Android 11

Added support for Android 11. Not everything may work as expected though.

6.7.8 App Installer Improvements

6.8.1 App Installer

As promised, it is now possible to select splits. AM also provides recommendations based on device configurations. If the app is already installed, recommendations are provided based on the installed app. It is also possible to downgrade to a lower version without data loss if the device has root or ADB. But it should be noted that not all app can be downgraded. Installer is also improved to speed up the installation process, especially, for root users. If the app has already been installed and the new (x)apk(s) is newer or older or the same version with a different signature, AM will display a list of changes similar to What’s New before prompting the user to install the app. This is useful if the app has introduced tracker components, new permissions, etc.

6.8.2 Scanner: Replacement for Exodus Page

Exodus page is now replaced with scanner page. Scanner page contains not only a list of trackers but also a list of used libraries. This is just a start. In the future, this page will contain more in depth analysis of the app.

6.8.3 Introducing System Config

System Config lists various system configurations and whitelists/blacklists included in Android by either OEM/vendor, AOSP or even some Magisk modules. Root users can access this option from the overflow menu in the main page. There isn’t any official documentation for these options therefore it’s difficult to write a complete documentation for this page. I will gradually add documentations using my own knowledge. However, some functions should be understandable by their name.

6.8.4 More Languages

Thanks to the contributors, AM now has more than 12 languages. New languages include Bengali, Hindi, Norwegian, Polish, Russian, Simplified Chinese, Turkish and Ukrainian.

6.8.5 App Info Tab

More tags are added in the app info tab such as KeyStore (apps with KeyStore items), Systemless app (apps installed via Magisk), Running (apps that are running). For external apk, two more options are added namely Reinstall and Downgrade. Now it is possible to share an apk via Bluetooth. For system apps, it is possible to uninstall updates for root/ADB users. But like the similar option in the system settings, this operation will clear all app data. As stated above, exodus has been replaced with scanner.

6.8.6 Navigation Improvements

It’s now relatively easy to navigate to various UI components using keyboard. You can use up/down button to navigate between list items and tab button to navigate to UI components inside an item.

6.8.7 Running Apps Page

It is now possible to sort and filter processes in this tab. Also, the three big buttons are replaced with an easy-to-use three dot menu. Previously the memory usage was wrong which is fixed in this version.

6.8.8 Built-in Toybox

Toybox (an alternative to busybox) is bundled with AM. Although Android has this utility built-in from API 23, toybox is bundled in order to prevent buggy implementations and to support API < 23.

6.8.9 Component Blocker Improvements

Component blocker seemed to be problematic in the previous version, especially when global component blocking is enabled. The issues are mostly fixed now.

6.8.10 Improvements in the App Details Page

Value of various app ops depend on their parent app ops. Therefore, when you allow/deny an app op, the parent of the app op gets modified. This fixes the issues some users have been complaining regarding some app ops that couldn’t be changed.

If an app has the target API 23 or less, its permissions cannot be modified using the pm grant … command. Therefore, for such apps, option to toggle permission has been disabled.

The signature tab is improved to support localization. It also displays multiple checksums for a signature.

6.8.11 App Manifest

Manifest no longer crashes if the size of the manifest is too long. Generated manifest are now more accurate than before.

6.9.1 Bundled App (Split APK)

Bundled app formats such as apks and xapk are now supported. You can install these apps using the regular installation buttons. For root and adb users, apps are installed using shell, and for non-root users, the platform default method is used.

6.9.2 Direct Install Support

You can now install APK, APKS or XAPK directly from your favourite browser or file manager. For apps that need updates, a What’s New dialog is displayed showing the changes in the new version.

6.9.3 Remove All Blocking Rules

In the Settings page, a new option is added which can be used to remove all blocking rules configured within App Manager.

6.9.4 App Ops

• App Ops are now generated using a technique similar to AppOpsX. This should decrease the loading time significantly in the App Ops tab.

• In the App Ops tab, a menu item is added which can be used to list only active app ops without including the default app ops. The preference is saved in the shared preferences.

6.9.5 Enhanced ADB Support

ADB shell commands are now executed using a technique similar to AppOpsX (This is the free alternative of AppOps by Rikka.). This should dramatically increase the execution time.

6.9.6 Filtering in Main Page

Add an option to filter apps that has at least one activity.

6.9.7 Apk Backup/Sharing

Apk files are now saved as app name_version.extension instead of package.name.extension.

6.9.8 Batch Ops

• Added a foreground service to run batch operations. The result of the operation is displayed in a notification. If an operation has failed for some packages, clicking on the notification will open a dialog box listing the failed packages. There is also a Try Again button on the bottom which can be used to perform the operation again for the failed packages.

• Replaced Linux kill with force-stop.

6.9.9 Translations

Added German and Portuguese (Brazilian) translations.

6.9.10 App Data Backup

Install app only for the current user at the time of restoring backups. Support for split apks is also added.

Data backup feature is now considered unstable. If you encounter any problem, please report to me without hesitation.

7.3.1 OP_* Constants

OP_* are the integer constants starting from 0. OP_NONE implies that no operations are specified whereas _NUM_OP denotes the number of operations defined in OP_* prefix. While they denote each operation, the operations are not necessarily unique. In fact, there are many operations that are actually a single operation denoted by multiple OP_* constant (possibly for future use). Vendors may define their own op based on their requirements. MIUI is one of the vendors who are known to do that.

public static final int OP_NONE = -1;
public static final int OP_COARSE_LOCATION = 0;
public static final int OP_FINE_LOCATION = 1;
public static final int OP_GPS = 2;
public static final int OP_VIBRATE = 3;
...
public static final int OP_READ_DEVICE_IDENTIFIERS = 89;
public static final int OP_ACCESS_MEDIA_LOCATION = 90;
public static final int OP_ACTIVATE_PLATFORM_VPN = 91;
public static final int _NUM_OP = 92;

Whether an operation is unique is defined by sOpToSwitch. It maps each operation to another operation or to itself (if it’s a unique operation). For instance, OP_FINE_LOCATION and OP_GPS are mapped to OP_COARSE_LOCATION.

Each operation has a private name which are described by sOpNames. These names are usually the same names as the constants without the OP_ prefix. Some operations have public names as well which are described by sOpToString. For instance, OP_COARSE_LOCATION has the public name android:coarse_location.

As a gradual process of moving permissions to app ops, there are already many permissions that are defined under some operations. These permissions are mapped in sOpPerms. For example, the permission android.Manifest.permission.ACCESS_COARSE_LOCATION is mapped to OP_COARSE_LOCATION. Some operations may not have any associated permissions which have null values.

As described in the previous section, operations that are configured for an app are stored at /data/system/appops.xml. If an operation is not configured, then whether system will allow that operation is determined from sOpDefaultMode. It lists the default mode for each operation.

7.3.2 MODE_* Constants

MODE_* constants also integer constants starting from 0. These constants are assigned to each operation describing whether an app is authorised to perform that operation. These modes usually have associated names such as allow for MODE_ALLOWED, ignore for MODE_IGNORED, deny for MODE_ERRORED (a rather misnomer), default for MODE_DEFAULT and foreground for MODE_FOREGROUND.

1. MODE_ALLOWED. The app is allowed to perform the given operation

2. MODE_IGNORED. The app is not allowed to perform the given operation, and any attempt to perform the operation should silently fail, i.e. it should not cause the app to crash

3. MODE_ERRORED. The app is not allowed to perform the given operation, and this attempt should cause it to have a fatal error, typically a SecurityException

4. MODE_DEFAULT. The app should use its default security check, specified in AppOpsManager

5. MODE_FOREGROUND. Special mode that means “allow only when app is in foreground.” This mode was added in Android 10

6. MODE_ASK. This is a custom mode used by MIUI whose uses are unknown.

7.3.3 PackageOps

AppOpsManager.PackageOps is a data structure to store all the OpEntry for a package. In simple terms, it stores all the customised operations for a package.

public static class PackageOps implements Parcelable {
    private final String mPackageName;
    private final int mUid;
    private final List<OpEntry> mEntries;
    ...
}

As can be seen in Listing 2, it stores all OpEntry for a package as well as the corresponding package name and its kernel user ID.

7.3.4 OpEntry

AppOpsManager.OpEntry is a data structure that stores a single operation for any package.

public static final class OpEntry implements Parcelable {
    private final int mOp;
    private final boolean mRunning;
    private final @Mode int mMode;
    private final @Nullable LongSparseLongArray mAccessTimes;
    private final @Nullable LongSparseLongArray mRejectTimes;
    private final @Nullable LongSparseLongArray mDurations;
    private final @Nullable LongSparseLongArray mProxyUids;
    private final @Nullable LongSparseArray<String> mProxyPackageNames;
    ...
}

Here:

• mOp: Denotes one of the OP_* constants

• mRunning: Whether the operation is in progress (i.e. the operation has started but not finished yet). Not all operations can be started or finished this way

• mMOde: One of the MODE_* constants

• mAccessTimes: Stores all the available access times

• mRejectTimes: Stores all the available reject times

• mDurations: All available access durations, checking this with mRunning will tell you for how long the app is performing a certain app operation

• mProxyUids: No documentation found

• mProxyPackageNames: No documentation found

7.3.5 Usage

TODO