原生移动开发 / 系统课时
从安装来源识别应用市场
从安装来源识别应用市场
当多个应用市场分发的是同一份 APK 或 AAB 时,可以在运行时读取“谁安装了当前应用”,把它用于渠道归因、统计或灰度判断。关键是理解安装来源只描述安装链路,不等于绝对可靠的营销渠道标识,也不适合替代所有渠道包能力。
学习目标
- 使用
PackageManager读取当前应用的安装来源,并兼容 Android 11 之前的系统 - 区分“安装来源识别”和“编译期渠道差异”,避免把来源信息当成可信安全凭据
- 判断哪些发布场景适合单包分发,哪些仍应保留 Product Flavor 或独立渠道包
Installer Source 能告诉你什么
Android 11(API 30)起,PackageManager.getInstallSourceInfo() 用于查询应用如何被安装或更新;旧的 getInstallerPackageName() 已在 API 30 被弃用。常用的是 installingPackageName,它表示实际执行安装的包名。([Android Developers][1])
这个值可能是应用商店,也可能是系统安装器、企业管理工具,甚至为空。因此业务上应把它理解为“可观测的安装来源线索”,而不是永久不变的渠道身份证。应用升级时,负责更新的安装器也可能影响你之后读到的来源。
在应用中读取安装来源
下面是片段示例,放入现有 Android 应用模块即可使用;项目需以 Android SDK 编译,compileSdk 至少覆盖 API 30。示例只查询当前应用自身,不需要为了读取 installingPackageName 声明安装权限。
import android.content.Context
import android.content.pm.PackageManager
import android.os.Build
fun getInstallerPackage(context: Context): String? {
val packageManager = context.packageManager
val packageName = context.packageName
return try {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
packageManager.getInstallSourceInfo(packageName).installingPackageName
} else {
@Suppress("DEPRECATION")
packageManager.getInstallerPackageName(packageName)
}
} catch (e: PackageManager.NameNotFoundException) {
null
}
}调用后可以把返回值写入调试日志或上报到统计系统。例如,从某应用商店安装时可能得到该商店安装器的包名;通过某些手工安装、调试或特殊系统环境安装时也可能得到 null。实际包名因市场、设备和安装方式而异。
预期结果
com.example.store这里的 com.example.store 仅表示“某安装器包名”的占位示意,不应直接写死为真实市场映射。生产环境应维护一份可更新的“安装器包名 → 渠道名称”映射,并为未知值保留 unknown 分支。

什么时候可以改成单包方案
如果不同市场拿到的应用在代码、资源、权限、签名、applicationId 和功能上都一致,渠道差异只用于“安装来源统计”或轻量运营归因,那么单包通常更容易维护。构建一次、统一签名、统一测试,再通过安装来源区分市场,可以减少多渠道打包和回归成本。
反过来,只要市场之间存在编译期差异,就不能仅靠 Installer Source 替代渠道包。例如某市场要求独有 SDK、Manifest 权限或组件,不同渠道需要不同资源、包名、签名或功能开关,或者渠道信息必须在首次启动前就固化到包内,这些情况仍适合 Product Flavor 或其他渠道构建机制。
使用时的边界
不要把安装器包名用于鉴权、反作弊或高价值权益发放。安装来源存在缺失、变化和设备差异,而且安装链路本身不是可信身份体系。它适合做统计标签和分发诊断,不适合证明“用户一定来自某市场”。
如果目标只是减少重复渠道包,先把各市场差异列出来:能在服务端配置或运行时识别的差异优先收敛;必须在编译期、签名期或 Manifest 中确定的差异继续留在构建系统。这样单包方案才是在降低复杂度,而不是把渠道逻辑从 Gradle 转移成一堆脆弱的运行时判断。