application-dev/faqs/faqs-ability.md

# Application Model Development


## How do I obtain a notification when the device orientation changes? (API version 9)

**Solution**

Use the **UIAbility.onConfigurationUpdate()** callback to subscribe to system environment variable changes (including the language, color mode, and screen orientation).

**References**

[Subscribing to System Environment Variable Changes](../application-models/subscribe-system-environment-variable-changes.md#using-uiability-for-subscription)


## How do I redirect a user to a specified page after they touch a service widget? (API version 9)

**Solution**

Configure a widget event with the redirected-to UIAbility specified, and call **loadContent** in the **onWindowStageCreate()** callback of the target UIAbility to redirect to the specified page.

**References**

[Configuring Widget Configuration Files](../form/arkts-ui-widget-configuration.md)


## How do I create a background service in the stage model? (API version 9)

**Symptom**

**ServiceExtensionAbility** in the stage model is a system API. Therefore, third-party applications cannot use it to create a background service.

**Solution**

Create a background task to provide the background service.

**References**

[Background Task](../task-management/background-task-overview.md)


## Can I create a UIAbility and specify the process to run the UIAbility in the FA and Stage models? (API version 9)

**Solution**

Yes.

- FA model

  The FA model supports multiple processes. By default, all components of an application run in the same process. This default scenario is suitable for most applications. To run a specific component in an independent process, configure the **process** tag under **ability** in the configuration file. Note that this tag is available only for system applications.

- Stage model

  The stage model supports multiple processes. The process model is defined by the system, and third-party applications cannot be configured with multiple processes. To customize an independent process, you must request special permissions, and then specify the **process** tag under **module** in the configuration file. This tag specifies the process in which all the abilities in an HAP run. If this tag is not set, the bundle name is used as the process name by default.


## What are the differences between the stage model and the FA model in intra-process object sharing? (API version 9)

**Solution**

- In the stage model, multiple application components share the same ArkTS engine instance. Therefore, they can easily share objects and state with each other. This also reduces the memory usage of complex applications.

- In the FA model, each application component exclusively uses an ArkTS engine instance. Therefore, you are advised to use the stage model when developing complex applications in distributed scenarios.

**References**

[Data Synchronization Between UIAbility and UI](../application-models/uiability-data-sync-with-ui.md)


## How do I use the lifecycle functions of AbilityStage? (API version 9)

**Solution**

Add the field **"srcEntry": "./ets/myabilitystage/MyAbilityStage.ts"** under **module** in the **module.json5** file.

**References**

[AbilityStage Component Container](../application-models/abilitystage.md)


## How do I delete the mission snapshot in Recents after terminateself is called in the multiton scenario? (API version 9)

**Solution**

You can set **removeMissionAfterTerminate** to **true** in the **module.json5** file.


## How do I prevent "this" in a method from changing to "undefined" when the method is called? (API version 9)

**Solution**

Method 1: Add **.bind(this)** when calling the method.

Method 2: Use the arrow function.


## What should I do when the error message "must have required property 'startWindowIcon'" is displayed during the UIAbility startup? (API version 9)

**Solution**

Configure the **startWindowIcon** attribute under **abilities** in the **module.json5** file.

**Example**

```
{
  "module": {
    // Do something.
    "abilities": [{
      // Do something.
      "startWindowIcon": "$media:space",
      "startWindowBackground": "$color:white",
    }]
  }
}
```

**References**

[module.json5 File](../quick-start/module-configuration-file.md)


## Can I obtain the context through globalThis in the stage model? (API version 9)

Do not use **globalThis** to obtain the context in the stage model.

This is because all the processes of an application share a JS VM instance in the stage model. Multiple abilities can run on these processes and share the same global object. If **globalThis** is used, the context of different abilities of the same JS VM instance may be returned.

**References**

[Data Synchronization Between UIAbility and UI](../application-models/uiability-data-sync-with-ui.md)


## What should I do when an error indicating too large size is reported during HAP deployment? (API version 9)

**Symptom**

During HAP deployment, the following error message is displayed:

Failure[INSTALL_FAILED_SIZE_TOO_LARGE] error while deploying hap?

**Solution**

You can split the HAP into multiple HAPs.


## How is data returned when startAbilityForResult is called? (API version 9)

**Solution**

The target UIAbilities uses **AbilityContext.terminateSelfWithResult** to terminate itself and pass the result to **startAbilityForResult**.

**References**

[Starting UIAbility in the Same Application and Obtaining the Return Result](../application-models/uiability-intra-device-interaction.md)


## How do I obtain the system timestamp? (API version 9)

**Solution**

Use **getCurrentTime** of **\@ohos.systemDateTime** to obtain the system time and time zone.

**Example**

Use the **\@ohos.systemDateTime** API as follows:

```
try {
  systemDateTime.getCurrentTime(true, (error, time) => {
    if (error) {
      console.info(`Failed to get currentTime. message: ${error.message}, code: ${error.code}`);
      return;
    }
    console.info(`Succeeded in getting currentTime : ${time}`);
  });
} catch(e) {
  console.info(`Failed to get currentTime. message: ${e.message}, code: ${e.code}`);
}
```

## How do I obtain the cache directory of the current application? (API version 9)

**Solution**

Use **Context.cacheDir** to obtain the cache directory of the application.

**References**

[cacheDir](../application-models/application-context-stage.md#obtaining-application-file-paths)


## In which JS file is the service widget lifecycle callback invoked? (API version 9)

**Solution**

When a widget is created, a **FormAblity.ts** file is generated, which contains the widget lifecycle.

**References**

[FormExtensionAbility](../reference/apis-form-kit/js-apis-app-form-formExtensionAbility.md)


## What should I do when the compilation on DevEco Studio fails while ServiceExtensionAbility and DataShareExtensionAbility APIs are used? (API version 9)

**Symptom**

After the **ServiceExtensionAbility** and **DataShareExtensionAbility** APIs are used, DevEco Studio reports an error indicating that the compilation fails.

**Cause**

The following types of SDKs are provided:

- Public SDK: intended for application developers and does not contain system APIs that require system permissions.

- Full SDK: intended for original equipment manufacturers (OEMs) and contains system APIs that require system permissions.

The SDK downloaded using DevEco Studio is the public SDK.

**Solution**

Third-party application cannot use **ServiceExtensionAbility** and **DataShareExtensionAbility**. To develop a system application, first [download the full SDK](full-sdk-switch-guide.md).


## How do I obtain the temp and files paths at the application level? (API version 9)

**Solution**

Obtain them from the application context. Specifically, use **this.context.getApplicationContext.tempDir** i to obtain the **temp** path, and use **this.context.getApplicationContext.filesDir** to obtain the **files** path.

**References**

[Obtaining Application File Paths](../application-models/application-context-stage.md#obtaining-application-file-paths)


## Why the application is not deleted from the background mission list after it calls terminateSelf? (API version 9)

**Solution**

This is because the **removeMissionAfterTerminate** field under **abilities** in the **module.json5** file of the UIAbility is set to **false** (default value). To enable the application snapshot to be automatically deleted when the application is destroyed, set this field to **true**.

**References**

[module.json5 File](../quick-start/module-configuration-file.md)


## How does an application developed in the stage model start an application developed in the FA model? (API version 9)

**Solution**

Refer to the code snippet below:


```
let want = {
    deviceId: "", // An empty deviceId indicates the local device.
    bundleName: "com.example.myapplication",
    abilityName: "EntryAbility",
    moduleName: "Module1", // moduleName is optional.
    parameters: { // Custom information.
    },
}
// context is the AbilityContext of the FA model to be started.
context.startAbility(want).then(() => {
    ...
}).catch((err) => {
    ...
})
```


## Can atomic services be implemented using JavaScript code only? (API version 9)

**Solution**

Currently, the directory structure of new widgets is css+hml+json. This means that the widgets cannot be implemented by using JavaScript code only. Event triggering and parameter transfer can be processed in JSON files.


## Can the lifecycle callback of a released FA widget be triggered when the widget is displayed in the service center so that the user login information can be obtained without opening the FA application? (API version 9)

**Solution**

After a widget is added, the **onCreate()** lifecycle is triggered so that related user information (silent login) can be displayed even when the application is not started. However, users must manually add the widget after the application is installed.


## What should I do when the error message "\[c4d4d3492eb8531, 0, 0\] ContextDeal::startAbility fetchAbilities failed" is displayed during switching to another application? (API version 9)

**Symptom**

The **startAbility** API reports an error during redirection.

**Solution**

Use **startAbility** for implementation as follows:

```
import featureAbility from '@ohos.ability.featureAbility'
function onStartRemoteAbility() {
console.info('onStartRemoteAbility begin');
let params;
let wantValue = {
    bundleName: 'ohos.samples.etsDemo',
    abilityName: 'ohos.samples.etsDemo.RemoteAbility',
    deviceId: getRemoteDeviceId(),
    parameters: params
};
console.info('onStartRemoteAbility want=' + JSON.stringify(wantValue));
featureAbility.startAbility({
    want: wantValue
}).then((data) => {
console.info('onStartRemoteAbility finished, ' + JSON.stringify(data));
});
console.info('onStartRemoteAbility end');
}
```

**References**

See [Starting a Local PageAbility](../application-models/start-local-pageability.md).


## How do I implement service login by touching a widget? (API version 9)

**Solution**

To create a service widget in the FA model, perform the following steps:

1. Implement lifecycle callbacks for the widget.

2. Configure the widget configuration file.

3. Persistently store widget data.

4. Update widget data.

5. Develop the widget UI page.

6. Develop a widget event. You can start a UIAbility upon the touch and implement service login in the UIAbility.

**References**

[Service Widget Development in FA Model](../form/widget-development-fa.md)


## How do I redirect to the application details page in Settings? (API version 9)

**Solution**

Refer to the following code:

```
this.context.startAbility(
{
  action: "action.settings.app.info",
  parameters: { "settingsParamBundleName": "your app bundlename" }
})
```


## How do I get UIAbilityContext within the \@Component in the stage model? (API version 9)

**Solution**

You can use **UIAbility.Context** to obtain the context.

**Example**

```
import common from '@ohos.app.ability.common';

@Entry
@Component
struct AbilityContextTest {
  // abilityContext
  @State UIAbilityInfo: string = 'Obtaining abilityInfo'
  UIAbilityContext: common.UIAbilityContext

  aboutToAppear() {
    // Use getContext to obtain the context and convert it to abilityContext.
    this.UIAbilityContext = getContext(this) as common.UIAbilityContext
  }

  build() {
    Row() {
      Column({ space: 20 }) {
        Text(this.UIAbilityInfo)
          .fontSize(20)
          .onClick(() => {
            this.UIAbilityInfo = JSON.stringify(this.UIAbilityContext.abilityInfo)
            console.log(`ContextDemo abilityInfo = ${this.UIAbilityInfo}`)
          })
      }
      .width('100%')
    }
    .height('100%')
  }
}
```


## What should I do when starting a continuous task fails? (API version 9)

**Symptom**

A ServiceAbility is started by calling **featureAbility.startAbility()**. When the ServiceAbility attempts to start a continuous task, the error message {"code":201,"message":"BussinessError 201: Permission denied."} is reported.

**Solution**

To start a continuous task in the background, you must configure the permission **ohos.permission.KEEP_BACKGROUND_RUNNING** in the **module.json5** file and declare the background mode for the ability that needs to use the continuous task.

```
"module": {
    "abilities": [
        {
            "backgroundModes": [
            "dataTransfer",
            "location"
            ], // Background mode
        }
    ],
    "requestPermissions": [
        {
            "name": "ohos.permission.KEEP_BACKGROUND_RUNNING" // Continuous task permission
        }
    ]
}
```

**References**

[ServiceAbility Configuration Items - backgroundModes](../application-models/serviceability-configuration.md)

[Continuous Task Permissions](../security/AccessToken/permissions-for-all.md#ohospermissionkeep_background_running)


## How do FA widgets exchange data? (API version 9)

The widget interacts with the widget provider through the **postCardAction** API, and the provider updates data through the **updateForm** API.

**References**

[Service Widget Development in FA Model](../form/widget-development-fa.md)

## Can I create a shortcut entry for an application on the home screen to directly open a specified page? (API version 10)

This feature is not supported yet.