项目地址：https://github.com/aystshen/Android-RomUpgrade

这是一个负责 Android OTA 升级的后台应用，开机后自动运行后台 Service，支持系统升级和应用升级，支持本地升级（tf卡、u盘）和在线升级（百度），支持推荐升级和静默升级。

已知兼容版本：

• Android 5.1
• Android 6.0
• Android 7.1
• Android 8.1

预览

本地升级（tf卡、u盘）

image.png

在线升级（百度）

image.png

image.png

API

此固件升级应用也对外提供下面 API，供第三方应用调用 安装、验证、删除 升级包。

// IRomUpgradeService.aidl
package com.ayst.romupgrade;

// Declare any non-default types here with import statements

interface IRomUpgradeService {
    public void checkUpdate();
    boolean installPackage(String packagePath);
    boolean verifyPackage(String packagePath);
    void deletePackage(String packagePath);
}

API使用

1. 在 APP 源码 **aidl/com/ayst/romupgrade **目录下新建 IRomUpgradeService.aidl，如下：

// IRomUpgradeService.aidl
package com.ayst.romupgrade;

// Declare any non-default types here with import statements

interface IRomUpgradeService {
    public void checkUpdate();
    boolean installPackage(String packagePath);
    boolean verifyPackage(String packagePath);
    void deletePackage(String packagePath);
}

2. 实现下面代码：

Intent intent = new Intent();
intent.setPackage("com.ayst.romupgrade");
intent.setAction("com.ayst.romupgrade.UPGRADE_SERVICE");
mContext.bindService(intent, mRomUpgradeServiceConnection, Context.BIND_AUTO_CREATE);

private ServiceConnection mRomUpgradeServiceConnection = new ServiceConnection() {
    @Override
    public void onServiceConnected(ComponentName name, IBinder service) {
        Log.d(TAG, "IRomUpgradeService, onServiceConnected...");
        mRomUpgradeService = IRomUpgradeService.Stub.asInterface(service);
    }

    @Override
    public void onServiceDisconnected(ComponentName name) {
        Log.d(TAG, "IRomUpgradeService, onServiceDisconnected...");
        mRomUpgradeService = null;
    }
};

/**
 * 检查升级
 * 接口为异步操作，无法直接返回检查结果，当有新版本可升级时直接弹出升级提示窗
 */
public void checkUpdate() {
    if (null != mRomUpgradeService) {
        try {
            mRomUpgradeService.checkUpdate();
        } catch (RemoteException e) {
            e.printStackTrace();
        }
    }
}

/**
 * 安装升级
 *
 * @param packagePath ota升级包
 * @return
 */
public boolean installPackage(String packagePath) {
    if (null != mRomUpgradeService) {
        try {
            return mRomUpgradeService.installPackage(packagePath);
        } catch (RemoteException e) {
            e.printStackTrace();
        }
    }

    return false;
}

/**
 * 验证升级包
 *
 * @param packagePath ota升级包
 * @return
 */
public boolean verifyPackage(String packagePath) {
    if (null != mRomUpgradeService) {
        try {
            return mRomUpgradeService.verifyPackage(packagePath);
        } catch (RemoteException e) {
            e.printStackTrace();
        }
    }

    return false;
}

/**
 * 删除升级包
 *
 * @param packagePath ota升级包
 */
public void deletePackage(String packagePath) {
    if (null != mRomUpgradeService) {
        try {
            mRomUpgradeService.deletePackage(packagePath);
        } catch (RemoteException e) {
            e.printStackTrace();
        }
    }
}

集成

这里讲述如何将此升级应用内置到您定制的系统固件中。

前提条件

• 系统签名
• root 权限（应用升级默认采用静默安装，因此需要 root 权限）

内置

1. 编译 release 版本 apk 文件（或者直接下载已发布的 release 版本）。
2. 在 Android 源码 vendor/xxx/common/apps/ 路径下新建“RomUpgrade”目录。
3. 将升级应用 apk 文件复制到“RomUpgrade”目录，并重命名为“RomUpgrade.apk”。
4. 将升级应用 apk 文件中的 so 库提取出来，复制到“RomUpgrade/lib/arm/”（如果是64系统请提取64库到“RomUpgrade/lib/arm64/”）。
5. 新建 Android.mk 文件，内容如下：

LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := RomUpgrade
LOCAL_MODULE_CLASS := APPS
LOCAL_MODULE_TAGS := optional
LOCAL_BUILT_MODULE_STEM := package.apk
LOCAL_MODULE_SUFFIX := $(COMMON_ANDROID_PACKAGE_SUFFIX)
#LOCAL_PRIVILEGED_MODULE :=
LOCAL_CERTIFICATE := PRESIGNED
#LOCAL_OVERRIDES_PACKAGES := 
LOCAL_SRC_FILES := $(LOCAL_MODULE).apk
#LOCAL_REQUIRED_MODULES :=
LOCAL_PREBUILT_JNI_LIBS := \
        lib/arm/libotaso.so \
        lib/arm/libnative-lib.so
