کاس‌یوتیل

public final class CasUtil
extends Object

شیء جاوا
↳ com.android.tradefed.util.CasUtil

خلاصه

ثابت‌ها

String ANDROID_INFO_FILENAME

String CAS_LOG_ROOT_NAME

String CHUNKS_DIR_NAME

String CHUNKS_INDEX_FILENAME

String SUPER_IMAGE_FILENAME

String SYSTEM_IMAGE_FILENAME

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

static void checkCasClientFlags (Path clientPath, Consumer<Set<String>> flagsConsumerFn)

پرچم‌های پشتیبانی‌شده‌ی کلاینت CAS را بررسی می‌کند.

static Path createUniqueCasLogDir (Path logDirRootPath)
static void ensureCasClientExecutable (Path casClientPath, boolean logMetricsIfNotExecutable)
static String getCasLogFromDir (Path logDirPath)

فایل لاگ CAS را می‌خواند " ‎"‎از دایرکتوری داده شده، فایل .INFO"‎ را ایجاد کنید.

static String getCasLogFromDir (Path logDirPath, String clientName, String tag, boolean removeLogDirAfterRead)

فایل لاگ CAS را از دایرکتوری داده شده می‌خواند.

static String getCasLogFromDir (Path logDirPath, String clientName)

فایل لاگ CAS را می‌خواند " ‎.INFO"‎ را از دایرکتوری داده شده حذف کرده و دایرکتوری log را حذف کنید.

static boolean isChunkedDir (Path path)

اگر مسیر داده شده یک دایرکتوری معتبر FastCDC-chunked باشد، مقدار true را برمی‌گرداند.

static boolean isUncompressedDeviceImage (Path path)

اگر مسیر داده شده یک تصویر دستگاه فشرده نشده و معتبر باشد، مقدار true را برمی‌گرداند.

static void logCasClientVersion (Path clientPath, Consumer<String> versionHandlerFn)
static void logCasClientVersion (Path clientPath)
static void validateChunkedDir (Path path)

تأیید می‌کند که مسیر داده شده یک دایرکتوری معتبر FastCDC-chunked است.

ثابت‌ها

نام فایل اطلاعات اندروید 

public static final String ANDROID_INFO_FILENAME

مقدار ثابت: "android-info.txt"

نام_ROOT_LOG_CAS 

public static final String CAS_LOG_ROOT_NAME

مقدار ثابت: "tf-cas-fuse-log-root"

CHUNKS_DIR_NAME 

public static final String CHUNKS_DIR_NAME

مقدار ثابت: "_chunks"

CHUNKS_INDEX_FILENAME 

public static final String CHUNKS_INDEX_FILENAME

مقدار ثابت: "_chunks_index.json"

نام فایل SUPER_IMAGE 

public static final String SUPER_IMAGE_FILENAME

مقدار ثابت: "super.img"

نام فایل تصویر سیستم 

public static final String SYSTEM_IMAGE_FILENAME

مقدار ثابت: "system.img"

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

پرچم‌های بررسی‌شده‌ی کلاینت 

public static void checkCasClientFlags (Path clientPath, 
                Consumer<Set<String>> flagsConsumerFn)

پرچم‌های پشتیبانی‌شده‌ی کلاینت CAS را بررسی می‌کند.

پارامترها
clientPath Path : مسیر فایل باینری کلاینت CAS.

flagsConsumerFn Consumer : مصرف‌کننده‌ای که مجموعه پرچم‌های پشتیبانی‌شده را می‌پذیرد.

ایجادUniqueCasLogDir 

public static Path createUniqueCasLogDir (Path logDirRootPath)

پارامترها
logDirRootPath Path

بازگشت‌ها
Path

پرتاب‌ها
IOException

sureCasClientExecutable 

public static void ensureCasClientExecutable (Path casClientPath, 
                boolean logMetricsIfNotExecutable)

پارامترها
casClientPath Path

logMetricsIfNotExecutable boolean

دریافت CassLogFromDir 

public static String getCasLogFromDir (Path logDirPath)

فایل لاگ CAS را می‌خواند " .INFO" را از دایرکتوری داده شده انتخاب می‌کند. فرض می‌کند که دایرکتوری لاگ مربوط به یک کلاینت CAS واحد است و `clientName` را از نام فایل لاگ استخراج می‌کند.

پارامترها
logDirPath Path : مسیر دایرکتوری برای خواندن فایل لاگ CAS.

