最近刚找到工作,是手机方案公司,刚接触手机系统预装的APP,以及解决方案MTK平台下预装APP的bug,也接触到了Launcher的东西。

然后接触到了第一个需求

PAI预装APK功能

下面是我用到的帖子,也很感谢第一个博客主人,加了他QQ,问了很多东西

https://blog.csdn.net/xct841990555/article/details/80896429

这个帖子可能配置方面更加详细

http://wossoneri.github.io/2017/06/19/[Android][Framework]PlayAutoInstall/?tdsourcetag=s_pcqq_aiomsg

什么是PAI

PAI(PlayAutoInstall)是一个自动下载安装APK到手机,并且摆放在Launcher对应位置的一个机制。

因为国内没有大湄公河次区域,所以很多人没接触过这个机制。这个机制其实对于运营商定制来说非常重要,比如美国的运营商,一个运营商有很多地区很多种类的SIM卡,当插上不同地区的SIM卡,运营商定制的手机就会下载不同的APP摆放在界面不同的位置。

其实主要是要两个APK,一个预装进的Android系统中(stub.apk),一个上传到谷歌的合作伙伴服务器网站上(配置),然后在合作伙伴上进行一些配置就OK了。下面具体介绍这两个APK的制作。

 Android PAI (PlayAutoInstall)预装APK 功能-冯金伟博客园

PAI流程

本地编译一个PlayAutoInstallConfig.apk,签名上传到APFE服务器,APFE会验证配置信息,并提供给Play商店中。当目标设备第一次开机启动并且联网(现在不必要登录谷歌帐号),这些应用就会加入下载队列,自动下载到手机。

配置菜单

先聊一下APFE会验证的配置信息。

需要的配置信息包括:

指纹(必须)
城市(可选)
运营商(可选)
需要下载的应用程序列表
应用在桌面的位置信息

后两项是编译在PlayAutoInstallConfig.apk中的,前三项是把APK上传到服务器时需要填写的。

上传服务器配置页面如下:

Android PAI (PlayAutoInstall)预装APK 功能-冯金伟博客园

配置信息的前三项匹配项如果填写,就必须要完全匹配才能应用到手机。我遇到一个问题是配置上传后PlayAutoInstallConfig.apk会在设定精灵过程中下载到手机,但需要Play商店中下载的应用怎么都不下载。后来发现是在上传APK到服务器时运营商填的不对,导致无法下载。因为尝试填写几种运营商名称都不能正常工作,最后解决方案是只匹配指纹,不匹配城市和运营商(减少过滤项),这样手机就可以和Play商店中信息匹配,然后就可以自动下载了。

关于其余配置,参考下面表格:

Android PAI (PlayAutoInstall)预装APK 功能-冯金伟博客园

下面具体放代码:分为2个APK,一个是预装手机的APK(stub.apk)一个是放到服务器的APK(config.apk)

stub.apk

手机内必须要先预置一个符合下列条件的stub APK:

为一个系列的设备设置唯一的包名,包名格式为android.autoinstalls.config ..
必须配置一个接收器“android.autoinstalls.config.action.PLAY_AUTO_INSTALL”,并且设置export for flase
在预置的应用程序里只能有一个定义这个接收机
的versionCode必须定义成1
APK必须预置在/ system / app(不能定义成特权,即不能放/ priv-app)
必须用私有密钥签名(汞用的TCL签名)
不能定义权限/活动/其他接收者/内容提供者/服务
 

Android PAI (PlayAutoInstall)预装APK 功能-冯金伟博客园

Android PAI (PlayAutoInstall)预装APK 功能-冯金伟博客园

MK文件的代码

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_PACKAGE_NAME := LavaPAIStub
LOCAL_CERTIFICATE := platform
LOCAL_SDK_VERSION := current
LOCAL_AAPT_FLAGS := -x
LOCAL_MODULE_TAGS := optional
LOCAL_MODULE_PATH := $(TARGET_OUT_JAVA_LIBRARIES)
LOCAL_EXPORT_PACKAGE_RESOURCES := true
LOCAL_MODULE_PATH := $(TARGET_OUT_APPS)
include $(BUILD_PACKAGE)

AndroidManifest.xml中

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="android.autoinstalls.config.lava.A5s"
    android:versionCode="1"
    android:versionName="1">//versionCode和versionName一定要一样,并且为1
    //后面不变

    <application
        android:allowBackup="false"
        android:label="@string/app_name" >
        <receiver
            android:name="DummyReceiver"
            android:exported="false" >
            <intent-filter>
                 <action android:name="android.autoinstalls.config.action.PLAY_AUTO_INSTALL" />
            </intent-filter>
        </receiver>
    </application>
