Starts logging Android device logs using ADB.
This function initiates log capturing for specified Android devices using ADB (Android Debug Bridge).
Logs are saved to a CSV file for further analysis.
Args:
adb_path (str): Path to the ADB executable.
csv_output (str): Path to the CSV file where the logs will be saved.
device_serials (str or list): A single device serial number as a string, or a list of serial numbers
for multiple devices. Serial numbers are used to identify connected devices.
print_stdout (bool, optional): If True, prints log messages to the console. Default is True.
clear_log (bool, optional): If True, clears the device log before capturing. Default is True.
ljustserial (int, optional): Left-justifies the device serial number in the printed output. Default is 16.
Returns:
None
Example:
from logcatdevices import start_logcat
androidcsv = "c:\\csvandroisad.csv"
_ = start_logcat(
adb_path=r"C:\Android\android-sdk\platform-tools\adb.exe",
csv_output=androidcsv,
device_serials=[
"127.0.0.1:5565",
"127.0.0.1:7555",
"127.0.0.1:7556",
"emulator-5554",
"emulator-5564",
],
print_stdout=True,
clear_log=True,
ljustserial=16,
)Converts a CSV log file to a pandas DataFrame.
This function reads a CSV file containing Android device log data and converts it into a structured
pandas DataFrame, enabling easy data manipulation and analysis.
Args:
csvfile (str): Path to the CSV log file.
Returns:
pandas.DataFrame: A DataFrame containing log data with the following columns:
- aa_source (str): Source of the log message.
- aa_date (datetime): Date and time of the log message.
- aa_processID (int): Process ID associated with the log message.
- aa_threadID (int): Thread ID associated with the log message.
- aa_logType (str): Type of log message (e.g., 'V', 'D', 'I', 'W', 'E').
- aa_tag (str): Tag associated with the log message.
- aa_message (str): Log message content.
Example:
from logcatdevices import csv2df
androidcsv = "c:\\csvandroisad.csv"
df = csv2df(androidcsv)
print(df.to_string())