اعتبارًا من عام 2026، ولضمان اتّساق نموذج التطوير الثابت الأساسي واستقرار المنصة في النظام المتكامل، سننشر رمز المصدر في مشروع Android مفتوح المصدر (AOSP) في الربعَين الثاني والرابع. لبناء مشروع Android مفتوح المصدر والمساهمة فيه، استخدِم android-latest-release. سيشير فرع بيان android-latest-release دائمًا إلى أحدث إصدار تم نشره في مشروع Android مفتوح المصدر. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android مفتوح المصدر.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

BundletoolUtil

public class BundletoolUtil
extends Object

java.lang.Object
↳	com.android.tradefed.util.BundletoolUtil

فئة أداة تستخدم سطر أوامر bundletool لتثبيت ملفات ‎ .apks على الجهاز. رابط مستندات Bundletool: ‏ https://developer.android.com/studio/command-line/bundletool يتم تنزيل ملف bundletool.jar من فرع الوحدة غير المجمّعة مع ملف الوحدة.

ملخّص

طُرق وضع التصميم العامة
`BundletoolUtil(File bundletoolJar)`

الإجراءات العامة
`File`	`extractSplitsFromApks(File apks, String deviceSpecPath, ITestDevice device, IBuildInfo buildInfo)` تستخرج هذه السمة حِزمة APK أو APEX المجزّأة من ملف ‎ .apks.
`String`	`generateDeviceSpecFile(ITestDevice device)` تنشئ هذه السمة ملف JSON لإعداد جهاز متصل.
`void`	`installApks(File apks, ITestDevice device, List<String> extraArgs)` تثبِّت هذه السمة حِزم APK التي تستخدم bundletool.
`void`	`installApks(File apks, ITestDevice device)` تثبِّت هذه السمة حِزم APK التي تستخدم bundletool.
`void`	`installApksFromZip(File apksZip, ITestDevice device, List<String> extraArgs)` تثبيت حِزم APK الواردة في ملف ZIP المقدَّم

طُرق محمية
`String`	`getAdbPath()`
`File`	`getBundletoolFile()`
`IRunUtil`	`getRunUtil()`
`static long`	`parseCmdTimeout(List<String> args, long defaultValue)`

طُرق وضع التصميم العامة

BundletoolUtil

public BundletoolUtil (File bundletoolJar)

المعلَمات
`bundletoolJar`	`File`

الإجراءات العامة

extractSplitsFromApks

public File extractSplitsFromApks (File apks, 
                String deviceSpecPath, 
                ITestDevice device, 
                IBuildInfo buildInfo)

تستخرج هذه السمة حِزمة APK أو APEX المجزّأة من ملف ‎ .apks. تعيد تسمية حِزم التطبيق المقسَّمة وتخزِّنها في الدليل الذي يتم فيه تخزين ملفات ‎ .apks. تعرض هذه السمة الدليل الجديد الذي تم تخزين عمليات التقسيم فيه.

المعلَمات
`apks`	‫`File`: حِزم APK التي يجب استخراجها
`deviceSpecPath`	‫`String`: ملف مواصفات الجهاز الذي تستخدمه أداة Bundletool لاستخراج حِزم APK
`device`	‫`ITestDevice`: الجهاز المتصل
`buildInfo`	‫`IBuildInfo`: معلومات حول عنصر الإنشاء

المرتجعات
`File`	`File` وهو الدليل الذي يتم فيه حفظ حِزم APK أو APEX التي تم استخراجها

generateDeviceSpecFile

public String generateDeviceSpecFile (ITestDevice device)

تنشئ هذه السمة ملف JSON لإعداد جهاز متصل.

المعلَمات
`device`	‫`ITestDevice`: الجهاز المتصل

المرتجعات
`String`	`String` تمثّل مسار ملف مواصفات الجهاز.

عمليات الطرح
`IOException`

installApks

public void installApks (File apks, 
                ITestDevice device, 
                List<String> extraArgs)

تثبِّت هذه السمة حِزم APK التي تستخدم bundletool.

المعلَمات
`apks`	`File`: حِزم APK التي يجب تثبيتها
`device`	‫`ITestDevice`: الجهاز المتصل
`extraArgs`	`List`: لأمر bundletool

عمليات الطرح
`TargetSetupError`

installApks

public void installApks (File apks, 
                ITestDevice device)

تثبِّت هذه السمة حِزم APK التي تستخدم bundletool.

المعلَمات
`apks`	`File`: حِزم APK التي يجب تثبيتها
`device`	‫`ITestDevice`: الجهاز المتصل

عمليات الطرح
`TargetSetupError`

installApksFromZip

public void installApksFromZip (File apksZip, 
                ITestDevice device, 
                List<String> extraArgs)

تثبيت حِزم APK الواردة في ملف ZIP المقدَّم

المعلَمات
`apksZip`	‫`File`: ملف zip المطلوب تثبيته
`device`	‫`ITestDevice`: الجهاز المتصل
`extraArgs`	‫`List`: وسيطات إضافية لتمريرها إلى الأمر bundletool install

عمليات الطرح
`TargetSetupError`

طُرق محمية

getAdbPath

protected String getAdbPath ()

المرتجعات
`String`

getBundletoolFile

protected File getBundletoolFile ()

المرتجعات
`File`

getRunUtil

protected IRunUtil getRunUtil ()

المرتجعات
`IRunUtil`

parseCmdTimeout

protected static long parseCmdTimeout (List<String> args, 
                long defaultValue)

المعلَمات
`args`	`List`
`defaultValue`	`long`

القيم المُعادة
`long`

عمليات الطرح
`TargetSetupError`