java SystemUpdater 到 c++ updateEngine

一、java SystemUpdater
代码路径：packages/apps/Car/SystemUpdater
原生UI画面：setting ->
主要代码文件

这是android9上Google提供的一个apk，可以理解就是本地U盘测试update_engine升级的一个app。
这个app的主要作用就是：
1、读取U盘中的升级文件，用户点击目标升级文件。

2、调用updateEngine传递主要参数，收updateEngine的callback向用户显示升级升级进度

3、在升级结束之后通知powermanager重启机器。

分析代码：
在这里我们有一条重要的时序，就是java的updateEngine applyUpdate（）方法的调用关系，因为这个方法在U盘升级中负责将，升级文件的path和升级文件的size 、payload.bin的偏移量、hash值等传给c++的updateEngine。

DeviceListFragment.java
........
        @Override
        public ListItem get(int position) {
            if (position < 0 || position >= mListItems.size()) {
                return null;
            }
            TextListItem item = new TextListItem(mContext);
            File file = mListItems.get(position);
            if (file != null) {
                item.setTitle(file.getName());
                item.setOnClickListener(v -> onFileSelected(file)); //item选中了我们的升级文件
            } else {
                item.setTitle(getString(R.string.unknown_file));
            }
            return item;
        }
  .......

    private void onFileSelected(File file) {
        if (isUpdateFile(file)) {
            mFileStack.clear();
            mSystemUpdater.applyUpdate(file); //调到了SystemUpdaterActivity中的applyUpdate（）传入升级文件的path
        } else if (file.isDirectory()) {
            showFolderContent(file);
            mFileStack.push(file);
        } else {
            Toast.makeText(getContext(), R.string.invalid_file_type, Toast.LENGTH_LONG).show();
        }
    }
.........

SystemUpdaterActivity.java
.........
    public void applyUpdate(File file) {
        UpdateLayoutFragment fragment = UpdateLayoutFragment.getInstance(file);  //得到UpdateLayoutFragment对象，将升级文件路径传递给UpdateLayoutFragment 
        getSupportFragmentManager().beginTransaction()
                .replace(R.id.device_container, fragment, FRAGMENT_TAG)
                .addToBackStack(null)
                .commit();
    }
........

UpdateLayoutFragment.java
..........
    @Override
    public void onActivityCreated(Bundle savedInstanceState) {
.............
        if (getArguments().getBoolean(EXTRA_RESUME_UPDATE)) {
            // Rejoin the update already in progress.
            showInstallationInProgress();
        } else {
            // Extract the necessary information and begin the update.
            mPackageVerifier.execute(mUpdateFile);  //异步执行UpdateVerifier的方法doInBackground和onPostExecute
        }
    }
.............

UpdateVerifier.java //这个类里的这个方法都是比价重要的
        @Override
        protected UpdateParser.ParsedUpdate doInBackground(File... files) { 
            Preconditions.checkArgument(files.length > 0, "No file specified");
            File file = files[0];
            try {
                return UpdateParser.parse(file); //在UpdateParser的parse解析升级文件
            } catch (IOException e) {
                Log.e(TAG, String.format("For file %s", file), e);
                return null;
            }
        }

        @Override
        protected void onPostExecute(UpdateParser.ParsedUpdate result) {
            mProgressBar.setVisibility(View.GONE);
            if (result == null) {
                showStatus(R.string.verify_failure);
                return;
            }
            if (!result.isValid()) {
                showStatus(R.string.verify_failure);
                Log.e(TAG, String.format("Failed verification %s", result));
                return;
            }
            if (Log.isLoggable(TAG, Log.INFO)) {
                Log.i(TAG, result.toString());
            }

            showInstallNow(result); //解析升级之后在这个方法里面简洁调用UpdateEngine.applyPayload（）
        }
    }

