IssueNo:api7 ts

Description:commit applicationFramework api7 interface ts files
Sig:SIG_ApplicationFramework
Feature or Bugfix: Feature
Binary Source: No

Signed-off-by: dy_study <dingyao5@huawei.com>
Change-Id: Id5077cb0282c46fb0e5c93265055434ea8eee6b1

api/@ohos.ability.errorCode.d.ts

@@ -0,0 +1,49 @@
+/*
+ * Copyright (c) 2022 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+ /**
+  * Defines error codes used when starting an ability, for example, featureAbility.ErrorCode.NO_ERROR.
+  * @since 6
+  * @syscap SystemCapability.Ability.AbilityRuntime.Core
+  */
+export enum ErrorCode {
+  /**
+   * Permission denied.
+   * @since 6
+   * @syscap SystemCapability.Ability.AbilityRuntime.Core
+   */
+  PERMISSION_DENY = -3,
+
+  /**
+   * Ability not found.
+   * @since 6
+   * @syscap SystemCapability.Ability.AbilityRuntime.Core
+   */
+  ABILITY_NOT_FOUND = -2,
+
+  /**
+   * Invalid parameter.
+   * @since 6
+   * @syscap SystemCapability.Ability.AbilityRuntime.Core
+   */
+  INVALID_PARAMETER = -1,
+
+  /**
+   * No error.
+   * @since 6
+   * @syscap SystemCapability.Ability.AbilityRuntime.Core
+   */
+  NO_ERROR = 0
+}

api/@ohos.ability.featureAbility.d.ts

@@ -13,6 +13,7 @@
  * limitations under the License.
  */
 import { AsyncCallback } from './basic';
+import { Callback } from './basic';
 import { Want } from './ability/want';
 import { StartAbilityParameter } from './ability/startAbilityParameter';
 import { AbilityResult } from './ability/abilityResult';

api/@ohos.ability.particleAbility.d.ts

@@ -17,6 +17,8 @@ import { AsyncCallback } from './basic';
 import { StartAbilityParameter } from './ability/startAbilityParameter';
 import { DataAbilityHelper } from './ability/dataAbilityHelper';
 import { NotificationRequest } from './notification/notificationRequest';
+import { ConnectOptions } from './ability/connectOptions';
+import { Want } from './ability/want';
 
 /**
  * A Particle Ability represents an ability with service.
@@ -85,5 +87,27 @@ declare namespace particleAbility {
    */
   function cancelBackgroundRunning(callback: AsyncCallback<void>): void;
   function cancelBackgroundRunning(): Promise<void>;
+
+  /**
+   * Connects an ability to a Service ability.
+   *
+   * @since 7
+   * @syscap SystemCapability.Ability.AbilityRuntime.FAModel
+   * @param request Indicates the Service ability to connect.
+   * @param options Callback object for the client. If this parameter is null, an exception is thrown.
+   * @return unique identifier of the connection between the client and the service side.
+   * @FAModelOnly
+   */
+   function connectAbility(request: Want, options:ConnectOptions ): number;
+
+  /**
+  * Disconnects ability to a Service ability.
+  * @since 7
+  * @syscap SystemCapability.Ability.AbilityRuntime.FAModel
+  * @param connection the connection id returned from connectAbility api.
+  * @FAModelOnly
+  */
+   function disconnectAbility(connection: number, callback:AsyncCallback<void>): void;
+   function disconnectAbility(connection: number): Promise<void>;
 }
 export default particleAbility;

api/@ohos.app.abilityManager.d.ts

@@ -80,6 +80,24 @@ declare namespace abilityManager {
      */
     function deleteMissions(missionIds: Array<number>): Promise<void>;
     function deleteMissions(missionIds: Array<number>, callback: AsyncCallback<void>): void;
+
+    /**	    
+     * Is it a ram-constrained device
+     * @since 7
+     * @syscap SystemCapability.Ability.AbilityRuntime.Core
+     * @return whether a ram-constrained device.
+     */
+    function isRamConstrainedDevice(): Promise<boolean>;
+    function isRamConstrainedDevice(callback: AsyncCallback<boolean>): void;
+
+    /**
+     * Get the memory size of the application
+     * @since 7
+     * @syscap SystemCapability.Ability.AbilityRuntime.Core
+     * @return application memory size.
+     */
+    function getAppMemorySize(): Promise<number>;
+    function getAppMemorySize(callback: AsyncCallback<number>): void;
 }
 
 export default abilityManager;

api/@ohos.bundle.d.ts

@@ -22,6 +22,7 @@ import { Want } from './ability/want';
 import { BundleInstaller } from './bundle/bundleInstaller';
 import { ModuleUsageRecord } from './bundle/moduleUsageRecord';
 import { PermissionDef } from  './bundle/PermissionDef';
