Android PAI (PlayAutoInstall)预装APK 功能

幼敏悟过人,读书辄成诵。这篇文章主要讲述Android PAI (PlayAutoInstall)预装APK 功能相关的知识,希望能为你提供帮助。
最近刚找到工作,是手机方案公司,刚接触手机系统预装的APP,以及解决方案MTK平台下预装APP的bug,也接触到了Launcher的东西。
然后接触到了第一个需求
【Android PAI (PlayAutoInstall)预装APK 功能】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
什么是PAIPAI(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,


    推荐阅读