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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
|
Release notes
=============
Changes in version 0.6.9
========================
- Added support for ChildScopes scope .ini option to list scopes ids of aggregated scopes.
Changes in version 0.6.8
========================
- Replaced dbus-send with "list updated" pub/sub to invalidate smart scopes.
Changes in version 0.6.7
========================
- OnlineAccountClient fixes: run the internal event loop within its own context to avoid
clashing with external main loop (LP: #1377147).
- Introduced new dependencies on dbus-test-runner and libdbustest1-dev.
- Fix for Zmq infinite reconnection problem (LP: #1374206)
Changes in version 0.6.6
========================
- Added support for online accounts (via new OnlineAccountClient class).
Changes in version 0.6.5
========================
- Implemented support for expandable preview widgets. See the documentation of PreviewWidget
for details of the new widget type.
Changes in version 0.6.3
========================
- Fix scope cache path for confined scopes.
Changes in version 0.6.2
========================
- Move scope configuration to ~/.config/unity-scopes/
- New setting to enable/disable of location data being fed to scopes.
- New DebugMode scope configuration option.
Changes in version 0.6.1
========================
- Clear any signal masks inherited from the parent process when forking.
- Allow timeout value of -1 to disable the scope idle timeout, reaper timeouts, and two-way invocation timeout.
Changes in version 0.6.0
========================
- Added tmp_directory() method to ScopeBase, so a scope can find out where it can write temporary files.
- Added cache_directory() method to ScopeBase, so a scope can find out where it can write its files.
- Upgraded finished() callback to be more flexible and expandable.
- Refactored scoperunner and ScopeLoader. ScopeLoader no longer knows about the registry and
scoperunner now calls RuntimeImpl::run_scope() to set the scope running, instead of duplicating
lots of functionality.
- Removed registry parameter from ScopeBase::start(). The registry is now available via a registry()
accessor on ScopeBase. The original start() method is still present, but deprecated. The default
implementation of the new start() method forwards to the old one so, if a scope implements only the
old one but not the new one, things still work.
- Made methods on ScopeBase virtual, so the testing framework can override them in a test scope.
- Added support for additional query reply info.
- Introduced QueryMetadata base for shared functionality of *Metadata classes.
- Added set_internet_connectivity() and internet_connectivity() to QueryMetadata.
Changes in version 0.5.2
========================
- Added CannedQuery parameter to Category.
- Added support for scope settings.
- Added Registry.Timeout configuration parameter to Zmq.ini.
Changes in version 0.5.1
========================
- Support nested dictionaries in appearance attributes of scope metadata. To define nested dictionary, use dots in key names in [Appearance] section of
scope .ini file, e.g. "PageHeader.Logo" = "logo.svg" creates "Logo" attribute inside "PageHeader" dictionary of appearance attributes.
Changes in version 0.5.0
========================
- Changed ScopeBase::start() method to return void instead of int, and made both start() and stop() methods virtual instead of pure virtual.
- Moved all filter classes except for OptionSelectorFilter into experimental namespace, since they are not currently supported by the Shell
and their API may get changed.
- Moved Annotation class into experimental namespace. Annotations are not currently supported by the shell and should not be used as their API
may change or get removed.
- removed deprecated SearchReply::register_annotation() method.
- Changes to departments API: SearchReply::register_departments() method now takes parent department argument only,
and uses Department::SCPtr for it. SearchListenerBase::push() method for departments got changed to match as well. Removed
constructors of Department and added static create() methods instead. Changed DepartmentList to hold Department
pointers instead of values. Changed Department::set_has_subdepartments() method to take bool value (true by default).
- Changed parameter type for pushing categories on SearchListenerBase to Category::SCPtr const&.
- Changed constructor of SearchQueryBase to take CannedQuery and SearchMetadata arguments.
Changed constructor of PreviewQueryBase to take Result and ActionMetadata arguments. Changed ActivationQueryBase constructor to take Result, widget id and
action id argument. All the constructor arguments are then available via respective getters of the base classes.
Changes in version 0.4.8
========================
- Introduced Dir/ScopesWatcher classes to watch for updates to the scope install directories, and added API to subscribe to changes in registry.
Changes in version 0.4.7
========================
- Implemented RatingFilter and RadioButtonsFilter.
- changed create() methods of OptionSelectorFilter and RangeInputFilter to return unique_ptr (UPtr)
instead of shared pointers.
Changes in version 0.4.6
========================
- Added method to get and set display hints for filters (at this moment the only display hint
available is Primary hint).
- Added has_subdepartments flag and alternate label to Department class.
- Added TTL option for scope results.
Changes in version 0.4.5
========================
- Implemented RangeInputFilter.
Changes in version 0.4.4
========================
- The register_annotation() method of SearchReply is now deprecated - push(Annotation const&) should
be used instead. The display order of annotations with respect to results and categories
got updated in the documentation of that method.
- Simplified configuration with sensible defaults for all values.
- scoperunner, scoperegistry, and smartscopesproxy are now install in /usr/lib/\<arch\>
(instead of in a subdirectory of \<arch\>).
- Runtime::run_scope() now has an overload to accept a path to Runtime.ini. If no file name is passed,
the system-wide Runtime.ini is used.
- UNIX domain sockets for Zmq are now placed under /user/run/\<uid\>/zmq by default.
Changes in version 0.4.2
========================
- Made the scope search, activate, perform_action, and preview methods non-blocking.
A (fake) QueryCtrl is returned immediately from these methods now. Calling cancel() before
the server has finished creating the query remembers the cancel and sends it to the
server once the server has returned the real QueryCtrl. This change should be transparent
to application code (the only difference being that these methods complete faster now).
- CannedQuery class can now be converted to and from a scopes:// uri with to_uri() and from_uri() methods.
These methods replace to_string() and from_string() methods that got removed.
Changes in version 0.4.0
========================
- Re-factored proxy class implementation. These changes are API compatible, but not ABI compatible.
- Renaming of various API elements for consistency and clarity:
PreviewWidget::add_attribute() -> PreviewWidget::add_attribute_value()
PreviewWidget::attributes() -> PreviewWidget::attribute_values()
PreviewWidget::add_component() -> PreviewWidget::add_attribute_mapping()
PreviewWidget::components() -> PreviewWidget::attribute_mappings()
ActivationListener -> ActivationListenerBase
ActivationListenerBase::activation_response() -> ActivationListenerBase::activated()
PreviewListener -> PreviewListenerBase
SearchListener -> SearchListenerBase
PreviewQuery -> PreviewQueryBase
SearchQuery -> SearchQueryBase
ActivationBase -> ActivationQueryBase
ReplyBase -> Reply
RegistryBase -> Registry
Query -> CannedQuery
CannedQuery::scope_name() -> CannedQuery::scope_id()
ScopeMetadata::scope_name() -> CannedQuery::scope_id()
Scope::create_query() -> Scope::search()
ScopeBase::create_query() -> ScopeBase::search()
SearchQuery::create_subquery() -> SearchQuery::subsearch()
Variant::Type: changed ordinal values of enumerators
Changes in version 0.3.2
========================
- ActivationResponse::set_scope_data(Variant const&) and scope_data() methods
have been added; they are meant to replace setHints() and hints() and use
Variant instead of VariantMap for arbitrary scope data.
The existing ActivationResponse::setHints(VariantMap const&) and hints()
methods have been marked as deprecated and for removal in 0.4.0.
Changes in version 0.3.1
========================
- Scope::activate_preview_action() and ScopeBase::activate_preview_action() were
renamed to perform_action(). They now also require widget identifier
along with action id and hints.
- Added SearchMetadata and ActionMetadata classes; these classes are now passed
to create_query(), activate(), perform_action(), preview() methods of
ScopeBase and Scope (ScopeProxy) instead of a plain VariantMap.
- The 'Handled' state was removed from ActivationResponse::Status and two new
values were added instead: ShowDash and HideDash.
- Annotation API changes: annotations of 'Card' type were removed and Annotation
doesn't support category attribute anymore. SearchReply::push() method for
annotations was renamed to register_annotation(). Annotations are now going to
be displayed in the order they were registered by scopes.
- Result::activation_scope_name() method was renamed to target_scope_proxy() and
it now returns ScopeProxy instead of a string. Client code can now use that
proxy for result activation or preview calls, instead of having to do an extra
registry lookup.
Changes in version 0.3.0
========================
- Preliminary API for filters has been added via OptionSelectorFilter and
FilterState classes. This part of the API is not yet supported by Unity shell
and should be considered highly experimental.
- ScopeBase::create_query() method now takes Query object instance instead of
just a search query string. Search query string is now encapsulated in the
Query class and can be retrieved via Query::query_string().
- ScopeProxy class provides overloaded create_query methods for passing filter
state and department id. Note: departments are not yet supported across the
API.
- The scoperegistry allows extra scopes to be added on the command line now:
$ scoperegistry some/path/Runtime.ini some/other/path/Fred.ini Joe.ini
This loads Fred and Joe scopes in addition to any scopes picked up
via the normal configuration. If Fred or Joe appear in configuration
as well as on the command line, the config file on the command line
takes precedence. The .so for additional scopes is expected to be
in the same directory as the corresponding .ini file.
|