+import image from './@ohos.multimedia.image';
 
 /**
  * bundle.
@@ -383,6 +384,19 @@ declare namespace bundle {
    */
   function getBundleInstaller(callback: AsyncCallback<BundleInstaller>): void;
   function getBundleInstaller(): Promise<BundleInstaller>;
+   
+  /**
+   * Obtains information about the current ability.
+   *
+   * @since 7
+   * @syscap SystemCapability.BundleManager.BundleFramework
+   * @param bundleName Indicates the application bundle name to be queried.
+   * @param abilityName Indicates the ability name.
+   * @return Returns the AbilityInfo object for the current ability.
+   * @permission ohos.permission.GET_BUNDLE_INFO_PRIVILEGED, ohos.permission.GET_BUNDLE_INFO
+   */
+  function getAbilityInfo(bundleName: string, abilityName: string, callback: AsyncCallback<AbilityInfo>): void;
+  function getAbilityInfo(bundleName: string, abilityName: string): Promise<AbilityInfo>;
 
   /**
    * Obtains based on a given bundle name.
@@ -392,12 +406,13 @@ declare namespace bundle {
    * @param bundleName Indicates the application bundle name to be queried.
    * @param bundleFlags Indicates the flag used to specify information contained in the ApplicationInfo object
    *              that will be returned.
-   * @param userId Indicates the user ID.
+   * @param userId Indicates the user ID or do not pass user ID.
    * @return Returns the ApplicationInfo object.
    * @permission ohos.permission.GET_BUNDLE_INFO_PRIVILEGED, ohos.permission.GET_BUNDLE_INFO
    */
   function getApplicationInfo(bundleName: string, bundleFlags: number, userId: number, callback: AsyncCallback<ApplicationInfo>) : void;
-  function getApplicationInfo(bundleName: string, bundleFlags: number, userId: number) : Promise<ApplicationInfo>;
+  function getApplicationInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback<ApplicationInfo>) : void;
+  function getApplicationInfo(bundleName: string, bundleFlags: number, userId?: number) : Promise<ApplicationInfo>;
 
   /**
    * Query the AbilityInfo by the given Want.
@@ -438,12 +453,13 @@ declare namespace bundle {
    * @syscap SystemCapability.BundleManager.BundleFramework
    * @param bundleFlags Indicates the flag used to specify information contained in the ApplicationInfo objects
    *              that will be returned.
-   * @param userId Indicates the user ID.
+   * @param userId Indicates the user ID or do not pass user ID.
    * @return Returns a list of ApplicationInfo objects.
    * @permission ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
    */
   function getAllApplicationInfo(bundleFlags: number, userId: number, callback: AsyncCallback<Array<ApplicationInfo>>) : void;
-  function getAllApplicationInfo(bundleFlags: number, userId: number) : Promise<Array<ApplicationInfo>>;
+  function getAllApplicationInfo(bundleFlags: number, callback: AsyncCallback<Array<ApplicationInfo>>) : void;
+  function getAllApplicationInfo(bundleFlags: number, userId?: number) : Promise<Array<ApplicationInfo>>;
 
   /**
    * Obtains bundle name by the given uid.
@@ -470,8 +486,6 @@ declare namespace bundle {
   function getBundleArchiveInfo(hapFilePath: string, bundleFlags: number, callback: AsyncCallback<BundleInfo>) : void
   function getBundleArchiveInfo(hapFilePath: string, bundleFlags: number) : Promise<BundleInfo>;
 
-  /**
-
   /**
    * Obtains the Want for starting the main ability of an application based on the
    * given bundle name. The main ability of an application is the ability that has the
@@ -569,6 +583,54 @@ declare namespace bundle {
    */
   function getPermissionDef(permissionName: string, callback: AsyncCallback<PermissionDef>): void;
   function getPermissionDef(permissionName: string): Promise<PermissionDef>;
