از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
DeviceImageZipFlashingTargetPreparer
public class DeviceImageZipFlashingTargetPreparer
extends DeviceUpdateTargetPreparer
یک آماده‌کننده هدف که دستگاه را با تصاویر دستگاه ارائه شده از طریق یک فرمت خاص فلش می‌کند.
الزامات سطح بالا برای قالب تصویر دستگاه:
- فایل تصویری دستگاه باید یک فایل فشرده باشد
- فایل فشرده باید شامل یک اسکریپت flash-all.sh در ریشه باشد
- اسکریپت باید فرض کند که دستگاه در فضای کاربر قابل مشاهده برای
adb devices است - بقیه فایل فشرده در همان مکان اسکریپت با طرح دایرکتوری یکسان استخراج می شود و اسکریپت ممکن است به هر فایل بسته بندی شده در zip از طریق مسیر نسبی اشاره کند.
- پس از فلش، اسکریپت باید دستگاه را به همان حالت برگرداند
- یک متغیر محیطی
ANDROID_SERIAL به عنوان بخشی از محیط اجرا روی شماره سریال دستگاه تنظیم می شود - ممکن است اسکریپت فرض کند که دارای
adb و fastboot در PATH است
این آماده‌کننده هدف، فایل فشرده تصویر دستگاه را باز می‌کند و
flash- all.sh محصور شده را تحت طرح فرضیات در الزامات بالا اجرا می‌کند.
خلاصه
روش های محافظت شده |
|---|
File | getDeviceUpdateImage () یک نمونه ERROR(/File) ارائه می دهد که نشان دهنده فایل تصویری دستگاه است که برای به روز رسانی استفاده می شود |
void | performDeviceUpdate (File deviceUpdateImage, ITestDevice device) زیپ به‌روزرسانی تصویر دستگاه را باز می‌کند و اسکریپت چشمک زن بسته را فراخوانی می‌کند |
void | postUpdateActions (File deviceUpdateImage, ITestDevice device) بدون عملیات |
void | preUpdateActions (File deviceUpdateImage, ITestDevice device) بدون عملیات |
سازندگان عمومی
DeviceImageZipFlashingTargetPreparer
public DeviceImageZipFlashingTargetPreparer ()
روش های محافظت شده
getDeviceUpdateImage
protected File getDeviceUpdateImage ()
یک نمونه ERROR(/File) ارائه می دهد که نشان دهنده فایل تصویری دستگاه است که برای به روز رسانی استفاده می شود
protected void performDeviceUpdate (File deviceUpdateImage,
ITestDevice device) زیپ به‌روزرسانی تصویر دستگاه را باز می‌کند و اسکریپت چشمک زن بسته را فراخوانی می‌کند
| پرتاب می کند |
|---|
DeviceNotAvailableException | |
TargetSetupError | |
postUpdateActions
protected void postUpdateActions (File deviceUpdateImage,
ITestDevice device) بدون عملیات
| پرتاب می کند |
|---|
DeviceNotAvailableException | |
TargetSetupError | |
preUpdateActions
protected void preUpdateActions (File deviceUpdateImage,
ITestDevice device) بدون عملیات
| پرتاب می کند |
|---|
DeviceNotAvailableException | |
TargetSetupError | |
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین به‌روزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# DeviceImageZipFlashingTargetPreparer\n====================================\n\n\n`\npublic\n\n\nclass\nDeviceImageZipFlashingTargetPreparer\n`\n\n\n`\n\n\n`\n\n`\n\n\n`\n\n`\n\n\n`\n\n`\n\nextends `[DeviceUpdateTargetPreparer](../../../../../../reference/tradefed/com/android/tradefed/targetprep/DeviceUpdateTargetPreparer.html)`\n\n\n`\n\n`\n\n\n`\n\n|---|---|---|---|----------------------------------------------------------------------|\n| java.lang.Object |||||\n| ↳ | [com.android.tradefed.targetprep.BaseTargetPreparer](../../../../../../reference/tradefed/com/android/tradefed/targetprep/BaseTargetPreparer.html) ||||\n| | ↳ | [com.android.tradefed.targetprep.DeviceBuildInfoBootStrapper](../../../../../../reference/tradefed/com/android/tradefed/targetprep/DeviceBuildInfoBootStrapper.html) |||\n| | | ↳ | [com.android.tradefed.targetprep.DeviceUpdateTargetPreparer](../../../../../../reference/tradefed/com/android/tradefed/targetprep/DeviceUpdateTargetPreparer.html) ||\n| | | | ↳ | com.android.tradefed.targetprep.DeviceImageZipFlashingTargetPreparer |\n\n\u003cbr /\u003e\n\n*** ** * ** ***\n\nA target preparer that flashes the device with device images provided via a specific format.\n\nHigh level requirements for the device image format:\n\n- Device image file must be a zip file\n- The zip file must include a flash-all.sh script at the root\n- The script must assume that the device is in userspace visible to `adb devices`\n- The rest of the zip file will be extracted into the same location as script with the same directory layout, and the script may make reference to any files packaged in the zip via relative path\n- After flashing, the script must return the device to the same state\n- An environment variable `ANDROID_SERIAL` will be set to device serial number as part of the execution environment\n- The script may assume that it has `adb` and `fastboot` on PATH\n\nThis target preparer will unpack the device image zip file and execute the enclosed `flash-\nall.sh` under the assumptions outline in requirements above.\n\n\u003cbr /\u003e\n\nSummary\n-------\n\n| ### Public constructors ||\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ` `[DeviceImageZipFlashingTargetPreparer](../../../../../../reference/tradefed/com/android/tradefed/targetprep/DeviceImageZipFlashingTargetPreparer.html#DeviceImageZipFlashingTargetPreparer())`() ` |\n\n| ### Protected methods ||\n|---------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ` File` | ` `[getDeviceUpdateImage](../../../../../../reference/tradefed/com/android/tradefed/targetprep/DeviceImageZipFlashingTargetPreparer.html#getDeviceUpdateImage())`() ` Provides a [ERROR(/File)](../../../../../../) instance representing the device image file to be used for updating |\n| ` void` | ` `[performDeviceUpdate](../../../../../../reference/tradefed/com/android/tradefed/targetprep/DeviceImageZipFlashingTargetPreparer.html#performDeviceUpdate(File,%20com.android.tradefed.device.ITestDevice))`(File deviceUpdateImage, ITestDevice device) ` Expands the device image update zip and calls the enclosed flashing script |\n| ` void` | ` `[postUpdateActions](../../../../../../reference/tradefed/com/android/tradefed/targetprep/DeviceImageZipFlashingTargetPreparer.html#postUpdateActions(File,%20com.android.tradefed.device.ITestDevice))`(File deviceUpdateImage, ITestDevice device) ` No-op |\n| ` void` | ` `[preUpdateActions](../../../../../../reference/tradefed/com/android/tradefed/targetprep/DeviceImageZipFlashingTargetPreparer.html#preUpdateActions(File,%20com.android.tradefed.device.ITestDevice))`(File deviceUpdateImage, ITestDevice device) ` No-op |\n\nPublic constructors\n-------------------\n\n### DeviceImageZipFlashingTargetPreparer\n\n```\npublic DeviceImageZipFlashingTargetPreparer ()\n```\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nProtected methods\n-----------------\n\n### getDeviceUpdateImage\n\n```\nprotected File getDeviceUpdateImage ()\n```\n\nProvides a [ERROR(/File)](../../../../../../) instance representing the device image file to be used for updating\n\n\u003cbr /\u003e\n\n| Returns ||\n|--------|--------|\n| `File` | \u003cbr /\u003e |\n\n### performDeviceUpdate\n\n```\nprotected void performDeviceUpdate (File deviceUpdateImage, \n ITestDevice device)\n```\n\nExpands the device image update zip and calls the enclosed flashing script\n\n\u003cbr /\u003e\n\n| Throws ||\n|-------------------------------|---|\n| `DeviceNotAvailableException` | |\n| `TargetSetupError` | |\n\n### postUpdateActions\n\n```\nprotected void postUpdateActions (File deviceUpdateImage, \n ITestDevice device)\n```\n\nNo-op\n\n\u003cbr /\u003e\n\n| Throws ||\n|-------------------------------|---|\n| `DeviceNotAvailableException` | |\n| `TargetSetupError` | |\n\n### preUpdateActions\n\n```\nprotected void preUpdateActions (File deviceUpdateImage, \n ITestDevice device)\n```\n\nNo-op\n\n\u003cbr /\u003e\n\n| Throws ||\n|-------------------------------|---|\n| `DeviceNotAvailableException` | |\n| `TargetSetupError` | |"]]
