# Android

Obtaining troubleshooting logs and understanding the minimum system requirements for Android operating system (OS) are both basic steps in troubleshooting issues.

## Troubleshooting Logs

When softphone users encounter issues with the application, retrieve Session Initiation Protocol (SIP) logs from their devices and send the files to the support team for troubleshooting purposes.

### SIP Logs

SIP logs are generated by the softphone application. The logs contain communication details such as the application information, device information, network information, and error messages during calls or registration.

<a id="enabling-sip-logging-android"></a>
#### Enabling SIP Logging

SIP logging is not enabled by default. The softphone application collects troubleshooting logs once the logging function is enabled.
To ensure that error details are recorded in the logs, users must enable this function before errors occur.

1. Select <span class="inline-icon inline-icon--android-settings" role="img" aria-label="Android settings icon"></span> > **Settings** > **Preferences**.
2. Under **Other**, enable **Troubleshooting log**.
3. Select **Back**.
   The **Logs** option displays on the **Settings** screen.

#### Retrieving SIP Logs

Softphone users can retrieve SIP logs in the application only after enabling the SIP logging function.

!!! note
    If users intend to reproduce an error and record its details in the log for troubleshooting, they must first enable the logging function.
    Refer to the [Enabling SIP Logging](#enabling-sip-logging-android) section to turn on this function.

1. Select <span class="inline-icon inline-icon--android-settings" role="img" aria-label="Android settings icon"></span> > **Settings** > **Logs**.
2. On the **Logs** screen, touch <span class="inline-icon inline-icon--android-settings" role="img" aria-label="Android settings icon"></span> > **Share**.
3. Send the log text file to the support team.

<iframe width="560" height="315" src="https://www.youtube.com/embed/ApmsY09Fk0s" title="Android SIP log tutorial" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

### Turnkey Messaging Logs

Turnkey messaging logs record SIP logs and information about the messaging service process, including the message delivery status and any errors that occurred.
The messaging logs are useful for troubleshooting issues specific to our Turnkey messaging solution.

!!! note
    Acrobits Turnkey messaging solution is different from SIMPLE messaging and Fetch Messaging.
    If the softphone has issues with sending or receiving SIMPLE or Fetch instant messages, use the SIP log workflow at the top of this page.

#### Retrieving Turnkey Messaging Logs

Users must first enable the logging function before retrieving the messaging log file.
Refer to the [Enabling SIP Logging](#enabling-sip-logging-android) section to turn on this function.

1. Select the **Chat** tab.
2. Select <span class="inline-icon inline-icon--android-settings" role="img" aria-label="Android settings icon"></span> > **Share logs**.
3. On the **Sharing 1 file** window, select the app to send the log text file to the support team.

<iframe width="560" height="315" src="https://www.youtube.com/embed/WtgvWRss8GI?si=ZEtiWBrHrogXjeIm" title="Android turnkey messaging logs tutorial" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

### Bug Reports

Bug reports are helpful in providing detailed information about crashes, freezes, or unexpected behavior that occur during use.

#### Retrieving Bug Reports

A bug report is available in **Developer options**, but **Developer options** is not visible by default.
To retrieve a bug report from an Android device, follow these steps:

1. To enable **Developer option**:
   1. Go to device **Settings** > **About phone**.
   2. Scroll down to **Build number**.
   3. Tap **Build number** repeatedly until the message **You are now a developer!** appears.
   4. Select **Back**.
2. Select **System** > **Developer options**.
3. Ensure **Developer options** are enabled and **Bug report** or **Take bug report** or a similar option is available.
4. To capture information about the error or crash:
   1. Recreate the issue so that the event is captured in the bug report.
   2. Return to **Developer options**, select **Bug report** or **Take bug report** or a similar option. The compilation may take several minutes.
5. Send the bug report to your email, and then attach it to the Acrobits support ticket.

## Minimum System Requirements

To ensure the softphone application runs smoothly, user devices must meet certain minimum system requirements.

### OS Versions

The minimum supported OS version is Android 8.