+
+  /**
+   * Obtains the label of a specified ability.
+   * 
+   * @since 8
+   * @syscap SystemCapability.BundleManager.BundleFramework
+   * @param bundleName Indicates the bundle name of the application to which the ability belongs.
+   * @param abilityName Indicates the ability name.
+   * @permission ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
+   * @return Returns the label representing the label of the specified ability.
+   */
+  function getAbilityLabel(bundleName: string, abilityName: string, callback: AsyncCallback<string>): void;
+  function getAbilityLabel(bundleName: string, abilityName: string): Promise<string>;
+   
+  /**
+    * Obtains the icon of a specified ability.
+    * 
+    * @since 8
+    * @syscap SystemCapability.BundleManager.BundleFramework
+    * @param bundleName Indicates the bundle name of the application to which the ability belongs.
+    * @param abilityName Indicates the ability name.
+    * @return Returns the PixelMap object representing the icon of the specified ability.
+    * @permission ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
+    */
+  function getAbilityIcon(bundleName: string, abilityName: string, callback: AsyncCallback<image.PixelMap>): void;
+  function getAbilityIcon(bundleName: string, abilityName: string): Promise<image.PixelMap>;
+   
+  /**
+    * Checks whether a specified ability is enabled.
+    * 
+    * @since 8
+    * @syscap SystemCapability.BundleManager.BundleFramework
+    * @param info Indicates information about the ability to check.
+    * @returns Returns true if the ability is enabled; returns false otherwise.
+    */ 
+  function isAbilityEnabled(info: AbilityInfo, callback: AsyncCallback<boolean>): void;
+  function isAbilityEnabled(info: AbilityInfo): Promise<boolean>;
+   
+  /**
+    * Checks whether a specified application is enabled.
+    * 
+    * @since 8
+    * @syscap SystemCapability.BundleManager.BundleFramework
+    * @param bundleName Indicates the bundle name of the application.
+    * @returns Returns true if the application is enabled; returns false otherwise.
+    */
+  function isApplicationEnabled(bundleName: string, callback: AsyncCallback<boolean>): void;
+  function isApplicationEnabled(bundleName: string): Promise<boolean>;
 }
 
 export default bundle;

api/ability/dataAbilityHelper.d.ts

@@ -198,4 +198,44 @@ export interface DataAbilityHelper {
      */
     query(uri: string, columns: Array<string>, predicates: dataAbility.DataAbilityPredicates, callback: AsyncCallback<ResultSet>): void;
     query(uri: string, columns: Array<string>, predicates: dataAbility.DataAbilityPredicates): Promise<ResultSet>;
+
+    /**
+     * Calls the extended API of the DataAbility. This method uses a promise to return the result.
+     *
+     * @since 7
+     * @syscap SystemCapability.Ability.AbilityRuntime.FAModel
+     * @param uri URI of the Data ability. Example: "dataability:///com.example.xxx.xxxx"
+     * @param method Indicates the method to call.
+     * @param arg Indicates the parameter of the String type.
+     * @param extras Indicates the parameter of the PacMap type. 
+     * If a custom Sequenceable object is put in the PacMap object and will be transferred across processes,
+     * you must call BasePacMap.setClassLoader(ClassLoader) to set a class loader for the custom object.
+     * If the PacMap object is to be transferred to a non-OHOS process,
+     * values of primitive types are supported, but not custom Sequenceable objects.
+     * @return Returns the query result {@link PacMap}.
+     * @FAModelOnly
+     */
+    call(uri: string, method: string, arg: string, extras: PacMap, callback: AsyncCallback<PacMap>): void;
+    call(uri: string, method: string, arg: string, extras: PacMap): Promise<PacMap>;
+}
+
+/**
+ * Defines a PacMap object for storing a series of values.
+ * @since 7
+ * @syscap SystemCapability.Ability.AbilityRuntime.FAModel
+ * @FAModelOnly
+ */
+ export interface PacMap {
+  
+    /**
+     * Indicates the parameter of the PacMap type.
+     * If a custom Sequenceable object is put in the PacMap object and will be transferred across processes,
+     * you must call BasePacMap.setClassLoader(ClassLoader) to set a class loader for the custom object.
+     * If the PacMap object is to be transferred to a non-OHOS process,
+     * values of primitive types are supported, but not custom Sequenceable objects.
+     * @since 7
+     * @syscap SystemCapability.Ability.AbilityRuntime.FAModel
+     * @FAModelOnly
+     */
+     [key: string]: number | string | boolean | Array<string | number | boolean> | null;
 }

api/app/appVersionInfo.d.ts

@@ -0,0 +1,46 @@
+/*
+ * Copyright (c) 2022 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * Defines an AppVersionInfo object.
+ * @since 7
+ * @syscap SystemCapability.Ability.AbilityRuntime.Core
+ */
+export interface AppVersionInfo {
+
+  /**
+  * Application name.
+  * @default appName
+  * @since 7
+  * @syscap SystemCapability.Ability.AbilityRuntime.Core
+  */
+  readonly appName: string;
+
+  /**
+  * Application version number.
+  * @default versionCode
+  * @since 7
+  * @syscap SystemCapability.Ability.AbilityRuntime.Core
+  */
+  readonly versionCode: number;
+
+  /**
+  * Application version name.
+  * @default versionName
+  * @since 7
+  * @syscap SystemCapability.Ability.AbilityRuntime.Core
+  */
+  readonly versionName: string;
+}

