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

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

RemoteFileUtil

public class RemoteFileUtil
extends Object

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

فئة الأدوات المساعدة للتعامل مع الملفات من مثيل بعيد

ملخّص

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

الإجراءات العامة
`static boolean`	`doesRemoteFileExist(String host, String user, File sshPrivateKey, IRunUtil runUtil, long timeout, String remotePath)` التحقّق مما إذا كان الملف (أو الدليل) متوفّرًا على الجهاز الظاهري البعيد
`static boolean`	`doesRemoteFileExist(String host, String user, File sshPrivateKey, IRunUtil runUtil, long timeout, String remotePath, String sshPortNumber)` التحقّق مما إذا كان الملف (أو الدليل) متوفّرًا على الجهاز الظاهري البعيد
`static boolean`	`fetchRemoteDir(String host, String user, File sshPrivateKey, IRunUtil runUtil, long timeout, String remoteDirPath, File localDir)` استرداد دليل بعيد من المضيف البعيد
`static File`	`fetchRemoteDir(String host, String user, File sshPrivateKey, IRunUtil runUtil, long timeout, String remoteDirPath)` استرداد دليل بعيد من المضيف البعيد
`static File`	`fetchRemoteDir(String host, String user, File sshPrivateKey, List<String> scpArgs, IRunUtil runUtil, long timeout, String remoteDirPath)` استرداد دليل بعيد من المضيف البعيد
`static boolean`	`fetchRemoteDir(String host, String user, File sshPrivateKey, List<String> scpArgs, IRunUtil runUtil, long timeout, String remoteDirPath, File localDir)` استرداد دليل بعيد من المضيف البعيد
`static File`	`fetchRemoteFile(String host, String user, File sshPrivateKey, List<String> scpArgs, IRunUtil runUtil, long timeout, String remoteFilePath)` استرداد ملف بعيد في مثيل الحاوية
`static File`	`fetchRemoteFile(String host, String user, File sshPrivateKey, IRunUtil runUtil, long timeout, String remoteFilePath)` استرداد ملف بعيد في مثيل الحاوية
`static boolean`	`fetchRemoteFile(String host, String user, File sshPrivateKey, List<String> scpArgs, IRunUtil runUtil, long timeout, String remoteFilePath, File localFile)` استرداد ملف بعيد في الجهاز أو مثيل الحاوية
`static boolean`	`fetchRemoteFile(String host, String user, File sshPrivateKey, IRunUtil runUtil, long timeout, String remoteFilePath, File localFile)` استرداد ملف بعيد في الجهاز أو مثيل الحاوية
`static boolean`	`pushFileToRemote(String host, String user, File sshPrivateKey, List<String> scpArgs, IRunUtil runUtil, long timeout, String remoteFilePath, File localFile)` إرسال `File` من المضيف المحلي إلى المثيل البعيد

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

RemoteFileUtil

public RemoteFileUtil ()

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

doesRemoteFileExist

public static boolean doesRemoteFileExist (String host, 
                String user, 
                File sshPrivateKey, 
                IRunUtil runUtil, 
                long timeout, 
                String remotePath)

التحقّق مما إذا كان الملف (أو الدليل) متوفّرًا على الجهاز الظاهري البعيد

المعلَمات
`host`	‫`String`: المضيف البعيد
`user`	`String`: المستخدم على المضيف البعيد
`sshPrivateKey`	`File`: الملف الذي يحتوي على مفتاح SSH المطلوب استخدامه.
`runUtil`	`IRunUtil`: `IRunUtil` لتنفيذ الأوامر
`timeout`	‫`long`: بالمللي ثانية لإكمال عملية الجلب
`remotePath`	`String`: المسار البعيد الذي يمكن العثور فيه على الملف

المرتجعات
`boolean`	ما إذا كان الملف متوفّرًا أم لا

doesRemoteFileExist

public static boolean doesRemoteFileExist (String host, 
                String user, 
                File sshPrivateKey, 
                IRunUtil runUtil, 
                long timeout, 
                String remotePath, 
                String sshPortNumber)

التحقّق مما إذا كان الملف (أو الدليل) متوفّرًا على الجهاز الظاهري البعيد

المعلَمات
`host`	‫`String`: المضيف البعيد
`user`	`String`: المستخدم على المضيف البعيد
`sshPrivateKey`	`File`: الملف الذي يحتوي على مفتاح SSH المطلوب استخدامه.
`runUtil`	`IRunUtil`: `IRunUtil` لتنفيذ الأوامر
`timeout`	‫`long`: بالمللي ثانية لإكمال عملية الجلب
`remotePath`	`String`: المسار البعيد الذي يمكن العثور فيه على الملف
`sshPortNumber`	‫`String`: رقم منفذ ssh.

