原生移动开发 / 系统课时

从安装来源识别应用市场

从安装来源识别应用市场

当多个应用市场分发的是同一份 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 声明安装权限。

kotlin
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。实际包名因市场、设备和安装方式而异。

预期结果

text
com.example.store

这里的 com.example.store 仅表示“某安装器包名”的占位示意,不应直接写死为真实市场映射。生产环境应维护一份可更新的“安装器包名 → 渠道名称”映射,并为未知值保留 unknown 分支。

安装来源识别与渠道归因流程

什么时候可以改成单包方案

如果不同市场拿到的应用在代码、资源、权限、签名、applicationId 和功能上都一致,渠道差异只用于“安装来源统计”或轻量运营归因,那么单包通常更容易维护。构建一次、统一签名、统一测试,再通过安装来源区分市场,可以减少多渠道打包和回归成本。

反过来,只要市场之间存在编译期差异,就不能仅靠 Installer Source 替代渠道包。例如某市场要求独有 SDK、Manifest 权限或组件,不同渠道需要不同资源、包名、签名或功能开关,或者渠道信息必须在首次启动前就固化到包内,这些情况仍适合 Product Flavor 或其他渠道构建机制。

使用时的边界

不要把安装器包名用于鉴权、反作弊或高价值权益发放。安装来源存在缺失、变化和设备差异,而且安装链路本身不是可信身份体系。它适合做统计标签和分发诊断,不适合证明“用户一定来自某市场”。

如果目标只是减少重复渠道包,先把各市场差异列出来:能在服务端配置或运行时识别的差异优先收敛;必须在编译期、签名期或 Manifest 中确定的差异继续留在构建系统。这样单包方案才是在降低复杂度,而不是把渠道逻辑从 Gradle 转移成一堆脆弱的运行时判断。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

从安装来源识别应用市场

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通