企业官网建设流程全解析

• 桌面应用
• 开发工具

APK Installer（APK 安装程序）是一款面向 Windows 平台的 Android 应用安装器，通过 ADB 与 Android 设备（含 WSA 等环境）通信，直接在 Windows 桌面上完成 APK / APKS / XAPK 等安装包的解析与安装。本文以仓库根目录下的 README.md 为骨架，完整讲解该应用自身的三种安装路径（安装脚本、应用安装程序、更新流程），并结合 Package.appxmanifest 与 InstallViewModel.cs 等源码，说明其依赖、激活方式与安装原理，帮助读者一次掌握从下载到使用的全部环节。

项目定位与运行环境

APK Installer 的目标用户是需要在 Windows 上管理 Android 应用安装包的开发者与普通用户。项目以 WinUI / Windows App SDK 构建，工程配置见 APKInstaller.csproj（TargetFramework 为net10.0-windows10.0.26100.0，平台支持x86/x64/ARM64，VersionPrefix 为0.1.28）。仓库同时提供中文（README.md）与英文（README.en-US.md）两份说明文档。

最低需求

根据 README，安装 APK Installer 前需要满足：

• 操作系统：Windows 10 Build 17763（1809）及以上版本。这一要求与 Package.appxmanifest 中声明的MinVersion="10.0.17763.0"完全一致，应用包本身也声明支持 Windows.Universal 与 Windows.Desktop 两类设备家族。
• CPU 架构：设备需支持 ARM64 / x86 / x64 之一。
• 磁盘空间：至少 400MB 空余储存空间，用于存放安装包与安装应用（APK 本身可能较大，且安装过程中需要临时解压与缓存）。

方式一：使用应用安装脚本安装（推荐给命令行用户）

应用安装脚本方式适合希望以最小手动操作用 PowerShell 引导完成安装的场景，完整步骤如下：

1. 从项目发布页下载并解压最新安装包（名为APKInstaller (Package)_x.x.x.0_Test.rar，其中x.x.x为版本号）。
2. 如果目标目录中没有应用安装脚本，下载Install.ps1到目标目录（脚本与安装包放置在同一目录下）。

3. 右键单击Install.ps1，选择"使用 PowerShell 运行"。
4. 应用安装脚本将引导你完成剩余过程（包括后续的依赖包、证书与主包安装）。

提示：该方式把"应用安装程序方式"中的手动步骤封装成了脚本，适合批量部署或需要复现安装环境的场景。仓库当前未在根目录保留Install.ps1源文件，请以发布包内提供的脚本为准。

方式二：使用 Windows 应用安装程序（App Installer）安装 ⭐

这是 README 标注为推荐（⭐）的常规图形化安装方式，共四个关键步骤：

第一步：下载并解压安装包

下载并解压最新的APKInstaller (Package)_x.x.x.0_Test.rar安装包。解压后目录中通常包含主安装包（*.appxbundle）、Dependencies依赖文件夹以及*.cer证书文件。

第二步：开启旁加载模式

在 Windows 设置中开启"旁加载应用"（sideload apps）。具体说明：

• 如果你的目标是开发 UWP 应用，可以开启"开发人员模式"；对于大多数不需要做 UWP 开发的用户来说，开发人员模式是没有必要的，只需旁加载模式即可。
• 旁加载模式允许安装来自应用商店以外的签名应用包。

第三步：安装依赖包与证书

安装依赖包：安装Dependencies文件夹下适用于你设备的所有依赖包。依赖包需要按架构匹配（x86/x64/ARM64），Windows 应用安装程序会提示缺少的依赖，直接逐个安装即可。

安装证书：将*.cer证书安装到本地计算机→受信任的根证书颁发机构：

导入时选择"本地计算机"，并勾选"将所有证书都放入下列存储"后浏览到"受信任的根证书颁发机构"：

注意事项：安装证书到"本地计算机"需要管理员权限。如果你安装证书时没有用到该权限，可能是因为你将证书安装到了错误的位置（例如安装到了当前用户存储），或者你使用的是超级管理员账户（此时系统不会再次弹出 UAC 提示）。

第四步：安装主包

双击*.appxbundle，在弹出的应用安装程序界面中单击"安装"，随后等待安装完成即可（README 原话：坐和放宽）。

源码视角：安装包注册了哪些能力

安装完成后，应用之所以能"双击 APK 直接安装"，是因为 Package.appxmanifest 中注册了多项系统集成：