api/app/context.d.ts

@@ -18,6 +18,10 @@ import { ApplicationInfo } from '../bundle/applicationInfo';
 import { ProcessInfo } from './processInfo';
 import { ElementName } from '../bundle/elementName';
 import BaseContext from '../application/BaseContext';
+import { HapModuleInfo } from '../bundle/hapModuleInfo';
+import { AppVersionInfo } from './appVersionInfo';
+import { AbilityInfo } from '../bundle/abilityInfo';
+
 
 /**
  * The context of an ability or an application.  It allows access to
@@ -126,6 +130,97 @@ export interface Context extends BaseContext {
     */
     getCallingBundle(callback: AsyncCallback<string>): void
     getCallingBundle(): Promise<string>;
+
+    /**
+    * Obtains the file directory of this application on the internal storage.
+    * @since 7
+    * @syscap SystemCapability.Ability.AbilityRuntime.Core
+    * @FAModelOnly
+    */
+    getFilesDir(callback: AsyncCallback<string>): void;
+    getFilesDir(): Promise<string>;
+
+    /**
+    * Obtains the cache directory of this application on the internal storage.
+    * @since 7
+    * @syscap SystemCapability.Ability.AbilityRuntime.Core
+    * @FAModelOnly
+    */
+    getCacheDir(callback: AsyncCallback<string>): void;
+    getCacheDir(): Promise<string>;
+
+    /**
+    * Obtains the distributed file path for storing ability or application data files.
+    * If the distributed file path does not exist, the system will create a path and return the created path.
+    * @since 7
+    * @syscap SystemCapability.Ability.AbilityRuntime.Core
+    * @FAModelOnly
+    */
+    getOrCreateDistributedDir(): Promise<string>;
+    getOrCreateDistributedDir(callback: AsyncCallback<string>): void;
+
+    /**
+    * Obtains the application type.
+    * @since 7
+    * @syscap SystemCapability.Ability.AbilityRuntime.Core
+    * @FAModelOnly
+    */
+    getAppType(callback: AsyncCallback<string>): void
+    getAppType(): Promise<string>;
+
+    /**
+    * Obtains the ModuleInfo object for this application.
+    * @since 7
+    * @syscap SystemCapability.Ability.AbilityRuntime.Core
+    * @FAModelOnly
+    */
+    getHapModuleInfo(callback: AsyncCallback<HapModuleInfo>): void
+    getHapModuleInfo(): Promise<HapModuleInfo>;
+
+    /**
+    * Obtains the application version information.
+    * @since 7
+    * @syscap SystemCapability.Ability.AbilityRuntime.Core
+    * @FAModelOnly
+    */
+    getAppVersionInfo(callback: AsyncCallback<AppVersionInfo>): void
+    getAppVersionInfo(): Promise<AppVersionInfo>;
+
+    /**
+    * Obtains the context of this application.
+    * @since 7
+    * @syscap SystemCapability.Ability.AbilityRuntime.Core
+    * @FAModelOnly
+    */
+    getApplicationContext(): Context;
+
+    /**
+    * Checks the detailed information of this ability.
+    * @since 7
+    * @syscap SystemCapability.Ability.AbilityRuntime.Core
+    * @FAModelOnly
+    */
+    getAbilityInfo(callback: AsyncCallback<AbilityInfo>): void
+    getAbilityInfo(): Promise<AbilityInfo>;
+
+    /**
+    * Checks whether the configuration of this ability is changing.
+    * @since 7
+    * @syscap SystemCapability.Ability.AbilityRuntime.Core
+    * @return true if the configuration of this ability is changing and false otherwise.
+    * @FAModelOnly
+    */
+    isUpdatingConfigurations(): Promise<boolean>;
+    isUpdatingConfigurations(callback: AsyncCallback<boolean>): void;
+
+    /**
+    * Informs the system of the time required for drawing this Page ability.
+    * @since 7
+    * @syscap SystemCapability.Ability.AbilityRuntime.Core
+    * @FAModelOnly
+    */
+    printDrawnCompleted(): Promise<void>;
+    printDrawnCompleted(callback: AsyncCallback<void>): void;
 }
 
 /**
@@ -184,4 +279,4 @@ interface PermissionOptions {
   * @FAModelOnly
   */
  uid?: number;
-}
+}

api/app/processInfo.d.ts

@@ -37,5 +37,5 @@ export interface ProcessInfo {
    * @since 7
    * @syscap SystemCapability.Ability.AbilityRuntime.Core
    */
-   processName: string;
+  processName: string;
 }