آی‌لاگ‌سیور

public interface ILogSaver

com.android.tradefed.result.ILogSaver

کلاس‌هایی که این رابط را پیاده‌سازی می‌کنند، متدهایی برای ذخیره لاگ‌ها در یک مکان مرکزی ارائه می‌دهند.

یک ILogSaver در پیکربندی تعریف شده است و مسئول ذخیره لاگ‌ها در یک مکان مرکزی است. همچنین متدهایی را در اختیار قرار می‌دهد تا ILogSaverListener ها بتوانند فایل‌های اضافی را در همان مکان ذخیره کنند.

خلاصه

روش‌های عمومی

abstract LogFile getLogReportDir ()

LogFile حاوی مسیر و/یا URL دایرکتوری که لاگ‌ها در آن ذخیره می‌شوند را دریافت کنید.

default void init ( IInvocationContext context)

اطلاع‌رسانی زودهنگام در مورد مقداردهی اولیه، قبل از اینکه هرگونه اطلاعات ساخت در دسترس قرار گیرد.

abstract void invocationEnded (long elapsedTime)

گزارش می‌دهد که فراخوانی، چه با موفقیت و چه به دلیل وجود برخی خطاها، خاتمه یافته است.

abstract void invocationStarted ( IInvocationContext context)

شروع فراخوانی تست را گزارش می‌دهد.

abstract LogFile saveLogData (String dataName, LogDataType dataType, InputStream dataStream)

داده‌های لاگ را ذخیره کنید.

default LogFile saveLogDataRaw (String dataName, LogDataType dataType, InputStream dataStream)

این متد منسوخ شده است. به جای آن از saveLogData(String, com.android.tradefed.result.LogDataType, InputStream) استفاده کنید.

default LogFile saveLogFile (String dataName, LogDataType dataType, File fileToLog)

فایل لاگ را ذخیره کنید.

روش‌های عمومی

دریافت گزارش گزارش 

public abstract LogFile getLogReportDir ()

LogFile حاوی مسیر و/یا URL دایرکتوری که لاگ‌ها در آن ذخیره می‌شوند را دریافت کنید.

بازگشت‌ها
LogFile LogFile ).

اولیه 

public void init (IInvocationContext context)

اطلاع‌رسانی زودهنگام در مورد راه‌اندازی اولیه، قبل از اینکه هرگونه اطلاعات ساخت در دسترس باشد. این امر امکان تنظیم هرگونه الزامات برای دریافت گزارش‌ها را فراهم می‌کند.

پارامترها
context IInvocationContext : اطلاعاتی در مورد فراخوانی.

فراخوان پایان یافت 

public abstract void invocationEnded (long elapsedTime)

گزارش می‌دهد که فراخوانی، چه با موفقیت و چه به دلیل وجود برخی خطاها، خاتمه یافته است.

پس از فراخوانی ITestInvocationListener.invocationEnded(long) به طور خودکار توسط چارچوب TradeFederation فراخوانی می‌شود.

پارامترها
elapsedTime long : زمان سپری شده از فراخوانی بر حسب میلی‌ثانیه

فراخوان شروع شد 

public abstract void invocationStarted (IInvocationContext context)

شروع فراخوانی تست را گزارش می‌دهد.

قبل از فراخوانی ITestInvocationListener.invocationStarted(IInvocationContext) به طور خودکار توسط چارچوب TradeFederation فراخوانی می‌شود.

پارامترها
context IInvocationContext : اطلاعاتی در مورد فراخوانی.

ذخیره اطلاعات 

public abstract LogFile saveLogData (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

داده‌های لاگ را ذخیره کنید.

هر زمان که ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) فراخوانی شود، به طور خودکار توسط چارچوب TradeFederation فراخوانی می‌شود. همچنین می‌توان از آن به عنوان یک متد کمکی برای ذخیره داده‌های لاگ اضافی استفاده کرد.

بسته به پیاده‌سازی و سیاست، لاگ‌ها ممکن است به صورت فشرده ذخیره شوند. همچنین ممکن است لاگ‌ها در مکانی غیرقابل دسترس برای Tradefed ذخیره شوند.

پارامترها
dataName String : یک نام توصیفی String از داده‌ها. مثلاً "device_logcat"

dataType LogDataType : LogDataType فایل.

dataStream InputStream : ERROR(/InputStream) مربوط به داده‌ها.

بازگشت‌ها
LogFile LogFile حاوی مسیر و آدرس اینترنتی (URL) فایل ذخیره شده.

پرتاب‌ها
اگر فایل لاگ ایجاد نشد

ذخیره لاگ دیتا راو 

public LogFile saveLogDataRaw (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

این روش منسوخ شده است.
به جای آن saveLogData(String, com.android.tradefed.result.LogDataType, InputStream) استفاده کنید.

یک متد کمکی برای ذخیره داده‌های لاگ بدون تغییر.

گزارش‌ها ممکن است در مکانی غیرقابل دسترس برای Tradefed ذخیره شوند.

پارامترها
dataName String : یک نام توصیفی String از داده‌ها. مثلاً "device_logcat".

dataType LogDataType : یک LogDataType حاوی نوع و پسوند فایل

dataStream InputStream : ERROR(/InputStream) مربوط به داده‌ها.

بازگشت‌ها
LogFile LogFile حاوی مسیر و آدرس اینترنتی (URL) فایل ذخیره شده.

پرتاب‌ها
اگر فایل لاگ ایجاد نشد

ذخیره فایل ثبت وقایع 

public LogFile saveLogFile (String dataName, 
                LogDataType dataType, 
                File fileToLog)

فایل لاگ را ذخیره کنید.

هر زمان که ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) فراخوانی شود و جریان به یک فایل ارجاع دهد، به طور خودکار توسط چارچوب TradeFederation فراخوانی می‌شود.

بسته به پیاده‌سازی و سیاست، لاگ‌ها ممکن است به صورت فشرده ذخیره شوند. همچنین ممکن است لاگ‌ها در مکانی غیرقابل دسترس برای Tradefed ذخیره شوند.

پارامترها
dataName String : یک نام توصیفی String از داده‌ها. مثلاً "device_logcat"

dataType LogDataType : LogDataType فایل.

fileToLog File : ERROR(/File) برای ذخیره.

بازگشت‌ها
LogFile LogFile حاوی مسیر و آدرس اینترنتی (URL) فایل ذخیره شده.

پرتاب‌ها
اگر فایل لاگ ایجاد نشد