Starting a UIAbility from the FA Model

This topic describes how the three application components of the FA model start the UIAbility component of the stage model.

PageAbility Starting a UIAbility

A PageAbility starts a UIAbility in the same way as it starts another PageAbility.

import featureAbility from '@ohos.ability.featureAbility';
import { BusinessError } from '@ohos.base';
import Want from '@ohos.app.ability.Want';
const TAG: string = '[EntryAbility]';

let want: Want = {
  bundleName: 'ohos.samples.etsclock',
  abilityName: 'MainAbility'
};
featureAbility.startAbility({ want }).then((code) => {
  Logger.info(TAG, 'Ability verify code: ' + JSON.stringify(code));
  console.info(TAG, 'Ability verify code: ' + JSON.stringify(code));
}).catch((error: BusinessError) => {
  Logger.error(TAG, 'Ability failed: ' + JSON.stringify(error));
  console.error(TAG, 'Ability failed: ' + JSON.stringify(error));
});

PageAbility Accessing a UIAbility (startAbilityForResult)

Different from startAbility(), startAbilityForResult() obtains the execution result when the UIAbility is destroyed.

A PageAbility starts a UIAbility through startAbilityForResult() in the same way as it starts another PageAbility through startAbilityForResult().

import featureAbility from '@ohos.ability.featureAbility';
import { BusinessError } from '@ohos.base';
import Want from '@ohos.app.ability.Want';
const TAG: string = '[EntryAbility]';

let want: Want = {
  bundleName: 'ohos.samples.etsclock',
  abilityName: 'MainAbility'
};
featureAbility.startAbilityForResult({ want }).then((result) => {
  Logger.info(TAG, 'Ability verify result: ' + JSON.stringify(result));
  console.info(TAG, 'Ability verify result: ' + JSON.stringify(result));
}).catch((error: BusinessError) => {
  Logger.error(TAG, 'Ability failed: ' + JSON.stringify(error));
  console.error(TAG, 'Ability failed: ' + JSON.stringify(error));
});

ServiceAbility or DataAbility Starting a UIAbility

A ServiceAbility or DataAbility starts a UIAbility in the same way as it starts a PageAbility.

import particleAbility from '@ohos.ability.particleAbility';
import { BusinessError } from '@ohos.base';
import Want from '@ohos.app.ability.Want';
const TAG: string = '[ServiceAbility]';

let want: Want = {
  bundleName: 'ohos.samples.etsclock',
  abilityName: 'MainAbility'
};
particleAbility.startAbility({ want }).then(() => {
  hilog.info(domain, TAG, 'ServiceAbilityStartUIAbility Start Ability successfully.');
  console.info(TAG, 'StartUIAbility Start Ability successfully.');
}).catch((error: BusinessError) => {
  hilog.info(domain, TAG, 'ServiceAbilityStartUIAbility Ability failed: ' + JSON.stringify(error));
  console.error(TAG, 'StartUIAbility Ability failed: ' + JSON.stringify(error));
});
hilog.info(domain, TAG, 'ServiceAbilityStartUIAbility ServiceAbility onStart');
console.info(TAG, 'StartUIAbility ServiceAbility onStart');