• 文件类型关联（File Type Association）：注册了.apk以及拆分包.apks/.apkm/.xapk，并声明OpenIsSafe="true"，双击这些文件即可唤起 APK Installer（对应 manifest 中windows.fileTypeAssociation两段扩展）。
• 协议关联（Protocol）：注册了名为apkinstaller的协议（ReturnResults="optional"），支持通过 URL Scheme 唤起应用并携带参数。
• 能力声明（Capabilities）：仅声明internetClient与受限的runFullTrust，前者用于网络下载 APK，后者允许应用以完全信任方式运行（便于调用 ADB 进程）。

在 InstallPage.xaml.cs 的OnNavigatedTo中可以看到应用对多种激活方式的处理：

• ExtendedActivationKind.File：从文件管理器双击 APK 打开；
• ExtendedActivationKind.Protocol/ProtocolForResults：通过apkinstaller://协议唤起，协议数据支持Url与FilePath两个键，分别表示远程下载地址与本地文件路径；
• ExtendedActivationKind.ShareTarget：从其他应用"分享"APK 文件进入；
• 页面还支持将 APK 文件直接拖放到窗口（Page_Drop）。

更新应用

更新 APK Installer 本身与全新安装略有不同，步骤为：

1. 下载并解压最新的安装包（注意更新场景使用名为APKInstaller (Package)_x.x.x.0_x86_x64_arm_arm64.appxbundle的完整 bundle）。
2. 双击*.appxbundle，在弹出的窗口中单击"更新"（而不是"安装"），等待完成即可。

更新时会自动保留原有应用数据与设置，无需重新安装证书与依赖（前提是系统信息与已装版本一致）。

安装后的首次使用与核心工作流

完成安装后首次启动，应用主界面（MainPage.xaml.cs）会默认导航到安装页InstallPage。安装一个 APK 的完整工作流如下：

1. 解析 APK 信息：通过 AAPTForNet 中的AAPTool.Decompile调用内置的aapt工具解析 APK 清单（包名、版本、图标、权限、启动 Activity 等），解析结果展示在界面上。
2. 准备 ADB 环境：如果未检测到 ADB（ADBPath指向的adb.exe不存在），InitADBFile会弹窗提示，并支持两种处理：自动下载 platform-tools 压缩包（存至CachesHelper.TempPath下的platform-tools.zip），或手动选择本机已有的adb.exe。相关逻辑见 InstallViewModel.cs。
3. 连接设备：通过 AdvancedSharpAdbClient 枚举 ADB 设备；对于 Android 11+ 的无线调试，仓库还内置了 Zeroconf（mDNS）发现逻辑，可在设置页自动发现_adb-tls-pairing._tcp.local.服务并用配对码连接，见 PairDeviceViewModel.cs。
4. 执行安装：InstallAPP会先查询设备上是否已存在同名包及更高版本（GetPackageVersionAsync），存在则弹窗提示"已安装更新版本"并允许选择重装；随后根据 APK 类型选择安装 API——普通 APK 走InstallAsync，拆分 APK（IsSplit）与 Bundle（IsBundle）走InstallMultipleAsync，并统一附加-r（允许覆盖安装）与-t（允许安装测试包）参数。安装期间界面会展示上传、写会话、安装等阶段的实时进度（InstallViewModel.cs）。
5. 安装完成：可选择立即启动应用（如果包内存在LaunchableActivity），并可选安装后自动关闭应用进程。

这一流程同时也解释了对磁盘空间的需求：应用需要保留 APK 缓存（临时目录）、解压拆分包，并运行 ADB 传输，400MB 是保证顺畅完成的最小经验值。

依赖模块与构建关系

README 列出了项目使用的开源模块，与 APKInstaller.csproj 中的PackageReference/ProjectReference一一对应，它们共同支撑了上文提到的各项能力：

常见问题与注意事项

• 安装证书提示"已存在同名证书"：说明此前已安装过同版本证书，可跳过；升级版本时也无需重复安装证书。
• 双击 appxbundle 提示依赖缺失：请确认Dependencies下的依赖包架构与系统架构一致（x86 系统装 x86 依赖，ARM64 设备装 ARM64 依赖）。
• 证书权限提示：安装到"本地计算机"必须使用管理员权限；如果全程无 UAC 弹窗，请检查是否安装到了"当前用户"存储，或当前是否为超级管理员账户。
• 首次安装 APK 报 ADB 缺失：按弹窗提示自动下载 platform-tools，或在设置页手动指定adb.exe路径即可。
• 无线安装连接不上：确保 Android 设备与电脑处于同一局域网，并已在设备上开启"无线调试"配对，应用设置页会自动发现设备；若未自动发现，可手动输入主机与端口。

总而言之，APK Installer 的安装过程本身就是一个标准的 Windows 旁加载应用部署流程（依赖包 + 根证书 + appxbundle），理解其背后的文件关联、协议唤起与 ADB 工作流，也能帮助你排查日常使用中的绝大多数问题。

• 桌面应用
• 开发工具