المرتجعات
`boolean`	ما إذا كان الملف متوفّرًا أم لا

fetchRemoteDir

public static boolean fetchRemoteDir (String host, 
                String user, 
                File sshPrivateKey, 
                IRunUtil runUtil, 
                long timeout, 
                String remoteDirPath, 
                File localDir)

استرداد دليل بعيد من المضيف البعيد

المعلَمات
`host`	‫`String`: المضيف البعيد
`user`	`String`: المستخدم على المضيف البعيد
`sshPrivateKey`	`File`: الملف الذي يحتوي على مفتاح SSH المطلوب استخدامه.
`runUtil`	`IRunUtil`: `IRunUtil` لتنفيذ الأوامر
`timeout`	‫`long`: بالمللي ثانية لإكمال عملية الجلب
`remoteDirPath`	`String`: المسار البعيد الذي يمكن العثور فيه على الدليل
`localDir`	`File`: الدليل المحلي الذي سيتم وضع الملفات التي تم سحبها فيه.

المرتجعات
`boolean`	صحيح إذا كان ناجحًا، خطأ في الحالات الأخرى

fetchRemoteDir

public static File fetchRemoteDir (String host, 
                String user, 
                File sshPrivateKey, 
                IRunUtil runUtil, 
                long timeout, 
                String remoteDirPath)

استرداد دليل بعيد من المضيف البعيد

المعلَمات
`host`	‫`String`: المضيف البعيد
`user`	`String`: المستخدم على المضيف البعيد
`sshPrivateKey`	`File`: الملف الذي يحتوي على مفتاح SSH المطلوب استخدامه.
`runUtil`	`IRunUtil`: `IRunUtil` لتنفيذ الأوامر
`timeout`	‫`long`: بالمللي ثانية لإكمال عملية الجلب
`remoteDirPath`	`String`: المسار البعيد الذي يمكن العثور فيه على الدليل

المرتجعات
`File`	الدليل الذي تم سحبه `File` في حال نجاح العملية، أو قيمة فارغة في حال عدم نجاحها

fetchRemoteDir

public static File fetchRemoteDir (String host, 
                String user, 
                File sshPrivateKey, 
                List<String> scpArgs, 
                IRunUtil runUtil, 
                long timeout, 
                String remoteDirPath)

استرداد دليل بعيد من المضيف البعيد

المعلَمات
`host`	‫`String`: المضيف البعيد
`user`	`String`: المستخدم على المضيف البعيد
`sshPrivateKey`	`File`: الملف الذي يحتوي على مفتاح SSH المطلوب استخدامه.
`scpArgs`	‫`List`: وسيطات إضافية سيتم تمريرها إلى أمر scp
`runUtil`	`IRunUtil`: `IRunUtil` لتنفيذ الأوامر
`timeout`	‫`long`: بالمللي ثانية لإكمال عملية الجلب
`remoteDirPath`	`String`: المسار البعيد الذي يمكن العثور فيه على الدليل

المرتجعات
`File`	الدليل الذي تم سحبه `File` في حال نجاح العملية، أو قيمة فارغة في حال عدم نجاحها

fetchRemoteDir

public static boolean fetchRemoteDir (String host, 
                String user, 
                File sshPrivateKey, 
                List<String> scpArgs, 
                IRunUtil runUtil, 
                long timeout, 
                String remoteDirPath, 
                File localDir)

استرداد دليل بعيد من المضيف البعيد

المعلَمات
`host`	‫`String`: المضيف البعيد
`user`	`String`: المستخدم على المضيف البعيد
`sshPrivateKey`	`File`: الملف الذي يحتوي على مفتاح SSH المطلوب استخدامه.
`scpArgs`	‫`List`: وسيطات إضافية سيتم تمريرها إلى أمر scp
`runUtil`	`IRunUtil`: `IRunUtil` لتنفيذ الأوامر
`timeout`	‫`long`: بالمللي ثانية لإكمال عملية الجلب
`remoteDirPath`	`String`: المسار البعيد الذي يمكن العثور فيه على الدليل
`localDir`	`File`: الدليل المحلي الذي سيتم وضع الملفات التي تم سحبها فيه.

المرتجعات
`boolean`	صحيح إذا كان ناجحًا، خطأ في الحالات الأخرى

fetchRemoteFile

public static File fetchRemoteFile (String host, 
                String user, 
                File sshPrivateKey, 
                List<String> scpArgs, 
                IRunUtil runUtil, 
                long timeout, 
                String remoteFilePath)

استرجاع ملف بعيد في مثيل الحاوية

