App Info
The App Info feature is currently supported only on the Android platform. Therefore, before you start using it, ensure that the functionality is available:
import { Platform } from 'react-native';
if (Platform.OS !== 'android') {
throw new Error("App Info is not supported on this platform")
}
The feature provides a utility method for obtaining information about an application installed on the device. This is useful when you need to display additional details about the app in your UI.
Obtaining App Info
To get information about a specific application, you can use the getAppInfo method. You need to provide the package name of the app you’re interested in.
import { Malwarelytics, AppInfo } from 'react-native-malwarelytics';
async function logAppInfo(packageName: string) {
const appInfo: AppInfo | null = await Malwarelytics.sharedInstance.getAppInfo(packageName);
if (appInfo) {
console.log(`App Name: ${appInfo.appName}`);
console.log(`Package Name: ${appInfo.packageName}`);
// The icon is a Base64 encoded PNG string.
// You can use it in the <Image> component for the source parameter.
} else {
console.log(`Application with package name ${packageName} was not found.`);
}
}
By default, the method doesn’t retrieve the list of permissions required by the application. If you need this information, you can pass an optional boolean parameter:
const withPermissions = true;
const appInfo: AppInfo | null = await Malwarelytics.sharedInstance.getAppInfo("com.example.app", withPermissions);
if (appInfo) {
console.log(`Permissions: ${appInfo.permissions.join(', ')}`);
}
The AppInfo Object
The getAppInfo method returns a promise that resolves to an AppInfo object or null if the application is not found. The AppInfo object has the following structure:
| Property | Type | Description |
|---|---|---|
packageName |
string |
The application’s package name (Application ID). |
appName |
string |
The application’s name, localized to the current device. |
icon |
string |
A Base64 encoded PNG string of the application’s icon. |
permissions |
string[] |
A list of permissions the application requires. |