Difference between revisions of "Features/Optional activity updates"
| (9 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
<noinclude> | <noinclude> | ||
| − | |||
[[Category:FeatureLanded|Optional activity updates]] | [[Category:FeatureLanded|Optional activity updates]] | ||
</noinclude> | </noinclude> | ||
| Line 20: | Line 19: | ||
''This proposal is based around the needs of the OLPC project in Australia, but reflects a common need (current or future) of other OLPC implementations as well.'' | ''This proposal is based around the needs of the OLPC project in Australia, but reflects a common need (current or future) of other OLPC implementations as well.'' | ||
| − | '''The problem:''' Previously, Daniel Drake implemented a mechanism for automatic activities updates. This was of great help for OLPC deployments such as Australia. However, the current mechanism will update (or install) ALL the activities in the updates list. This becomes a problem when not all the activities are intended for automatic updates, ie., when the bundle size is too big for massive automatic installation. | + | '''The problem:''' Previously, Daniel Drake implemented a mechanism for automatic activities updates. This was of great help for OLPC deployments such as Australia. However, the current mechanism will update (or install) ALL the activities in the updates list. This becomes a problem when not all the activities are intended for automatic updates, ie., when the bundle size is too big for massive automatic installation. In the practice deployments do not enable automatic updates because this kind of concerns. |
| − | The proposed solution is to provide a way to mark activities in the microformat file as | + | The proposed solution is to provide a way to mark activities in the microformat file as optional. Activities marked as optional will: |
* Not be updated or installed during automatic updates. | * Not be updated or installed during automatic updates. | ||
| Line 33: | Line 32: | ||
== Scope and implementation == | == Scope and implementation == | ||
| − | A initial implementation can be found in [https://github.com/tchx84/sugar/commits/optional-updates | + | A initial implementation can be found in [https://github.com/tchx84/sugar/commits/optional-updates here]. The changes are: |
* extend microformat parser to extract a new olpc-activity-optional field. | * extend microformat parser to extract a new olpc-activity-optional field. | ||
| Line 39: | Line 38: | ||
* filter activities that are marked as optional when running in automatic mode. | * filter activities that are marked as optional when running in automatic mode. | ||
* do not select activities marked as optional in the updater UI list. | * do not select activities marked as optional in the updater UI list. | ||
| + | |||
| + | This implementation is backwards compatible. Deployment that don't need to use this feature can simply ignore it. This field is used only on entries that need to be marked as optional. | ||
== How to test == | == How to test == | ||
| − | Modify your microformat file ( | + | Modify your microformat file (ie., wiki or [https://github.com/tchx84/bundletools bundletools]) and only mark optional activities entries as follows: |
<pre> | <pre> | ||
| Line 56: | Line 57: | ||
== User Experience == | == User Experience == | ||
| − | User experienced is untouched | + | User experienced is untouched. |
Latest revision as of 14:40, 20 April 2015
Summary
Extend microformat updater to be able to mark activities as optional for automatic updates.
Owner
- Martin Abente Lahaye
Current status
- Targeted release: 0.104
- Last updated: 05/08/2014
- Percentage of completion: 90%
Detailed Description
This proposal is based around the needs of the OLPC project in Australia, but reflects a common need (current or future) of other OLPC implementations as well.
The problem: Previously, Daniel Drake implemented a mechanism for automatic activities updates. This was of great help for OLPC deployments such as Australia. However, the current mechanism will update (or install) ALL the activities in the updates list. This becomes a problem when not all the activities are intended for automatic updates, ie., when the bundle size is too big for massive automatic installation. In the practice deployments do not enable automatic updates because this kind of concerns.
The proposed solution is to provide a way to mark activities in the microformat file as optional. Activities marked as optional will:
- Not be updated or installed during automatic updates.
- Not be selected by default in the activities updater UI.
Benefit to Sugar
The flexibility added by this feature will allow many deployments to enable the automatic updater, therefore users will benefit from receiving newer activities automatically.
Scope and implementation
A initial implementation can be found in here. The changes are:
- extend microformat parser to extract a new olpc-activity-optional field.
- extend BundleUpdate class to support this field so other updater components can access to this information.
- filter activities that are marked as optional when running in automatic mode.
- do not select activities marked as optional in the updater UI list.
This implementation is backwards compatible. Deployment that don't need to use this feature can simply ignore it. This field is used only on entries that need to be marked as optional.
How to test
Modify your microformat file (ie., wiki or bundletools) and only mark optional activities entries as follows:
<tr> <td class="olpc-activity-info"> <span class="olpc-activity-id">net.flossmanuals.LevelActivity</span> <span class="olpc-activity-version">1</span> <span class="olpc-activity-url"><a href="http://localhost:8000/some/deeper/path/bundles/level-1.xo">download</a></span> <span class="olpc-activity-optional">1</span> </td> </tr>
User Experience
User experienced is untouched.