2025 年 3 月 27 日より、AOSP のビルドとコントリビューションには aosp-main
ではなく android-latest-release
を使用することをおすすめします。詳細については、AOSP の変更をご覧ください。
TF を使ってみる
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Trade Federation はさまざまなユースケースに対応できる大規模なテスト インフラストラクチャであり、たいていの場合に必要となるのは、その機能の一部にすぎません。まず、TF ユーザーは、開発者、インテグレータ、テスト担当者という 3 つの主要な役割のいずれかを担うことが想定されています。特定の個人がこれら 3 つの役割のいずれか(またはすべて)を担うこともありますが、区別することで以降の説明が簡単になります。
開発者
開発者は、Java で記述された TF モジュールの作成に多くの時間を費やします。
構成を作成してテストを実行することもありますが、これは通常、モジュールが適切に呼び出され、期待どおりに機能していることを確認するためにのみ行います。
インテグレータ
インテグレータは、XML テスト構成またはコマンド ファイル(単純なシェルのような言語で記述)の作成に多くの時間を費やします。開発者が作成した TF モジュールを、特定のテスト要件と目標に必要な特定の構成と結び付けます。
テスト担当者
テスト担当者は、テストの実行に多くの時間を費やします。通常は、テスト結果が生成されていること、また生成されたテスト結果の関連性、再現性、正確さについて確認します。Tradefed のコマンドライン インターフェースの操作に多くの時間を費やし、結果が合理的であることも確認します。
Trade Federation を最大限に活用するには、3 つの役割がすべて揃っている必要があります。
開発者とインテグレータは、TF をビルドシステムやテスト結果リポジトリのような他のインフラストラクチャと相互運用します。インテグレータとテスト担当者は、TF で必要なテストを実際に実行し、必要なテスト結果を生成します。テスト担当者は、不合理な結果を特定し、開発者やインテグレータと連携してバグのある場所を見つけ、修正します。
次のステップ
3 つの役割に携わる方には、残りすべてのドキュメントに少なくとも目を通していただく必要があります。
マシンのセットアップでは、TF を(作成またはダウンロードすることで)実行できるようになります。
デバイスの操作では、物理デバイスを使用して、エミュレータを使用して、またはデバイスをまったく使用せずに、テストを実行する方法について説明します。テストのライフサイクルのページでは、開発者、インテグレータ、テスト担当者の役割がどのように連携するかについて理論的な観点から説明し、オプションの処理で具体的に実践する方法を示します。
最後に、エンドツーエンドの例で、サンプルテストの開発、統合、デプロイについて説明します。ここでは各役割の作業について取り上げ、ドキュメントでは直接カバーしていない複雑な作業を行う際のヒントを記載しています。
これらのガイドをお読みいただき、ご不明な点がありましたら、まずは Trade Federation のソースコードを参照してください。そのうえで、Android プラットフォームの Google グループにご自由に質問をお寄せください。メッセージの件名に「Trade Federation」(「tradefed」、または「TF」)と記載すると、的確な返答をもらいやすくなります。
このページのコンテンツやコードサンプルは、コンテンツ ライセンスに記載のライセンスに従います。Java および OpenJDK は Oracle および関連会社の商標または登録商標です。
最終更新日 2025-07-27 UTC。
[[["わかりやすい","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-27 UTC。"],[],[],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."]]