از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
با TF شروع کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Trade Federation یک زیرساخت آزمایشی بزرگ است که می تواند با انواع مختلف موارد استفاده مختلف سازگار شود و اکثر مردم احتمالاً فقط به زیر مجموعه ای از عملکرد آن نیاز دارند. اول از همه، ما تصور می کنیم که کاربران TF هر یک از سه نقش اصلی را ایفا کنند: توسعه دهنده، یکپارچه ساز، و دونده تست. یک فرد خاص ممکن است هر یک از این سه کلاه (یا همه) را بر سر بگذارد، اما ما احساس می‌کنیم که این تمایز به آسان‌تر کردن اسناد کمک می‌کند.
توسعه دهندگان
توسعه دهندگان بیشتر وقت خود را صرف ایجاد ماژول های TF می کنند که به زبان جاوا نوشته شده اند. آنها ممکن است پیکربندی ها را بنویسند و آزمایش هایی را اجرا کنند، اما معمولاً این کار را فقط برای تأیید اینکه ماژول های آنها به درستی فراخوانی می شوند و مطابق انتظار عمل می کنند انجام می دهند.
ادغام کننده ها
ادغام کننده ها بیشتر وقت خود را صرف ایجاد پیکربندی های تست XML یا فایل های دستوری (که به زبانی ساده مانند پوسته نوشته شده اند) می کنند. آنها ماژول های TF نوشته شده توسط Developer را با پیکربندی های خاصی که برای الزامات و اهداف آزمایشی خاص مورد نیاز هستند، به هم متصل می کنند.
دوندگان تست
دوندگان تست اکثر وقت خود را صرف اجرای تست ها می کنند و به طور کلی اطمینان حاصل می کنند که نتایج تست در حال تولید است و نتایج تست تولید شده مرتبط، قابل تکرار و دقیق هستند. آنها بیشتر وقت خود را صرف تعامل با رابط خط فرمان tradefed می کنند و همچنین بررسی خواهند کرد که نتایج منطقی هستند.
برای اینکه بیشترین بهره را از فدراسیون تجارت ببرید، هر سه نقش باید نشان داده شوند. توسعه‌دهندگان و یکپارچه‌سازان نیاز دارند تا TF را با سایر بخش‌های زیرساخت، مانند ساخت سیستم‌ها و مخازن نتایج آزمایش، تعامل کنند. یکپارچه‌سازها و دونده‌های تست نیاز به دریافت TF دارند تا در واقع آزمایش‌های مورد نظر را اجرا کنند و نتایج آزمون مورد نظر را تولید کنند. برای شناسایی نتایج غیر منطقی و همکاری با توسعه دهندگان و ادغام کنندگان برای کشف این که اشکالات ممکن است در کجا قرار داشته باشند و آنها را برطرف کنند، دونده تست نیاز دارد.
بعدش چی
افراد در هر سه نقش باید حداقل نگاهی به بقیه اسناد بیندازند. Machine Setup شما را به نقطه ای می رساند که می توانید TF را اجرا کنید (با ساختن یا دانلود آن). کار با دستگاه‌ها نحوه اجرای آزمایش‌ها را با یک دستگاه فیزیکی، با شبیه‌ساز یا اصلاً بدون دستگاه توضیح می‌دهد. صفحه چرخه عمر تست از دیدگاه نظری توضیح می‌دهد که چگونه نقش‌های توسعه‌دهنده، ادغام‌کننده، و دونده تست با هم تعامل دارند، و سپس Option Handling نحوه عملی کردن این نظریه را نشان می‌دهد.
در نهایت، مثال End-to-End شما را از طریق توسعه، ادغام و استقرار یک آزمایش نمونه راهنمایی می کند. این شامل جنبه‌هایی از هر نقش است و باید نکاتی را در مورد چگونگی انجام کارهای پیچیده‌تر که مستقیماً در مستندات مورد بحث قرار نمی‌گیرند، ارائه دهد.
اگر در اینجا همه چیز را پشت سر گذاشته اید و هنوز سؤالات بی پاسخی دارید، ابتدا سعی کنید به کد منبع فدراسیون تجارت نگاهی بیندازید. فراتر از آن، با خیال راحت در Google Group پلتفرم اندروید بپرسید. برای بهترین نتایج، مطمئن شوید که "فدراسیون تجارت" (یا "تجارت شده"، یا "TF") را در موضوع پیام ذکر کنید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و 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,["# Get started with TF\n\nTrade Federation is a large test infrastructure that can be adapted to a great variety of\ndifferent usecases, and most people will probably only need some subset of its functionality. First\noff, we envision that TF users will fulfill any of three primary roles: Developer, Integrator, and\nTest Runner. A particular individual might wear any (or all) of those three hats, but we feel the\ndistinction will help make it easier to navigate the documentation.\n\nDevelopers\n----------\n\nDevelopers spend the majority of their time creating TF modules that are written in Java.\nThey may write configurations and execute tests, but will typically only do so to verify that their\nmodules are being invoked properly and are functioning as expected.\n\nIntegrators\n-----------\n\nIntegrators spend the majority of their time creating XML test configurations, or command\nfiles (which are written in a simple shell-like language). They tie together TF modules written\nby the Developer with specific configurations that are required for particular test requirements and\ngoals.\n\nTest Runners\n------------\n\nTest Runners spend the majority of their time executing tests and generally making sure\nthat test results are being generated, and that the generated test results are relevant,\nreproducible, and accurate. They spend the majority of their time interacting with tradefed's\ncommand line interface, and will also verify that the results make sense.\n\nIn order to get the most out of Trade Federation, all three roles will need to be represented.\nIt will take Developers and Integrators to make TF interoperate with other pieces of infrastructure,\nlike build systems and test result repositories. It will take Integrators and Test Runners to get\nTF to actually run the desired tests and produce the desired test results. It will take Test\nRunners to identify results that don't make sense, and to work with the Developers and\nIntegrators to figure out where the bugs may lie and get them fixed.\n\nWhat's next\n-----------\n\nPeople in all three roles should at least glance through all the rest of the docs.\n[Machine Setup](/docs/core/tests/tradefed/fundamentals/machine_setup) will get you to the point where you can run TF (by building or downloading it).\n[Working with Devices](/docs/core/tests/tradefed/fundamentals/devices) will explain how to run tests with a physical device, with an emulator, or\nwith no device at all. The\n[Test Lifecycle](/docs/core/tests/tradefed/fundamentals/lifecycle) page will explain from a theoretical perspective how the roles of the\nDeveloper, Integrator, and Test Runner interact, and then\n[Option Handling](/docs/core/tests/tradefed/fundamentals/options) will demonstrate how to put that theory into practice.\n\nFinally, the [End-to-End Example](/docs/core/tests/tradefed/fundamentals/full_example) takes you through the development, integration, and deployment of a sample\ntest. It involves aspects of each role, and should offer hints at how to do more complicated\nthings that aren't directly discussed in the documentation.\n\nIf you've gotten through everything here and still have unanswered questions, first try taking\na look at the [Trade Federation source code](https://android.googlesource.com/platform/tools/tradefederation/+/main). Beyond that, feel free to try asking on the\n[android-platform](/docs/setup/community) Google Group. For best results, make\nsure to mention \"Trade Federation\" (or \"tradefed\", or \"TF\") in the message subject."]]