include $(BUILD_PREBUILT)

6. 修改 vendor/xxx/common/apps/apps.mk，如下：

PRODUCT_PACKAGES += \
    RomUpgrade

配置属性

将下面属性配置到系统 build.prop 中：

# 百度ota平台产品线id
ro.baidu.product.id=10000

# 百度ota平台产品线密钥
ro.baidu.product.secret=NTUyOGFhOTVjODRlxxxxxx==

# 可升级的内置应用包名（多个包名通过逗号分隔，无应用升级可不配）
ro.baidu.presetapp=com.ayst.sample1,com.ayst.sample2

# 系统固件版本号
ro.fw.version=1.0.0

使用

本地升级（tf卡、u盘）

本地应用升级

1. 在 tf 卡或 u 盘根目录新建“exupdate”目录。
2. 将待安装 apk 文件复制到“exupdate”目录下。
3. 插入 tf 卡或u盘插入 Android 设备。
4. 等待5秒左右，会弹出升级提示对话框，请根据提示完成升级。

本地系统升级

1. 将待升级系统 ota 包复制到 tf 卡或 u 盘目录下，并重命名为“update.zip”。
2. 插入 tf 卡或 u 盘插入 Android 设备。
3. 等待5秒左右，会弹出升级提示对话框，请根据提示完成升级。

本地应用与系统同时升级

1. 在 tf 卡或 u 盘根目录新建“exupdate”目录。
2. 将待安装 apk 文件复制到“exupdate”目录下。
3. 将待升级系统 ota 包复制到 tf 卡或 u 盘目录下，并重命名为“update.zip”。
4. 插入 tf 卡或 u 盘插入Android设备。
5. 等待5秒左右，会弹出升级提示对话框，请根据提示完成升级。

配置推荐升级或静默升级

1. 在tf卡或u盘根目录新建“exupdate”目录。
2. 在“exupdate”目录下新建“config.ini”文件，文件内容如下：

#升级类型，1：推荐升级，2：静默升级
UPDATE_TYPE=2

配置升级包版本号

此版本号可以配可以不配。如果配置了该版本号则当前系统版本小于此版本时才会升级，否则不升级。如果没有配置该版本号则一律升级。

#OTA升级包版本号，如：1.0.0
PACKAGE_VERSION=1.0.0

在线系统升级（百度）

注册百度OTA平台账号

注册 百度安全 OTA 平台 账号，申请开通产品线，将『产品线ID』和『产品线秘钥』通过属性配置到系统。

上传升级包

进入对应 『产品线』配置页面，进入『升级资源库』，点击『上传升级包』。

image.png

参数说明：

• 上传文件 选择 OTA 升级包文件（应用升级请上传 apk 文件）。
• 类型 勾选『系统升级』『整包』。
• 版本号 版本号格式：1.0.0.0，不足4段补0（系统固件的版本号默认从『ro.topband.sw.version』属性读取）。
• 标签 忽略。

配置测试任务

添加测试设备分组

进入『设备分组管理->测试设备分组』，点击『添加测试设备分组』，勾选『填写设备ID』。

image.png

参数说明：

• 设备ID ** CPU 序号。可以通过命令『cat /proc/cpuinfo**』查看。

创建测试任务

进入『测试任务列表』，点击『创建测试任务』。
参数说明：

• 任务名称 自定义。
• 升级范围 勾选『指定测试设备分组』，点击『选择设备分组』，选择上一步添加的『测试设备』分组。
• 升级类型 选择『系统升级』『整包升级』。
• 系统升级资源 点击『资源库选择』，选择上一步上传的升级包。
• 升级方式 勾选『提示升级』。如果不希望 Android 弹出升级提示，而是直接安装升级包，可以勾选『静默升级』。
• 升级提示 一般填写此次升级的修改点，当 Android 弹出升级提示时，会显示这些内容。
• 优先级 默认值。

设备端检查升级

确保设备端网络连接正常，重启设备后会立即检查升级（稍后会每30分钟检查一次），当检查到新版本升级时，会弹出下面升级提示框：

image.png

点击『立即升级』开始下载，下载完成后将自动重启安装（安装过程中切勿断电）。

image.png

配置正式任务

测试任务验证正常后，按照同样方法配置正式任务即可。

在线应用升级（百度）

应用升级配置步骤同配置系统升级。唯一需要注意的是支持配置应用安装完成后动作，比如：安装后重启系统，安装后重新启动应用。

配置应用安装后动作

升级配置界面，滚动到『其他配置』项，打开『自定义字段』，按下面表格配置『字段名称』和『值』，点击『添加』。

image.png