Android SDK Logging and Troubleshooting

This page covers capturing Arkose Android SDK logs from a device or emulator using adb, for both the Jetpack Compose and XML/View-based integration paths.

Prerequisites

1. Install the Android Debug Bridge (adb) binary or driver on the machine where the logs will go.
2. An Android phone or Android emulator. On it, under Settings > Developer, enable the USB Debugging option

Steps

On the machine where the logs will go:

1. Download the SDK platform for your platform (Windows / Mac) from SDK Platform Tools release notes | Android Developers

2. Unzip the folder and check it contains an adb.exe file.

3. From the command prompt, enter the path where adb is located on the machine. This image shows an example of what you get after you enter the path.

   

4. On your Android device, enable USB debugging:

   1. At Phone>Settings>About Phone>, tap Build Number seven times. You should see a message saying that you are now a developer.

   2. On the device, go to Developer options and turn on USB debugging.

   3. Connect the device to the system and trust/allow the system.

   4. To test if adb is working properly:

      1. Use a USB cable to connect your Android device to your computer.

      2. At the computer’s command prompt, run the command adb devices to show the devices connected to the system.

         

5. To start verbose logging in the terminal window, at the computer’s command prompt, run adb logcat -s ArkoseLabsShowEnforcementChallenge:v If instead, you want to save the logs, run adb logcat -d > <path-where-you-want-to-save-file>/<filename>.txt Ctrl+C stops the logging.

adb logcat Options

adb logcat has several command options. These include:

• adb logcat : Prints log data to the screen.

• adb logcat *:V : Lowest priority, filter to only show Verbose level log entries.

• adb logcat --help : Shows all logcat options and arguments.

• adb logcat -c : Clears the logs .

• adb logcat -s <TAG>:<PRIORITY> :

  • -s: Sets default filter to silent.

  • <TAG>: A log component tag (or * for all).

  • <PRIORITY> can be:

    • V: Verbose (default for <TAG>)
    • D: Debug (default for *)
    • I: Info
    • W: Warn
    • E: Error
    • F: Fatal
    • S: Silent (suppress all output)