OpenHarmony: 如何获取当前HAP的BundleName

一、引言

在OpenHarmony应用开发的过程中，经常会有获取当前 HAP（HarmonyOS Ability Package）的 BundleName 的需求。今天就来给大家详细介绍一下，如何通过 bundleManager 模块来获取当前 HAP 的 BundleName。

二、bundleManager 模块的相关接口

（一）getBundleInfoForSelf 接口概述

bundleManager 模块为我们提供了便捷的途径来获取 HAP 的相关信息，其中的 getBundleInfoForSelf 接口尤为重要。通过这个接口，我们能够获取到当前 HAP 的众多关键信息，并且依据传入不同的参数，可以返回不同详细程度的内容。

（二）GET_BUNDLE_INFO_DEFAULT 参数

GET_BUNDLE_INFO_DEFAULT 是该接口默认的参数。当我们使用这个参数调用 getBundleInfoForSelf 接口时，返回结果中会有一个 name 字段，而这个字段对应的就是我们心心念念要获取的 BundleName 啦。使用这个参数的方式相对简洁，适用于只需要快速获取 BundleName 这一核心信息的场景。

（三）GET_BUNDLE_INFO_WITH_APPLICATION 参数

与之不同的是，GET_BUNDLE_INFO_WITH_APPLICATION 参数除了能够返回基本字段外，还可以额外获取到 ApplicationInfo 字段。可能有些小伙伴会问，这和 BundleName 有啥关系呀？其实呀，在 ApplicationInfo 的 name 字段同样也对应着 BundleName 呢。所以说，如果在开发过程中，除了 BundleName 之外，还需要获取更多应用相关的详细信息，那么选择这个参数就再合适不过了。

三、示例

下面咱们结合具体的代码示例来进一步理解，这里以 GET_BUNDLE_INFO_DEFAULT 为例哦。

首先，需要导入相关的模块：

import { bundleManager } from '@kit.AbilityKit'; 
import { hilog } from '@kit.PerformanceAnalysisKit'; 
import { BusinessError } from '@kit.BasicServicesKit'; 

接着，定义 bundleFlags 变量，并将其赋值为 bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT，这一步就是在告诉 getBundleInfoForSelf 接口，我们希望按照默认的参数获取信息呢。

let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT; 

然后就是通过 try-catch 语句来调用 getBundleInfoForSelf 接口啦，这样做是为了能妥善处理可能出现的异常情况哦。在成功获取到数据后，使用 hilog.info 来将获取到的信息以日志的形式输出，方便我们查看结果；要是出现了错误，也会通过 hilog.error 将错误原因记录下来呢。

try { 
    bundleManager.getBundleInfoForSelf(bundleFlags).then((data) => { 
        hilog.info(0x0000, 'testTag', 'getBundleInfoForSelf successfully. Data: %{public}s', JSON.stringify(data)); 
    }).catch((err: BusinessError) => { 
        hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed. Cause: %{public}s', err.message); 
    }); 
} catch (err) { 
    let message = (err as BusinessError).message; 
    hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed: %{public}s', message); 
}