المعلَمات
`host`	‫`String`: المضيف البعيد
`user`	`String`: المستخدم على المضيف البعيد
`sshPrivateKey`	`File`: الملف الذي يحتوي على مفتاح SSH المطلوب استخدامه.
`scpArgs`	‫`List`: وسيطات إضافية سيتم تمريرها إلى أمر scp
`runUtil`	`IRunUtil`: `IRunUtil` لتنفيذ الأوامر
`timeout`	‫`long`: بالمللي ثانية لإكمال عملية الجلب
`remoteFilePath`	`String`: المسار البعيد الذي يمكن العثور فيه على الملف

المرتجعات
`File`	يتم عرض الملف الذي تم سحبه في حال نجاح العملية، أو قيمة فارغة في حال عدم نجاحها.

fetchRemoteFile

public static File fetchRemoteFile (String host, 
                String user, 
                File sshPrivateKey, 
                IRunUtil runUtil, 
                long timeout, 
                String remoteFilePath)

استرجاع ملف بعيد في مثيل الحاوية

المعلَمات
`host`	‫`String`: المضيف البعيد
`user`	`String`: المستخدم على المضيف البعيد
`sshPrivateKey`	`File`: الملف الذي يحتوي على مفتاح SSH المطلوب استخدامه.
`runUtil`	`IRunUtil`: `IRunUtil` لتنفيذ الأوامر
`timeout`	‫`long`: بالمللي ثانية لإكمال عملية الجلب
`remoteFilePath`	`String`: المسار البعيد الذي يمكن العثور فيه على الملف

المرتجعات
`File`	يتم عرض الملف الذي تم سحبه في حال نجاح العملية، أو قيمة فارغة في حال عدم نجاحها.

fetchRemoteFile

public static boolean fetchRemoteFile (String host, 
                String user, 
                File sshPrivateKey, 
                List<String> scpArgs, 
                IRunUtil runUtil, 
                long timeout, 
                String remoteFilePath, 
                File localFile)

استرداد ملف بعيد في الجهاز أو مثيل الحاوية

المعلَمات
`host`	‫`String`: المضيف البعيد
`user`	`String`: المستخدم على المضيف البعيد
`sshPrivateKey`	`File`: الملف الذي يحتوي على مفتاح SSH المطلوب استخدامه.
`scpArgs`	‫`List`: وسيطات إضافية سيتم تمريرها إلى أمر scp
`runUtil`	`IRunUtil`: `IRunUtil` لتنفيذ الأوامر
`timeout`	‫`long`: بالمللي ثانية لإكمال عملية الجلب
`remoteFilePath`	`String`: المسار البعيد الذي يمكن العثور فيه على الملف
`localFile`	`File`: `File` المحلي الذي سيتم سحب الملف البعيد منه

المرتجعات
`boolean`	صحيح إذا كان ناجحًا، خطأ في الحالات الأخرى

fetchRemoteFile

public static boolean fetchRemoteFile (String host, 
                String user, 
                File sshPrivateKey, 
                IRunUtil runUtil, 
                long timeout, 
                String remoteFilePath, 
                File localFile)

استرداد ملف بعيد في الجهاز أو مثيل الحاوية

المعلَمات
`host`	‫`String`: المضيف البعيد
`user`	`String`: المستخدم على المضيف البعيد
`sshPrivateKey`	`File`: الملف الذي يحتوي على مفتاح SSH المطلوب استخدامه.
`runUtil`	`IRunUtil`: `IRunUtil` لتنفيذ الأوامر
`timeout`	‫`long`: بالمللي ثانية لإكمال عملية الجلب
`remoteFilePath`	`String`: المسار البعيد الذي يمكن العثور فيه على الملف
`localFile`	`File`: `File` المحلي الذي سيتم سحب الملف البعيد منه

المرتجعات
`boolean`	صحيح إذا كان ناجحًا، خطأ في الحالات الأخرى

pushFileToRemote

public static boolean pushFileToRemote (String host, 
                String user, 
                File sshPrivateKey, 
                List<String> scpArgs, 
                IRunUtil runUtil, 
                long timeout, 
                String remoteFilePath, 
                File localFile)

إرسال File من المضيف المحلي إلى المثيل البعيد

المعلَمات
`host`	‫`String`: المضيف البعيد
`user`	`String`: المستخدم على المضيف البعيد
`sshPrivateKey`	`File`
`scpArgs`	‫`List`: وسيطات إضافية سيتم تمريرها إلى أمر scp
`runUtil`	`IRunUtil`: `IRunUtil` لتنفيذ الأوامر
`timeout`	‫`long`: بالمللي ثانية لإكمال عملية الجلب
`remoteFilePath`	`String`: المسار البعيد الذي يمكن العثور فيه على الملف
`localFile`	`File`: `File` المحلي الذي سيتم سحب الملف البعيد منه

المرتجعات
`boolean`	صحيح إذا كان ناجحًا، خطأ في الحالات الأخرى