Index: components/update_client/component_patcher.h |
diff --git a/components/update_client/component_patcher.h b/components/update_client/component_patcher.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..b7dd216df4a90386441a75bb390f940d09a1fe8b |
--- /dev/null |
+++ b/components/update_client/component_patcher.h |
@@ -0,0 +1,102 @@ |
+// Copyright 2014 The Chromium Authors. All rights reserved. |
+// Use of this source code is governed by a BSD-style license that can be |
+// found in the LICENSE file. |
+ |
+// Component updates can be either differential updates or full updates. |
+// Full updates come in CRX format; differential updates come in CRX-style |
+// archives, but have a different magic number. They contain "commands.json", a |
+// list of commands for the patcher to follow. The patcher uses these commands, |
+// the other files in the archive, and the files from the existing installation |
+// of the component to create the contents of a full update, which is then |
+// installed normally. |
+// Component updates are specified by the 'codebasediff' attribute of an |
+// updatecheck response: |
+// <updatecheck codebase="http://example.com/extension_1.2.3.4.crx" |
+// hash="12345" size="9854" status="ok" version="1.2.3.4" |
+// prodversionmin="2.0.143.0" |
+// codebasediff="http://example.com/diff_1.2.3.4.crx" |
+// hashdiff="123" sizediff="101" |
+// fp="1.123" /> |
+// The component updater will attempt a differential update if it is available |
+// and allowed to, and fall back to a full update if it fails. |
+// |
+// After installation (diff or full), the component updater records "fp", the |
+// fingerprint of the installed files, to later identify the existing files to |
+// the server so that a proper differential update can be provided next cycle. |
+ |
+#ifndef COMPONENTS_UPDATE_CLIENT_COMPONENT_PATCHER_H_ |
+#define COMPONENTS_UPDATE_CLIENT_COMPONENT_PATCHER_H_ |
+ |
+#include "base/callback_forward.h" |
+#include "base/macros.h" |
+#include "base/memory/ref_counted.h" |
+#include "base/memory/scoped_ptr.h" |
+#include "base/values.h" |
+#include "components/update_client/component_unpacker.h" |
+ |
+namespace base { |
+class FilePath; |
+} |
+ |
+namespace update_client { |
+ |
+class ComponentInstaller; |
+class DeltaUpdateOp; |
+class OutOfProcessPatcher; |
+ |
+// The type of a patch file. |
+enum PatchType { |
+ kPatchTypeUnknown, |
+ kPatchTypeCourgette, |
+ kPatchTypeBsdiff, |
+}; |
+ |
+// Encapsulates a task for applying a differential update to a component. |
+class ComponentPatcher : public base::RefCountedThreadSafe<ComponentPatcher> { |
+ public: |
+ // Takes an unpacked differential CRX (|input_dir|) and a component installer, |
+ // and sets up the class to create a new (non-differential) unpacked CRX. |
+ // If |in_process| is true, patching will be done completely within the |
+ // existing process. Otherwise, some steps of patching may be done |
+ // out-of-process. |
+ ComponentPatcher(const base::FilePath& input_dir, |
+ const base::FilePath& unpack_dir, |
+ ComponentInstaller* installer, |
+ scoped_refptr<OutOfProcessPatcher> out_of_process_patcher, |
+ scoped_refptr<base::SequencedTaskRunner> task_runner); |
+ |
+ // Starts patching files. This member function returns immediately, after |
+ // posting a task to do the patching. When patching has been completed, |
+ // |callback| will be called with the error codes if any error codes were |
+ // encountered. |
+ void Start(const ComponentUnpacker::Callback& callback); |
+ |
+ private: |
+ friend class base::RefCountedThreadSafe<ComponentPatcher>; |
+ |
+ virtual ~ComponentPatcher(); |
+ |
+ void StartPatching(); |
+ |
+ void PatchNextFile(); |
+ |
+ void DonePatchingFile(ComponentUnpacker::Error error, int extended_error); |
+ |
+ void DonePatching(ComponentUnpacker::Error error, int extended_error); |
+ |
+ const base::FilePath input_dir_; |
+ const base::FilePath unpack_dir_; |
+ ComponentInstaller* const installer_; |
+ scoped_refptr<OutOfProcessPatcher> out_of_process_patcher_; |
+ ComponentUnpacker::Callback callback_; |
+ scoped_ptr<base::ListValue> commands_; |
+ base::ValueVector::const_iterator next_command_; |
+ scoped_refptr<DeltaUpdateOp> current_operation_; |
+ scoped_refptr<base::SequencedTaskRunner> task_runner_; |
+ |
+ DISALLOW_COPY_AND_ASSIGN(ComponentPatcher); |
+}; |
+ |
+} // namespace update_client |
+ |
+#endif // COMPONENTS_UPDATE_CLIENT_COMPONENT_PATCHER_H_ |