openharmony 鸿蒙 js-apis-defaultAppManager-sys

2025-06-12 浏览 (1)

@ohos.bundle.defaultAppManager (默认应用管理)(系统接口)

本模块提供查询默认应用的能力，支持查询当前应用是否是默认应用。

说明：

本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

当前页面仅包含本模块的系统接口，其他公开接口参见@ohos.bundle.defaultAppManager。

导入模块

import { defaultAppManager } from '@kit.AbilityKit';

defaultAppManager.getDefaultApplication

getDefaultApplication(type: string, userId?: number): Promise<BundleInfo>

根据系统已定义的应用类型或者符合媒体类型格式（type/subtype）的文件类型或者UniformDataType类型获取默认应用信息，使用Promise异步回调。

需要权限： ohos.permission.GET_DEFAULT_APPLICATION

系统能力： SystemCapability.BundleManager.BundleFramework.DefaultApp

系统接口： 此接口为系统接口。

参数：

参数名类型必填说明
typestring是要查询的应用类型，取ApplicationType中的值，或者符合媒体类型格式的文件类型，或者UniformDataType类型。
userIdnumber否表示用户ID，可以通过getOsAccountLocalId接口获取。默认值：调用方所在用户。

返回值：

类型说明
Promise<BundleInfo>Promise形式返回默认应用包信息。

错误码：

以下错误码的详细介绍请参见通用错误码和ohos.bundle错误码。

错误码ID错误信息
201Permission denied.
202Permission denied, non-system app called system api.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
801Capability not supported.
17700004The specified user ID is not found.
17700023The specified default app does not exist.
17700025The specified type is invalid.

示例：

import { defaultAppManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { uniformTypeDescriptor } from '@kit.ArkData';

defaultAppManager.getDefaultApplication(defaultAppManager.ApplicationType.BROWSER)
  .then((data) => {
    console.info('Operation successful. bundleInfo: ' + JSON.stringify(data));
  })
  .catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  });

defaultAppManager.getDefaultApplication("image/png")
  .then((data) => {
    console.info('Operation successful. bundleInfo: ' + JSON.stringify(data));
  })
  .catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  });

defaultAppManager.getDefaultApplication(uniformTypeDescriptor.UniformDataType.AVI)
  .then((data) => {
    console.info('Operation successful. bundleInfo: ' + JSON.stringify(data));
  })
  .catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  });

defaultAppManager.getDefaultApplication

getDefaultApplication(type: string, userId: number, callback: AsyncCallback<BundleInfo>) : void

根据系统已定义的应用类型或者符合媒体类型格式（type/subtype）的文件类型或者UniformDataType类型获取默认应用信息，使用callback异步回调。

需要权限： ohos.permission.GET_DEFAULT_APPLICATION

系统能力： SystemCapability.BundleManager.BundleFramework.DefaultApp

系统接口： 此接口为系统接口。

参数：

参数名类型必填说明
typestring是要查询的应用类型，取ApplicationType中的值，或者符合媒体类型格式的文件类型，或者UniformDataType类型。
userIdnumber是表示用户ID，可以通过getOsAccountLocalId接口获取。
callbackAsyncCallback<BundleInfo>是程序启动作为入参的回调函数，返回包信息。

错误码：

以下错误码的详细介绍请参见通用错误码和ohos.bundle错误码。

错误码ID错误信息
201Permission denied.
202Permission denied, non-system app called system api.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
801Capability not supported.
17700004The specified user ID is not found.
17700023The specified default app does not exist.
17700025The specified type is invalid.

示例：

import { defaultAppManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { uniformTypeDescriptor } from '@kit.ArkData';

let userId = 100;
defaultAppManager.getDefaultApplication(defaultAppManager.ApplicationType.BROWSER, userId, (err: BusinessError, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. bundleInfo:' + JSON.stringify(data));
});

defaultAppManager.getDefaultApplication("image/png", userId, (err: BusinessError, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. bundleInfo:' + JSON.stringify(data));
});

defaultAppManager.getDefaultApplication(uniformTypeDescriptor.UniformDataType.AVI, userId, (err: BusinessError, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. bundleInfo:' + JSON.stringify(data));
});

defaultAppManager.getDefaultApplication

getDefaultApplication(type: string, callback: AsyncCallback<BundleInfo>) : void

根据系统已定义的应用类型或者符合媒体类型格式（type/subtype）的文件类型或者UniformDataType类型获取默认应用信息，使用callback异步回调。

需要权限： ohos.permission.GET_DEFAULT_APPLICATION

系统能力： SystemCapability.BundleManager.BundleFramework.DefaultApp

系统接口： 此接口为系统接口。

参数：

参数名类型必填说明
typestring是要查询的应用类型，取ApplicationType中的值，或者符合媒体类型格式的文件类型，或者UniformDataType类型。
callbackAsyncCallback<BundleInfo>是程序启动作为入参的回调函数，返回包信息。

错误码：

以下错误码的详细介绍请参见通用错误码和ohos.bundle错误码。

错误码ID错误信息
201Permission denied.
202Permission denied, non-system app called system api.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
801Capability not supported.
17700023The specified default app does not exist.
17700025The specified type is invalid.

示例：

import { defaultAppManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { uniformTypeDescriptor } from '@kit.ArkData';

defaultAppManager.getDefaultApplication(defaultAppManager.ApplicationType.BROWSER, (err: BusinessError, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. bundleInfo:' + JSON.stringify(data));
});

defaultAppManager.getDefaultApplication("image/png", (err: BusinessError, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. bundleInfo:' + JSON.stringify(data));
});

defaultAppManager.getDefaultApplication(uniformTypeDescriptor.UniformDataType.AVI, (err: BusinessError, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful. bundleInfo:' + JSON.stringify(data));
});

defaultAppManager.getDefaultApplicationSync10+

getDefaultApplicationSync(type: string, userId?: number): BundleInfo

以同步方法根据系统已定义的应用类型或者符合媒体类型格式（type/subtype）的文件类型或者UniformDataType类型获取默认应用信息，使用BundleInfo返回结果。

需要权限： ohos.permission.GET_DEFAULT_APPLICATION

系统能力： SystemCapability.BundleManager.BundleFramework.DefaultApp

系统接口： 此接口为系统接口。

参数：

参数名类型必填说明
typestring是要查询的应用类型，取ApplicationType中的值，或者符合媒体类型格式的文件类型，或者UniformDataType类型。
userIdnumber否表示用户ID，可以通过getOsAccountLocalId接口获取。默认值：调用方所在用户。

返回值：

类型说明
BundleInfo返回的默认应用包信息。

错误码：

以下错误码的详细介绍请参见通用错误码和ohos.bundle错误码。

错误码ID错误信息
201Permission denied.
202Permission denied, non-system app called system api.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
801Capability not supported.
17700004The specified user ID is not found.
17700023The specified default app does not exist.
17700025The specified type is invalid.

示例：

import { defaultAppManager } from '@kit.AbilityKit';
import { uniformTypeDescriptor } from '@kit.ArkData';

try {
  let data = defaultAppManager.getDefaultApplicationSync(defaultAppManager.ApplicationType.BROWSER)
  console.info('Operation successful. bundleInfo: ' + JSON.stringify(data));
} catch(error) {
  console.error('Operation failed. Cause: ' + JSON.stringify(error));
};

try {
  let data = defaultAppManager.getDefaultApplicationSync("image/png")
  console.info('Operation successful. bundleInfo: ' + JSON.stringify(data));
} catch(error) {
  console.error('Operation failed. Cause: ' + JSON.stringify(error));
};

try {
  let data = defaultAppManager.getDefaultApplicationSync(uniformTypeDescriptor.UniformDataType.AVI)
  console.info('Operation successful. bundleInfo: ' + JSON.stringify(data));
} catch(error) {
  console.error('Operation failed. Cause: ' + JSON.stringify(error));
};

defaultAppManager.setDefaultApplication

setDefaultApplication(type: string, elementName: ElementName, userId?: number): Promise<void>

根据系统已定义的应用类型或者符合媒体类型格式（type/subtype）的文件类型或者UniformDataType类型设置默认应用，使用Promise异步回调。

需要权限： ohos.permission.SET_DEFAULT_APPLICATION

系统能力： SystemCapability.BundleManager.BundleFramework.DefaultApp

系统接口： 此接口为系统接口。

参数：

参数名类型必填说明
typestring是要设置的应用类型，取ApplicationType中的值，或者符合媒体类型格式的文件类型，或者UniformDataType类型。
elementNameElementName是要设置为默认应用的组件信息。
userIdnumber否表示用户ID，可以通过getOsAccountLocalId接口获取。默认值：调用方所在用户。

返回值：

类型说明
Promise<void>Promise对象，无返回结果的Promise对象。

错误码：

以下错误码的详细介绍请参见通用错误码和ohos.bundle错误码。

错误码ID错误信息
201Permission denied.
202Permission denied, non-system app called system api.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
801Capability not supported.
17700004The specified user ID is not found.
17700025The specified type is invalid.
17700028The specified ability does not match the type.

示例：

import { defaultAppManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { uniformTypeDescriptor } from '@kit.ArkData';

defaultAppManager.setDefaultApplication(defaultAppManager.ApplicationType.BROWSER, {
  bundleName: "com.example.myapplication",
  moduleName: "module01",
  abilityName: "EntryAbility"
}).then((data) => {
  console.info('Operation successful.');
}).catch((error: BusinessError) => {
  console.error('Operation failed. Cause: ' + JSON.stringify(error));
});

let userId = 100;
defaultAppManager.setDefaultApplication(defaultAppManager.ApplicationType.BROWSER, {
  bundleName: "com.example.myapplication",
  moduleName: "module01",
  abilityName: "EntryAbility"
}, userId).then((data) => {
  console.info('Operation successful.');
}).catch((error: BusinessError) => {
  console.error('Operation failed. Cause: ' + JSON.stringify(error));
});

defaultAppManager.setDefaultApplication("image/png", {
  bundleName: "com.example.myapplication",
  moduleName: "module01",
  abilityName: "EntryAbility"
}, userId).then((data) => {
  console.info('Operation successful.');
}).catch((error: BusinessError) => {
  console.error('Operation failed. Cause: ' + JSON.stringify(error));
});

defaultAppManager.setDefaultApplication(uniformTypeDescriptor.UniformDataType.AVI, {
  bundleName: "com.example.myapplication",
  moduleName: "module01",
  abilityName: "EntryAbility"
}, userId).then((data) => {
  console.info('Operation successful.');
}).catch((error: BusinessError) => {
  console.error('Operation failed. Cause: ' + JSON.stringify(error));
});

defaultAppManager.setDefaultApplication

setDefaultApplication(type: string, elementName: ElementName, userId: number, callback: AsyncCallback<void>) : void

根据系统已定义的应用类型或者符合媒体类型格式（type/subtype）的文件类型或者UniformDataType类型设置默认应用，使用callback异步回调。

需要权限： ohos.permission.SET_DEFAULT_APPLICATION

系统能力： SystemCapability.BundleManager.BundleFramework.DefaultApp

系统接口： 此接口为系统接口。

参数：

参数名类型必填说明
typestring是要设置的应用类型，取ApplicationType中的值，或者符合媒体类型格式的文件类型，或者UniformDataType类型。
elementNameElementName是要设置为默认应用的组件信息。
userIdnumber是表示用户ID，可以通过getOsAccountLocalId接口获取。
callbackAsyncCallback<void>是程序启动作为入参的回调函数。

错误码：

以下错误码的详细介绍请参见通用错误码和ohos.bundle错误码。

错误码ID错误信息
201Permission denied.
202Permission denied, non-system app called system api.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
801Capability not supported.
17700004The specified user ID is not found.
17700025The specified type is invalid.
17700028The specified ability does not match the type.

示例：

import { defaultAppManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { uniformTypeDescriptor } from '@kit.ArkData';

let userId = 100;
defaultAppManager.setDefaultApplication(defaultAppManager.ApplicationType.BROWSER, {
  bundleName: "com.example.myapplication",
  moduleName: "module01",
  abilityName: "EntryAbility"
}, userId, (err: BusinessError, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful.');
});

defaultAppManager.setDefaultApplication("image/png", {
  bundleName: "com.example.myapplication",
  moduleName: "module01",
  abilityName: "EntryAbility"
}, userId, (err: BusinessError, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful.');
});

defaultAppManager.setDefaultApplication(uniformTypeDescriptor.UniformDataType.AVI, {
  bundleName: "com.example.myapplication",
  moduleName: "module01",
  abilityName: "EntryAbility"
}, userId, (err: BusinessError, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful.');
});

defaultAppManager.setDefaultApplication

setDefaultApplication(type: string, elementName: ElementName, callback: AsyncCallback<void>) : void

根据系统已定义的应用类型或者符合媒体类型格式（type/subtype）的文件类型或者UniformDataType类型设置默认应用，使用callback异步回调。

需要权限： ohos.permission.SET_DEFAULT_APPLICATION

系统能力： SystemCapability.BundleManager.BundleFramework.DefaultApp

系统接口： 此接口为系统接口。

参数：

参数名类型必填说明
typestring是要设置的应用类型，取ApplicationType中的值，或者符合媒体类型格式的文件类型，或者UniformDataType类型。
elementNameElementName是要设置为默认应用的组件信息。
callbackAsyncCallback<void>是程序启动作为入参的回调函数。

错误码：

以下错误码的详细介绍请参见通用错误码和ohos.bundle错误码。

错误码ID错误信息
201Permission denied.
202Permission denied, non-system app called system api.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
801Capability not supported.
17700025The specified type is invalid.
17700028The specified ability does not match the type.

示例：

import { defaultAppManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { uniformTypeDescriptor } from '@kit.ArkData';

defaultAppManager.setDefaultApplication(defaultAppManager.ApplicationType.BROWSER, {
  bundleName: "com.example.myapplication",
  moduleName: "module01",
  abilityName: "EntryAbility"
}, (err: BusinessError, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful.');
});

defaultAppManager.setDefaultApplication("image/png", {
  bundleName: "com.example.myapplication",
  moduleName: "module01",
  abilityName: "EntryAbility"
}, (err: BusinessError, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful.');
});

defaultAppManager.setDefaultApplication(uniformTypeDescriptor.UniformDataType.AVI, {
  bundleName: "com.example.myapplication",
  moduleName: "module01",
  abilityName: "EntryAbility"
}, (err: BusinessError, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful.');
});

defaultAppManager.setDefaultApplicationSync10+

setDefaultApplicationSync(type: string, elementName: ElementName, userId?: number): void

以同步方法根据系统已定义的应用类型或者符合媒体类型格式（type/subtype）的文件类型或者UniformDataType类型设置默认应用。

需要权限： ohos.permission.SET_DEFAULT_APPLICATION

系统能力： SystemCapability.BundleManager.BundleFramework.DefaultApp

系统接口： 此接口为系统接口。

参数：

参数名类型必填说明
typestring是要设置的应用类型，取ApplicationType中的值，或者符合媒体类型格式的文件类型，或者UniformDataType类型。
elementNameElementName是要设置为默认应用的组件信息。
userIdnumber否表示用户ID，可以通过getOsAccountLocalId接口获取。默认值：调用方所在用户。

错误码：

以下错误码的详细介绍请参见通用错误码和ohos.bundle错误码。

错误码ID错误信息
201Permission denied.
202Permission denied, non-system app called system api.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
801Capability not supported.
17700004The specified user ID is not found.
17700025The specified type is invalid.
17700028The specified ability does not match the type.

示例：

import { defaultAppManager } from '@kit.AbilityKit';
import { uniformTypeDescriptor } from '@kit.ArkData';

try {
  defaultAppManager.setDefaultApplicationSync(defaultAppManager.ApplicationType.BROWSER, {
  bundleName: "com.example.myapplication",
  moduleName: "module01",
  abilityName: "EntryAbility"
});
  console.info('Operation successful.');
} catch(error) {
  console.error('Operation failed. Cause: ' + JSON.stringify(error));
};

let userId = 100;
try {
  defaultAppManager.setDefaultApplicationSync(defaultAppManager.ApplicationType.BROWSER, {
  bundleName: "com.example.myapplication",
  moduleName: "module01",
  abilityName: "EntryAbility"
}, userId);
  console.info('Operation successful.');
} catch(error) {
  console.error('Operation failed. Cause: ' + JSON.stringify(error));
};

try {
  defaultAppManager.setDefaultApplicationSync("image/png", {
  bundleName: "com.example.myapplication",
  moduleName: "module01",
  abilityName: "EntryAbility"
}, userId);
  console.info('Operation successful.');
} catch(error) {
  console.error('Operation failed. Cause: ' + JSON.stringify(error));
};

try {
  defaultAppManager.setDefaultApplicationSync(uniformTypeDescriptor.UniformDataType.AVI, {
  bundleName: "com.example.myapplication",
  moduleName: "module01",
  abilityName: "EntryAbility"
}, userId);
  console.info('Operation successful.');
} catch(error) {
  console.error('Operation failed. Cause: ' + JSON.stringify(error));
};

defaultAppManager.resetDefaultApplication

resetDefaultApplication(type: string, userId?: number): Promise<void>

根据系统已定义的应用类型或者符合媒体类型格式（type/subtype）的文件类型或者UniformDataType类型重置默认应用，使用Promise异步回调。

需要权限： ohos.permission.SET_DEFAULT_APPLICATION

系统能力： SystemCapability.BundleManager.BundleFramework.DefaultApp

系统接口： 此接口为系统接口。

参数：

参数名类型必填说明
typestring是要重置的应用类型，取ApplicationType中的值，或者符合媒体类型格式的文件类型，或者UniformDataType类型。
userIdnumber否表示用户ID，可以通过getOsAccountLocalId接口获取。默认值：调用方所在用户。

返回值：

类型说明
Promise<void>Promise对象，无返回结果的Promise对象。

错误码：

以下错误码的详细介绍请参见通用错误码和ohos.bundle错误码。

错误码ID错误信息
201Permission denied.
202Permission denied, non-system app called system api.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
801Capability not supported.
17700004The specified user ID is not found.
17700025The specified type is invalid.

示例：

import { defaultAppManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { uniformTypeDescriptor } from '@kit.ArkData';

let userId = 100;
defaultAppManager.resetDefaultApplication(defaultAppManager.ApplicationType.BROWSER, userId)
  .then((data) => {
    console.info('Operation successful.');
  })
  .catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  });

defaultAppManager.resetDefaultApplication("image/png", userId)
  .then((data) => {
    console.info('Operation successful.');
  })
  .catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  });

defaultAppManager.resetDefaultApplication(uniformTypeDescriptor.UniformDataType.AVI, userId)
  .then((data) => {
    console.info('Operation successful.');
  })
  .catch((error: BusinessError) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
  });

defaultAppManager.resetDefaultApplication

resetDefaultApplication(type: string, userId: number, callback: AsyncCallback<void>) : void

根据系统已定义的应用类型或者符合媒体类型格式（type/subtype）的文件类型或者UniformDataType类型重置默认应用，使用callback异步回调。

需要权限： ohos.permission.SET_DEFAULT_APPLICATION

系统能力： SystemCapability.BundleManager.BundleFramework.DefaultApp

系统接口： 此接口为系统接口。

参数：

参数名类型必填说明
typestring是要重置的应用类型，取ApplicationType中的值，或者符合媒体类型格式的文件类型，或者UniformDataType类型。
userIdnumber是表示用户ID，可以通过getOsAccountLocalId接口获取。
callbackAsyncCallback<void>是程序启动作为入参的回调函数。

错误码：

以下错误码的详细介绍请参见通用错误码和ohos.bundle错误码。

错误码ID错误信息
201Permission denied.
202Permission denied, non-system app called system api.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
801Capability not supported.
17700004The specified user ID is not found.
17700025The specified type is invalid.

示例：

import { defaultAppManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { uniformTypeDescriptor } from '@kit.ArkData';

let userId = 100;
defaultAppManager.resetDefaultApplication(defaultAppManager.ApplicationType.BROWSER, userId, (err: BusinessError, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful.');
});

defaultAppManager.resetDefaultApplication("image/png", userId, (err: BusinessError, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful.');
});

defaultAppManager.resetDefaultApplication(uniformTypeDescriptor.UniformDataType.AVI, userId, (err: BusinessError, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful.');
});

defaultAppManager.resetDefaultApplication

resetDefaultApplication(type: string, callback: AsyncCallback<void>) : void

根据系统已定义的应用类型或者符合媒体类型格式（type/subtype）的文件类型或者UniformDataType类型重置默认应用，使用callback异步回调。

需要权限： ohos.permission.SET_DEFAULT_APPLICATION

系统能力： SystemCapability.BundleManager.BundleFramework.DefaultApp

系统接口： 此接口为系统接口。

参数：

参数名类型必填说明
typestring是要重置的应用类型，取ApplicationType中的值，或者符合媒体类型格式的文件类型，或者UniformDataType类型。
callbackAsyncCallback<void>是程序启动作为入参的回调函数。

错误码：

以下错误码的详细介绍请参见通用错误码和ohos.bundle错误码。

错误码ID错误信息
201Permission denied.
202Permission denied, non-system app called system api.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
801Capability not supported.
17700025The specified type is invalid.

示例：

import { defaultAppManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { uniformTypeDescriptor } from '@kit.ArkData';

defaultAppManager.resetDefaultApplication(defaultAppManager.ApplicationType.BROWSER, (err: BusinessError, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful.');
});

defaultAppManager.resetDefaultApplication("image/png", (err: BusinessError, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful.');
});

defaultAppManager.resetDefaultApplication(uniformTypeDescriptor.UniformDataType.AVI, (err: BusinessError, data) => {
  if (err) {
    console.error('Operation failed. Cause: ' + JSON.stringify(err));
    return;
  }
  console.info('Operation successful.');
});

defaultAppManager.resetDefaultApplicationSync10+

resetDefaultApplicationSync(type: string, userId?: number): void

以同步方法根据系统已定义的应用类型或者符合媒体类型格式（type/subtype）的文件类型或者UniformDataType类型重置默认应用。

需要权限： ohos.permission.SET_DEFAULT_APPLICATION

系统能力： SystemCapability.BundleManager.BundleFramework.DefaultApp

系统接口： 此接口为系统接口。

参数：

参数名类型必填说明
typestring是要重置的应用类型，取ApplicationType中的值，或者符合媒体类型格式的文件类型，或者UniformDataType类型。
userIdnumber否表示用户ID，可以通过getOsAccountLocalId接口获取。默认值：调用方所在用户。

错误码：

以下错误码的详细介绍请参见通用错误码和ohos.bundle错误码。

错误码ID错误信息
201Permission denied.
202Permission denied, non-system app called system api.
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
801Capability not supported.
17700004The specified user ID is not found.
17700025The specified type is invalid.

示例：

import { defaultAppManager } from '@kit.AbilityKit';
import { uniformTypeDescriptor } from '@kit.ArkData';

let userId = 100;
try {
  defaultAppManager.resetDefaultApplicationSync(defaultAppManager.ApplicationType.BROWSER, userId);
  console.info('Operation successful.');
} catch(error) {
  console.error('Operation failed. Cause: ' + JSON.stringify(error));
};

try {
  defaultAppManager.resetDefaultApplicationSync("image/png", userId);
  console.info('Operation successful.');
} catch(error) {
  console.error('Operation failed. Cause: ' + JSON.stringify(error));
};

try {
  defaultAppManager.resetDefaultApplicationSync(uniformTypeDescriptor.UniformDataType.AVI, userId);
  console.info('Operation successful.');
} catch(error) {
  console.error('Operation failed. Cause: ' + JSON.stringify(error));
};

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Ability Kit（程序框架服务）

harmony 鸿蒙AbilityBase

harmony 鸿蒙AbilityBase_Element

harmony 鸿蒙AbilityRuntime

harmony 鸿蒙bundle

harmony 鸿蒙OH_NativeBundle_ApplicationInfo

harmony 鸿蒙OH_NativeBundle_ElementName

harmony 鸿蒙ability_base_common.h

harmony 鸿蒙ability_runtime_common.h

harmony 鸿蒙application_context.h

  • 所属分类： 后端技术
  • 本文标签： 软件 鸿蒙
  • 版权声明： 本文链接 https://seaxiang.com/blog/gmolk6