1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
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_
|
