zh en

HOWTO

This document will describe how to add new functionality to Easer, especially how to add new Event(s) (and Condition(s)) and/or Operation(s). It may also say something about the design of the structure of Easer.
(Notice: Profile is merely a collection of Operation(s), so if you want to extend the function of Profile, you just need to create new Operation(s).)

Additionally, v0.7.7 introduced USource to unify the authoring for Event and Condition. This mechanism is still consider as early stage, so this document does not describe it yet (but it’s similar to the previous ways).

Add new Event/Operation

In Easer, all Events and Operations are abstracted as skills, located in the package skills. More precisely, Events are under skills.eventOperations are under skills.operation.

You can use the provided scripts in the “utils” directory to automatically generate the skeleton of a skill; or creating everything manually.

Use the script

Under “utils” directory, two scripts are provided (new_event.py and new_operation.py) to automatically generate the skeleton of a new Event/Operation skill, as well as other related resources (e.g. tests). After executing the script, you only need to fill in each of the “TODO”s in the directory for the new skill. Then, after registering in LocalSkillRegistry (see below), the new skill will appear in Easer.

Detailed explaination of each component are presented below.

Detailed steps

In order to add a new Event or Operation, there are two main steps:

  1. Implement the functions of your new Event or Operation (by inheriting corresponding interfaces and implementing relevant contents)
  2. Register your new skill in skills.LocalSkillRegistry

Specifically:

To register you new skill in LocalSkillRegistry, you only need to add one line new code in its init() method (following existing codes).

Strongly recommend to follow the way that existing skills do and put your new skill into the relevant package.

Both EventSkill and OperationSkill are commented in some detail.

Either an EventSkill or OperationSkill will need to implement it relevant UI, by implementing a subclass of skills.SkillViewFragment.

Some common subclasses are already in skills or its sub-package. You can use them as you wish.

Skill, StorageData and DataFactory are the general interfaces, and only their sub-interfaces (e.g. EventSkill) will be used. Because each component of a skill will use its data, the data class (i.e. its subclass of [the sub-interface of] StorageData) will be used as the generics parameter.