بازگشت‌ها
String محتوای فایل لاگ CAS یا در صورت عدم امکان خواندن فایل لاگ، null.

دریافت CassLogFromDir 

public static String getCasLogFromDir (Path logDirPath, 
                String clientName, 
                String tag, 
                boolean removeLogDirAfterRead)

فایل لاگ CAS را از دایرکتوری داده شده می‌خواند.

پارامترها
logDirPath Path : مسیر دایرکتوری برای خواندن فایل لاگ CAS.

clientName String : نام کلاینت CAS.

tag String : برچسب فایل گزارش CAS، مانند "INFO"، "WARNING"، "ERROR" و غیره.

removeLogDirAfterRead boolean : آیا پس از خواندن فایل لاگ، دایرکتوری لاگ حذف شود یا خیر.

بازگشت‌ها
String محتوای فایل لاگ CAS.

پرتاب‌ها
IOException اگر فایل لاگ CAS قابل خواندن نباشد.

دریافت CassLogFromDir 

public static String getCasLogFromDir (Path logDirPath, 
                String clientName)

فایل لاگ CAS را می‌خواند " .INFO" را از دایرکتوری داده شده حذف کرده و دایرکتوری لاگ را حذف می‌کند. این یک روش راحت است که متد فوق را با پارامترهای پیش‌فرض پوشش می‌دهد. همچنین IOException را مدیریت می‌کند و در صورت عدم امکان خواندن فایل لاگ، مقدار null را برمی‌گرداند.

پارامترها
logDirPath Path : مسیر دایرکتوری برای خواندن فایل لاگ CAS.

clientName String : نام کلاینت CAS.

بازگشت‌ها
String محتوای فایل لاگ CAS یا اگر فایل لاگ قابل خواندن نباشد، "".

isChunkedDir 

public static boolean isChunkedDir (Path path)

اگر مسیر داده شده یک دایرکتوری معتبر FastCDC-chunked باشد، مقدار true را برمی‌گرداند.

پارامترها
path Path

بازگشت‌ها
boolean

تصویر دستگاه فشرده نشده 

public static boolean isUncompressedDeviceImage (Path path)

اگر مسیر داده شده یک تصویر دستگاه فشرده نشده و معتبر باشد، مقدار true را برمی‌گرداند.

برای قوی‌ترین و قابل اعتمادترین بررسی، وجود (system.img یا super.img) و android-info.txt را تأیید کنید.

system.img/super.img: تأیید می‌کند که داده‌های اصلی سیستم‌عامل وجود دارد.

android-info.txt: تأیید می‌کند که این یک بسته ساخت رسمی با فراداده‌هایی است که دستگاه و نسخه ساخت را توصیف می‌کنند.

وقوع این ترکیب در دایرکتوری که یک تصویر دستگاه فشرده نشده نیست و مواردی مانند ساخت تلویزیون را که boot.img در آن وجود ندارد، به درستی مدیریت می‌کند، بسیار بعید است.

پارامترها
path Path : مسیر مطلق به تصویر دستگاه.

بازگشت‌ها
boolean اگر مسیر، یک تصویر دستگاه فشرده نشده و معتبر باشد، مقدار درست (true) و در غیر این صورت مقدار نادرست (false) است.

نسخه کلاینت لاگ‌کَس 

public static void logCasClientVersion (Path clientPath, 
                Consumer<String> versionHandlerFn)

پارامترها
clientPath Path

versionHandlerFn Consumer

نسخه کلاینت لاگ‌کَس 

public static void logCasClientVersion (Path clientPath)

پارامترها
clientPath Path

اعتبارسنجیChunkedDir 

public static void validateChunkedDir (Path path)

تأیید می‌کند که مسیر داده شده یک دایرکتوری معتبر FastCDC-chunked است.

   device_image.zip/
     _chunks/
       _chunks_index.json
       chunk1.img
     _chunks_index.json
فقط اعتبار محتوای مسیر داده منبع بررسی می‌شود. _chunks_index.json باید یا در دایرکتوری _chunks یا به عنوان یک خواهر و برادر از _chunks (برای سازگاری معکوس) وجود داشته باشد.

پارامترها
path Path : مسیر دایرکتوری تکه‌تکه شده.

پرتاب‌ها
IOException اگر مسیر یک دایرکتوری معتبر FastCDC-chunked نباشد.