FAQs About Application Packages

How Do I Obtain the Fingerprint in the Signature Information?

Call an API.

You can call bundleManager.getBundleInfoForSelf to obtain the application's own BundleInfo. BundleInfo contains signatureInfo, which includes fingerprint information generated using the SHA-256 hash algorithm.

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

let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION |
  bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_SIGNATURE_INFO;
try {
  bundleManager.getBundleInfoForSelf(bundleFlags).then((bundleInfo:bundleManager.BundleInfo) => {
    console.info('testTag', 'getBundleInfoForSelf successfully. fingerprint: ', bundleInfo.signatureInfo.fingerprint);
  }).catch((err: BusinessError) => {
    console.error('testTag', 'getBundleInfoForSelf failed. Cause: ', err.message);
  });
} catch (err) {
  let message = (err as BusinessError).message;
  console.error('testTag', 'getBundleInfoForSelf failed: %{public}s', message);
}

GetFingerprint.ets

Use Bundle Manager to obtain the fingerprint information. The fingerprint information is generated using the SHA-256 hash algorithm.

hdc shell
# Replace **com.example.myapplication** with the actual bundle name.
bm dump -n com.example.myapplication | grep fingerprint

alt text

Obtain fingerprint information from the .cer certificate file. The fingerprint information is generated using the SHA-1 hash algorithm.
Obtain fingerprint information using the keytool tool. For details, see Generating a Signing Certificate Fingerprint. The fingerprint information is generated using the SHA-256 hash algorithm.

What Is appIdentifier?

appIdentifier, generated during application signing, is a field in the profile and is the unique identifier of an application. There are two ways to generate an application identifier:

Randomly generate the appIdentifier field through automatic signing on DevEco Studio. Signing on different devices or re-signing will result in different values of appIdentifier.
Manually configure the signature. The **appIdentifier** field here is the same as the **app-identifier** field in the [HarmonyAppProvision configuration file](../security/app-provision-structure.md). For details, see [hapsigner Guide](../security/hapsigntool-guidelines.md).

Therefore, manual signing is recommended in scenarios where appIdentifier must remain unchanged, such as cross-device debugging, cross-application interaction debugging, or multi-user development with a shared key. For details, see Use Cases for Automatic and Manual Signing.

How Do I Obtain appIdentifier from Application Information?

You can call bundleManager.getBundleInfoForSelf to obtain the bundle information, which contains the signature information, and signature information in turn contains the appIdentifier.

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

let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION |
  bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_SIGNATURE_INFO;
try {
  bundleManager.getBundleInfoForSelf(bundleFlags).then((bundleInfo:bundleManager.BundleInfo) => {
    console.info('testTag', 'getBundleInfoForSelf successfully. appIdentifier:', bundleInfo.signatureInfo.appIdentifier);
  }).catch((err: BusinessError) => {
    console.error('testTag', 'getBundleInfoForSelf failed. Cause:', err.message);
  });
} catch (err) {
  let message = (err as BusinessError).message;
  console.error('testTag', 'getBundleInfoForSelf failed:', message);
}

GetAppIdentifier.ets

Use the bm tool.

hdc shell
# Replace **com.example.myapplication** with the actual bundle name.
bm dump -n com.example.myapplication | grep appIdentifier

alt text

What Is appId?

appId, the unique identifier of an application, consists of a bundle name, underscore (_), and Base64-encoded public key of the certificate. Since it changes with the public key of the signing certificate, you are advised to use appIdentifier as the unique identifier of an application.

How do I obtain appId from application information?

You can call bundleManager.getBundleInfoForSelf to obtain the bundle information, which contains the signature information, and signature information in turn contains the appId.

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

let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION |
  bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_SIGNATURE_INFO;
try {
  bundleManager.getBundleInfoForSelf(bundleFlags).then((bundleInfo:bundleManager.BundleInfo) => {
    console.info('testTag', 'getBundleInfoForSelf successfully. appId:', bundleInfo.signatureInfo.appId);
  }).catch((err: BusinessError) => {
    console.error('testTag', 'getBundleInfoForSelf failed. Cause:', err.message);
  });
} catch (err) {
  let message = (err as BusinessError).message;
  console.error('testTag', 'getBundleInfoForSelf failed:', message);
}

GetAppId.ets

Use the bm tool.

hdc shell
# Replace **ohos.app.hap.myapplication** with the actual bundle name.
bm dump -n ohos.app.hap.myapplication |grep '"appId":'

alt text

Application UID

A UID is a unique identifier used by the system for application sandbox isolation. It is assigned to each application process to ensure runtime isolation between applications, such as file system isolation and memory space isolation.

The algorithm for generating a UID is as follows: uid = userId * 200000 + (bundleId % 200000). Here, % indicates the modulo operation, which calculates the remainder of bundleId divided by 200,000. userId indicates the ID of the user for whom the application is installed. You can obtain it through the getOsAccountLocalId API. bundleId indicates the unique ID of the application. Its value ranges from 10000 to 65535 and is used only internally by the system. It can be derived from uid and userId, or obtained through getBundleIdForUid.

How to Obtain the Application UID?

Use the bm tool.

hdc shell
# Replace **ohos.app.hap.myapplication** with the actual bundle name.
bm dump -n ohos.app.hap.myapplication |grep uid

alt text

You can call bundleManager.getBundleInfoForSelf to obtain the application's own BundleInfo. For sample code, see How do I obtain appIdentifier from application information?. The UID can be obtained through bundleInfo.appInfo.uid.