UpdateParser.java
    static ParsedUpdate parse(@NonNull File file) throws IOException {
        Preconditions.checkNotNull(file);

        long payloadOffset = 0;
        long payloadSize = 0;
        boolean payloadFound = false;
        String[] props = null;

        try (ZipFile zipFile = new ZipFile(file)) {
            Enumeration<? extends ZipEntry> entries = zipFile.entries();
            while (entries.hasMoreElements()) {
                ZipEntry entry = entries.nextElement();
                long fileSize = entry.getCompressedSize();
                if (!payloadFound) {
                    payloadOffset += ZIP_FILE_HEADER + entry.getName().length();
                    if (entry.getExtra() != null) {
                        payloadOffset += entry.getExtra().length;
                    }
                }

                if (entry.isDirectory()) {
                    continue;
                } else if (entry.getName().equals(PAYLOAD_BIN_FILE)) {
                    payloadSize = fileSize; // 得到 PAYLOAD_BIN_FILE（payload.bin）的文件大小
                    payloadFound = true;
                } else if (entry.getName().equals(PAYLOAD_PROPERTIES)) {
                    try (BufferedReader buffer = new BufferedReader(
                            new InputStreamReader(zipFile.getInputStream(entry)))) {
                        props = buffer.lines().toArray(String[]::new); //得到hash值
                    }
                }
                if (!payloadFound) {
                    payloadOffset += fileSize; //在没有遍历到payload.bin之前，前面的文件都是记录为偏移量
                }

                if (Log.isLoggable(TAG, Log.DEBUG)) {
                    Log.d(TAG, String.format("Entry %s", entry.getName()));
                }
            }
        }
        return new ParsedUpdate(file, payloadOffset, payloadSize, props);  //关于这几个参数后面会讲到
    }

frameworks/base/core/java/android/os/UpdateEngine.java
//从UpdateLayoutFragment的showInstallNow（） ——> installUpdate() 到 updateEngine的applyPayload（）
    public void applyPayload(String url, long offset, long size, String[] headerKeyValuePairs) {
        try {
            mUpdateEngine.applyPayload(url, offset, size, headerKeyValuePairs); // 是从serviceManager中拿到的
        } catch (RemoteException e) {
            throw e.rethrowFromSystemServer();
        }
    }
    public UpdateEngine() {
        mUpdateEngine = IUpdateEngine.Stub.asInterface(
                ServiceManager.getService(UPDATE_ENGINE_SERVICE)); //是c++层的updateEngine注册到serviceManager中的
    }

接下来把上面systemUpdater调到updateEngine的时序图画一下。

二、java updateEngine到c++ updateEngine
这部分比较简单，c++ updateEngine（其实是BinderUpdateEngineAndroidService）会将自己注册到serviceManager中去，然后Java updateEngine通过binder调用， ServiceManager.getService(UPDATE_ENGINE_SERVICE))，得到c++ updateEngine的代理对象。
代码分析：

UpdateEngine.java
.............
    public UpdateEngine() {
        mUpdateEngine = IUpdateEngine.Stub.asInterface(
                ServiceManager.getService(UPDATE_ENGINE_SERVICE)); //得到update_engine service
    }
    
     @SystemApi
    public boolean bind(final UpdateEngineCallback callback, final Handler handler) { // UpdateEngineCallback 在 UpdateLayoutFragment.java中实现了，具体的回调通知流程就是 BinderUpdateEngineAndroidService ->  UpdateEngineCallback -> CarUpdateEngineCallback
        synchronized (mUpdateEngineCallbackLock) {
            mUpdateEngineCallback = new IUpdateEngineCallback.Stub() {  //BinderUpdateEngineAndroidService提供的代码路径在 system/update_engin/binder_service_android.cc
                @Override
                public void onStatusUpdate(final int status, final float percent) {
                    if (handler != null) {
                        handler.post(new Runnable() {
                            @Override
                            public void run() {
                                callback.onStatusUpdate(status, percent);
                            }
                        });
                    } else {
                        callback.onStatusUpdate(status, percent);
                    }
                }

                @Override
                public void onPayloadApplicationComplete(final int errorCode) {
                    if (handler != null) {
                        handler.post(new Runnable() {
                            @Override
                            public void run() {
                                callback.onPayloadApplicationComplete(errorCode);
                            }
                        });
                    } else {
                        callback.onPayloadApplicationComplete(errorCode);
                    }
                }
            };

            try {
                return mUpdateEngine.bind(mUpdateEngineCallback); //mUpdateEngineCallback 注册到BinderUpdateEngineAndroidService，后面升级的进度会通过这个回调通知。
            } catch (RemoteException e) {
                throw e.rethrowFromSystemServer();
            }
        }
    }
................