@ohos.app.ability.VpnExtensionAbility (Enhanced VPN Management)

This module provides lifecycle callbacks for third-party VPNs, including VPN creation and destruction.

NOTE

• The initial APIs of this module are supported since API version 11. Newly added APIs will be marked with a superscript to indicate their earliest API version.

• The APIs of this module can be used only in the stage model.

Modules to Import

import { VpnExtensionAbility } from '@kit.NetworkKit';

Attributes

System capability: SystemCapability.Ability.AbilityRuntime.Core.

Name	Type	Read-only	Optional	Description
context	VpnExtensionContext	No	No	Context of the VpnExtension. This context is inherited from ExtensionContext.

VpnExtensionAbility.onCreate

onCreate(want: Want): void

Called when the third-party VPN is initialized upon startup.

NOTE

You are advised to call onDestroy to listen to the destruction of the third-party VPN and clear resources in a timely manner.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Parameters

Name	Type	Mandatory	Description
want	Want	Yes	Want information.

Example

import { VpnExtensionAbility } from '@kit.NetworkKit';
import { Want } from '@kit.AbilityKit';

class MyVpnExtAbility extends VpnExtensionAbility {
    onCreate(want: Want) {
       console.info('MyVpnExtAbility onCreate');
    }
}

VpnExtensionAbility.onDestroy

onDestroy(): void

Called when the third-party VPN is destroyed to clear resources.

System capability: SystemCapability.Ability.AbilityRuntime.Core

Example

import { VpnExtensionAbility } from '@kit.NetworkKit';

class MyVpnExtAbility extends VpnExtensionAbility {
    onDestroy() {
       console.info('MyVpnExtAbility onDestroy');
    }
}