Declares ability-related functions, including ability lifecycle callbacks and functions for connecting to or disconnecting from Particle Abilities.
As the fundamental unit of OpenHarmony applications, abilities are classified into Feature Abilities and Particle Abilities. Feature Abilities support the Page template, and Particle Abilities support the Service template. An ability using the Page template is called Page ability for short and that using the Service template is called Service ability.
Public Member Functions
Public Member Function Name
OnStart (const Want &want)
Called when this ability is started. You must override this function if you want to perform some initialization operations during ability startup.
Called when this ability enters the STATE_INACTIVE state.
OnActive (const Want &want)
Called when this ability enters the STATE_ACTIVE state.
Called when this ability enters the STATE_BACKGROUND state.
Called when this ability enters the STATE_STOP state.
OnConnect (const Want &want)
virtual const SvcIdentity
Called when this Service ability is connected for the first time.
OnDisconnect (const Want &want)
Called when all abilities connected to this Service ability are disconnected.
SetMainRoute (const std::string &entry)
Sets the main route for this ability.
SetUIContent (RootView rootView)
Sets the UI layout for this ability. You can call GetWindowRootView() to create a layout and add controls.
MsgHandle (uint32_t funcId, IpcIo request, IpcIo reply)
Handles a message sent by the client to this Service ability.
Dump (const std::string &extra)
Prints ability information to the console.
StartAbility (const Want &want)
Starts an Ability based on the specified Want information.
StopAbility (const Want &want)
Stops an Ability based on the specified Want information.
Destroys this Ability.
ConnectAbility (const Want &want, const IAbilityConnection &conn, void *data)
Connects to a Service ability based on the specified Want information.
DisconnectAbility (const IAbilityConnection &conn)
Disconnects from a Service ability.