Android PAI （PlayAutoInstall）预装APK 功能

Posted 2021-02-09 leo21sun

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

然后接触到了第一个需求

PAI预装APK功能

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

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

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

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的制作。

 

 

PAI流程

 

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

配置菜单

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

需要的配置信息包括：

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

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

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

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

关于其余配置，参考下面表格：

下面具体放代码：分为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签名）
• 不能定义权限/活动/其他接收者/内容提供者/服务
•  

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商店中发布的，并且对该地区用户可见
• 不能定义权限/活动/其他接收者/内容提供者/服务

 

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>

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，