</manifest>

config.apk

这个APK是我们真正配置的APK。

它和前面的APK的关系是:包名一致因为PAI机制需要本地存在一个这个包名的APK,在开机的设定精灵阶段,(如果联网)它会从服务器下载这个写有对应配置的APK到手机上,替换掉那个Stub APK。

关于PAIconfig APK的配置:

上传的APK(也就是我们编出来的APK)包名与指纹要和存根一致
APK签名要一致
和存根配置同样的接收器
的versionCode必须大于1000
APK必须包含启动布局配置的XML文件(即后面会提到的default_layout),不然上传会失败,因为上传前会检查这个XML文件,然后会把要下载的应用程序显示出来。所以也必须要求至少定义一个需要下载的app。最多50个,建议放10~15个。(文档还要求autoinstall的应用必须在launcher上指定摆放位置,目前看来是不需要的,有可能bb launcher做了修改)
界面会有文件夹,文件夹名称字符串在APK本地资源定义,支持国际化。
需要自动下载的APK对设备来讲必须是在Play商店中发布的,并且对该地区用户可见
不能定义权限/活动/其他接收者/内容提供者/服务

Android PAI (PlayAutoInstall)预装APK 功能-冯金伟博客园

Android PAI (PlayAutoInstall)预装APK 功能-冯金伟博客园

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_PACKAGE_NAME := LavaPAIConfig
LOCAL_CERTIFICATE := platform
LOCAL_SDK_VERSION := current
LOCAL_AAPT_FLAGS := -x
LOCAL_MODULE_TAGS := optional
LOCAL_MODULE_PATH := $(TARGET_OUT_JAVA_LIBRARIES)
LOCAL_EXPORT_PACKAGE_RESOURCES := true
LOCAL_MODULE_PATH := $(TARGET_OUT_APPS)
include $(BUILD_PACKAGE)

AndroidManifest.xml中

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="android.autoinstalls.config.lava.A5s"
    android:versionCode="1001"
    android:versionName="1001">

    <application
        android:allowBackup="false"
        android:label="@string/app_name" >
        <receiver
            android:name="DummyReceiver"
            android:exported="false" >
            <intent-filter>
                <action android:name="android.autoinstalls.config.action.PLAY_AUTO_INSTALL" />
            </intent-filter>
        </receiver>
    </application>
</manifest>

Android PAI (PlayAutoInstall)预装APK 功能-冯金伟博客园

default_layout.xml 
//选择要安装的apk,把他们的包名拿到,然后在这个文件中配置

<?xml version="1.0" encoding="utf-8"?>
<workspace>
    <autoinstall
        packageName="com.twitter.android"
        className="com.twitter.android.StartActivity"
        screen="1"
        x="0"
        y="0"
        groupid="0"
        requiredPreload="true"
        installByDefault="true" />

    <autoinstall
        packageName="com.instagram.android"
        className="com.instagram.android.activity.MainTabActivity"
        screen="1"
        x="1"
        y="0"
        groupid="1"
        requiredPreload="true"
        installByDefault="true" />
        
    <autoinstall
        packageName="com.whatsapp"
        className="com.whatsapp.Main"
        screen="1"
        x="2"
        y="0"
        groupid="1"
        requiredPreload="true"
        installByDefault="true" />
</workspace>

auto.install.xml

<install>
    <!-- Group Index Mapping -->
    <autoinstallgrouplist>
        <installgroup groupId="0" type="GOOGLE" />
        <installgroup groupId="1" type="OEM" />
    </autoinstallgrouplist>
</install>
 

将配置上传到服务器

下面我将代码上传到CSDN

犹豫我是系统预置,所以我是MK文件编译。没有Gradle,如果你们 要用gradle编译,只需要把我的AndroidManifess.xml + res 这2个文件夹考入到你的项目

config + stub 里面都没有 JAVA类

https://download.csdn.net/download/yangbin0513/10845496 

验证流程

用一台新手机,插入对应的SIM卡,你在服务器段,配置好,对应的运营商,然后把APK烧录到系统里面,恢复出厂设置,重新开始,在过程中联网,登录谷歌帐号,进入后在引导功能的时候,会出现,你点选择安装,它就开始下载了,等到进入启动界面,启动器就会加载这个APK,