在AOSP Settings中添加自定义OTA客户端的技术实现及示例问询

下面是完整的实操代码示例和参考案例，覆盖Settings入口添加、OTA核心逻辑实现：

一、在Settings中添加更新入口 #

要让用户在Settings里找到自定义OTA功能，需要完成以下几步：

1. 定义Preference布局 #

在packages/apps/Settings/res/xml/下新建custom_ota_settings.xml：

<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen xmlns:android="http://schemas.android.com/apk/res/android">
    <Preference
        android:key="custom_ota_check_update"
        android:title="@string/custom_ota_check_title"
        android:summary="@string/custom_ota_check_summary"
        android:icon="@drawable/ic_system_update" />
</PreferenceScreen>

2. 添加字符串资源 #

在packages/apps/Settings/res/values/strings.xml中补充：

<string name="custom_ota_check_title">检查自定义更新</string>
<string name="custom_ota_check_summary">检查设备的自定义系统更新</string>

3. 创建Settings页面逻辑 #

在packages/apps/Settings/src/com/android/settings/system/下创建CustomOtaSettings.java：

package com.android.settings.system;

import android.os.Bundle;
import android.preference.Preference;
import android.preference.PreferenceScreen;

import com.android.settings.R;
import com.android.settings.SettingsPreferenceFragment;

public class CustomOtaSettings extends SettingsPreferenceFragment implements Preference.OnPreferenceClickListener {

    private Preference mCheckUpdatePref;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        addPreferencesFromResource(R.xml.custom_ota_settings);

        mCheckUpdatePref = findPreference("custom_ota_check_update");
        mCheckUpdatePref.setOnPreferenceClickListener(this);
    }

    @Override
    public boolean onPreferenceClick(Preference preference) {
        if (preference == mCheckUpdatePref) {
            CustomOtaManager.getInstance(getActivity()).checkForUpdates();
            return true;
        }
        return false;
    }
}

4. 注册入口到Settings菜单 #

修改packages/apps/Settings/src/com/android/settings/Settings.java，添加内部类：

// 放在System相关的Activity定义区域
public static final class CustomOtaSettingsActivity extends SettingsActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        getFragmentManager().beginTransaction().replace(android.R.id.content, new CustomOtaSettings()).commit();
    }
}

同时在packages/apps/Settings/AndroidManifest.xml中注册该Activity：

<activity android:name=".Settings$CustomOtaSettingsActivity"
          android:label="@string/custom_ota_check_title"
          android:parentActivityName=".Settings">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
    <meta-data android:name="com.android.settings.category"
               android:value="com.android.settings.category.system" />
    <meta-data android:name="com.android.settings.order"
               android:value="100" />
</activity>

二、自定义OTA核心逻辑实现 #

创建CustomOtaManager.java放在packages/apps/Settings/src/com/android/settings/system/，封装更新检查、下载逻辑：

package com.android.settings.system;

import android.content.Context;
import android.os.AsyncTask;
import android.util.Log;
import android.widget.Toast;

import org.json.JSONObject;

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class CustomOtaManager {
    private static final String TAG = "CustomOtaManager";
    // 替换为你的OTA服务器地址
    private static final String UPDATE_CHECK_URL = "https://your-ota-server.com/check_update";
    private static CustomOtaManager sInstance;
    private Context mContext;

    private CustomOtaManager(Context context) {
        mContext = context.getApplicationContext();
    }

    public static synchronized CustomOtaManager getInstance(Context context) {
        if (sInstance == null) {
            sInstance = new CustomOtaManager(context);
        }
        return sInstance;
    }

    public void checkForUpdates() {
        new CheckUpdateTask().execute();
    }

    private class CheckUpdateTask extends AsyncTask<Void, Void, String> {
        @Override
        protected String doInBackground(Void... voids) {
            try {
                URL url = new URL(UPDATE_CHECK_URL);
                HttpURLConnection conn = (HttpURLConnection) url.openConnection();
                conn.setRequestMethod("GET");
                conn.setConnectTimeout(5000);

                if (conn.getResponseCode() == HttpURLConnection.HTTP_OK) {
                    BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream()));
                    StringBuilder sb = new StringBuilder();
                    String line;
                    while ((line = reader.readLine()) != null) {
                        sb.append(line);
                    }
                    reader.close();
                    return sb.toString();
                }
            } catch (Exception e) {
                Log.e(TAG, "Update check failed", e);
            }
            return null;
        }

        @Override
        protected void onPostExecute(String result) {
            super.onPostExecute(result);
            if (result != null) {
                try {
                    JSONObject updateInfo = new JSONObject(result);
                    boolean hasUpdate = updateInfo.getBoolean("has_update");
                    String versionName = updateInfo.getString("version_name");
                    String downloadUrl = updateInfo.getString("download_url");

                    if (hasUpdate) {
                        Toast.makeText(mContext, "发现新版本: " + versionName, Toast.LENGTH_LONG).show();
                        startDownload(downloadUrl);
                    } else {
                        Toast.makeText(mContext, "当前已是最新版本", Toast.LENGTH_SHORT).show();
                    }
                } catch (Exception e) {
                    Log.e(TAG, "Parse update info failed", e);
                    Toast.makeText(mContext, "更新检查失败", Toast.LENGTH_SHORT).show();
                }
            } else {
                Toast.makeText(mContext, "无法连接到更新服务器", Toast.LENGTH_SHORT).show();
            }
        }
    }

    private void startDownload(String downloadUrl) {
        // 这里可以扩展为完整的下载逻辑，比如使用系统DownloadManager
        // 以下是示例框架，可根据需求完善
        Toast.makeText(mContext, "开始下载更新包: " + downloadUrl, Toast.LENGTH_SHORT).show();
    }
}

三、开源参考案例 #

• LineageOS Updater：代码位于AOSP衍生ROM的packages/apps/Updater，涵盖完整的OTA流程（检查、下载、验证、Recovery安装），以及与Settings的集成方式，适合学习生产级OTA实现。
• AOSP原生SystemUpdater：路径packages/apps/SystemUpdater，官方OTA实现，可了解AOSP原生更新框架的对接逻辑，比如与PackageManager、Recovery的交互。
• MicroG UnifiedNlp OTA：轻量级OTA客户端实现，侧重后台静默检查、增量更新逻辑，适合资源受限场景的参考。

内容的提问来源于stack exchange，提问作者Mehran Alidoost Nia