תבניות וקבצים נכללים בהגדרת ה-XML של Tradefed

לא תמיד מעשי ליצור הגדרת XML אחת מונוליתית כדי להגדיר בדיקה. אם רוצים לעשות שימוש חוזר בחלק מההגדרה כדי להריץ בדיקות דומות, צריך להעתיק ולתחזק שני קובצי XML ענקיים.

כאן נכנסים לתמונה התגים template ו-include בהגדרת התצורה של Tradefed XML. הם מאפשרים להגדיר placeholders בהגדרות XML מסוימות כדי להוסיף חלק מהגדרות XML אחרות.

דוגמה להגדרה של תבניות

<configuration description="Common base configuration for local runs with minimum overhead">
    <build_provider class="com.android.tradefed.build.BootstrapBuildProvider" />

    <template-include name="preparers" default="empty" />

    <template-include name="test" default="empty" />

    <template-include name="reporters" default="empty" />
</configuration>

תבניות הן placeholder עם name כדי להפנות אליהן, ושדה default אופציונלי. השדה default מגדיר את קובץ ה-XML החלופי שמוגדר כברירת מחדל.

כדי להחליף תבנית בתצורה מסוימת, צריך להוסיף את הפרמטר הבא של הפקודה לשורת הפקודה:

--template:map <name of template>=<replacement XML config path>

--template:map preparers=empty

לדוגמה:

<template-include name="preparers" default="empty" />

ההפניה empty במקרה הזה מתייחסת להגדרה של empty.xml שאינה מכילה דבר. אנחנו משתמשים בה כהפניה להחלפה בדבר כלשהו.

הנתיב של הגדרות ה-XML יכול להיות מוחלט או יחסי לתיקייה res/config בתוך משאבי ה-JAR של Tradefed. ריכזנו כאן כמה מהמיקומים שלהם:

  • tools/tradefederation/core/res/config
  • tools/tradefederation/core/tests/res/config
  • tools/tradedeferation/contrib/res/config

הגדרה לדוגמה של 'כולל'

<configuration description="Common base configuration for local runs with minimum overhead">
    <build_provider class="com.android.tradefed.build.BootstrapBuildProvider" />

    <include name="empty"/>
</configuration>

קבצים מצורפים פשוטים יותר מתבניות כי הם לא דורשים ארגומנטים של שורת הפקודה. הם מרחיבים ישירות את קובץ ה-XML שמצוין בתג name. בדומה לתבניות, הנתיב להגדרה יכול להיות מוחלט או יחסי. עם זאת, ב-includes מומלץ להשתמש רק בנתיב יחסי, כי הוא קל יותר להעברה ב-Tradefed. אם מעבירים את Tradefed למכונה אחרת, הנתיבים המוחלטים לא יהיו תקפים.

הגדרה שגויה

במקרה של הגדרה שגויה, למשל אם לא ניתן למצוא את קובץ ה-XML החלופי, Tradefed יגרום להצגת הודעת השגיאה ConfigurationException עם תיאור של מה שנראה חסר או שהוגדר בצורה שגויה.