Skip to content

Commit 01493f5

Browse files
authored
Updates from editor
1 parent a2fe575 commit 01493f5

1 file changed

Lines changed: 11 additions & 11 deletions

File tree

support/entra/entra-id/app-integration/package-inspector-msal-android-native.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@ title: Package Inspector for MSAL Android Native
33
description: Introduces how to install and use the Package Inspector tool.
44
ms.reviewer: markbukovich, v-weizhu
55
ms.service: entra-id
6-
ms.date: 03/12/2025
6+
ms.date: 03/13/2025
77
ms.custom: sap:Developing or Registering apps with Microsoft identity platform
88
---
99
# Package Inspector for MSAL Android Native
1010

11-
The Microsoft Authentication Library (MSAL) for Android Native includes a tool called Package Inspector. This tool lists the packages installed on an Android device and allows users to view, copy, and paste the signature hash used to sign an application's package. Package Inspector is invaluable for troubleshooting and verifying the signature hash for applications installed on an Android device. This article covers installation, usage, and common issues of the Package Inspector.
11+
The Microsoft Authentication Library (MSAL) for Android Native includes a tool called Package Inspector. This tool lists the packages installed on an Android device and allows users to view, copy, and paste the signature hash used to sign an application's package. Package Inspector is invaluable for troubleshooting and verifying the signature hash of applications installed on an Android device. This article covers installation, usage, and common issues of the Package Inspector.
1212

1313
## Scenarios for using Package Inspector
1414

@@ -20,13 +20,13 @@ The Microsoft Authentication Library (MSAL) for Android Native includes a tool c
2020

2121
> The redirect URI in the configuration file doesn't match with the one generated with the package name and signature hash. Please verify the uri in the config file and your app registration in Azure portal.
2222
23-
In this scenario, you can use the Package Inspector to verify what the package signature hash is and configure both the Azure portal and application to use the correct signature hash.
23+
In this scenario, you can use Package Inspector to verify what the package signature hash is and configure both the Azure portal and application to use the correct signature hash.
2424

2525
- You are implementing MSAL in your Android application, but encounter the following error:
2626

2727
> Intent filter for: BrowserTabActivity is missing
2828
29-
This error can occur because the signature hash specified in the *AndroidManifest.xml* file doesn't match the signature hash actually used to sign the APK file. In this scenario, Package Inspector is useful to verify what the signature hash actually is.
29+
This error occurs because the signature hash specified in the *AndroidManifest.xml* file doesn't match the signature hash used to sign the APK file. In this scenario, Package Inspector is useful to verify what the signature hash is.
3030

3131
> [!NOTE]
3232
> For more information about MSAL for Android Native, see [Microsoft Authentication Library (MSAL) for Android](https://github.com/AzureAD/microsoft-authentication-library-for-android).
@@ -51,7 +51,7 @@ There are two methods to install Package Inspector:
5151
1. Open Android Studio and close any open projects.
5252
2. Select **Get From Version Control**.
5353

54-
:::image type="content" source="media/package-inspector-msal-android-native/get-from-version-control.png" alt-text="Screenshot that shows the 'Get From Version Control' option in Android Studio" lightbox="media/package-inspector-msal-android-native/get-from-version-control.png":::
54+
:::image type="content" source="media/package-inspector-msal-android-native/get-from-version-control.png" alt-text="Screenshot that shows the 'Get From Version Control' option in Android Studio":::
5555
3. Ensure **Git** is selected at the top of the window, paste the Android MSAL repository URL `https://github.com/AzureAD/microsoft-authentication-library-for-android.git`, and then select **Clone**.
5656

5757
:::image type="content" source="media/package-inspector-msal-android-native/clone-msal-repository.png" alt-text="Screenshot that shows how to clone a Git repository in Android Studio":::
@@ -74,26 +74,26 @@ There are two methods to install Package Inspector:
7474
7575
## Use Package Inspector
7676

77-
1. With the Android MSAL project open in Android Studio, connect the desired Android device. This can be a physical device connected to the computer's USB port or an emulator booted from Android Studio's AVD manager. Ensure your device appears in the drop-down list at the top of Android Studio and select it.
77+
1. With the Android MSAL project open in Android Studio, connect the desired Android device. It can be a physical device connected to the computer's USB port or an emulator booted from Android Studio's AVD manager. Ensure your device appears in the drop-down list at the top of Android Studio and select it.
7878
2. On the left of the device drop-down list, there is another drop-down list. Select **package-inspector** from it.
7979

8080
:::image type="content" source="media/package-inspector-msal-android-native/select-package-inspector.png" alt-text="Screenshot that shows the selection of package-inspector in Android Studio" lightbox="media/package-inspector-msal-android-native/select-package-inspector.png":::
81-
3. Select the **play** button (indicated with a green circle on the right) to build, install, and run the package inspector on the selected device.
81+
3. Select the **play** button (indicated with a green circle on the right) to build, install, and run Package Inspector on the selected device.
8282

8383
:::image type="content" source="media/package-inspector-msal-android-native/select-play-button.png" alt-text="Screenshot that shows the selection of the play button in Android Studio" lightbox="media/package-inspector-msal-android-native/select-play-button.png":::
84-
4. Browse the list of packages in the Package Inspector app and select a package to view its signature hash. All accessible packages will appear in this list.
84+
4. Browse the list of packages in the Package Inspector app and select a package to view its signature hash. All accessible packages appear in this list.
8585

8686
:::image type="content" source="media/package-inspector-msal-android-native/select-package-to-check-signature-hash.png" alt-text="Screenshot that shows package selection in the Package Inspector app":::
8787

8888
## Common issues
8989

9090
### Issues when loading Package Inspector into Android Studio
9191

92-
To resolve these issues, ensure you load the root package from the MSAL repository, not the package inspector. Make sure that the Android MSAL project you load into Android Studio is named `microsoft-authentication-library-for-android-dev` or whatever you have renamed the root directory on your system instead of `package-inspector`. For more information, see step 5 under [Option 2](#option-2-download-android-msal-repository-and-open-it-in-android-studio) in the [Install Package Inspector](#install-package-inspector) section.
92+
To resolve these issues, ensure you load the root package from the MSAL repository, not Package Inspector. Make sure that the Android MSAL project you load into Android Studio is named `microsoft-authentication-library-for-android-dev` or whatever you have renamed the root directory on your system instead of `package-inspector`. For more information, see step 5 under [Option 2](#option-2-download-android-msal-repository-and-open-it-in-android-studio) in the [Install Package Inspector](#install-package-inspector) section.
9393

9494
### Not all packages appear in Package Inspector
9595

96-
You have installed and opened Package Inspector, and a list of packages appear in the app. However, you don't see packages for any apps you have installed on the device. It might be due to changes in Android 11 (API 30). For more information, see [Package visibility](https://developer.android.com/training/package-visibility).
96+
You have installed and opened Package Inspector, and a list of packages appear in the app. However, you don't see packages for any apps you have installed on the device. The issue might occur due to changes in Android 11 (API 30). For more information, see [Package visibility](https://developer.android.com/training/package-visibility).
9797

9898
To resolve this issue, follow these steps:
9999

@@ -113,6 +113,6 @@ To resolve this issue, follow these steps:
113113
</queries>
114114
```
115115

116-
3. Rerun the application from Android Studio to apply the changes. Then, you should can see the packages you have installed.
116+
3. Rerun the application from Android Studio to apply the changes. Then, you can see the packages you have installed.
117117

118118
[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]

0 commit comments

Comments
 (0)