מדריך ACTS מתקדם

זהו מדריך כיצד להפעיל מבחני Android Comms Test Suite (ACTS) .

מקבל את הקוד

את הגרסה העדכנית ביותר של ACTS ניתן למצוא במאגר Gerrit של Android Open Source Project (AOSP) ב- /platform/tools/test/connectivity/ .

לפרטים על אופן סנכרון הקוד, ראה הורדת המקור ו- Android Developer Codelab . בעת סנכרון הקוד, סנכרן את הסניף הראשי. אל תסנכרן מבנה מתויג.

שימו לב שכאשר הורדת ACTS, אינכם צריכים לסנכרן את כל מאגר האנדרואיד. כדי לסנכרן רק ACTS, לאחר הפעלת הפקודה repo init , הפעל:

repo sync platform/tools/test/connectivity

ניתן למצוא ACTS תחת <repo>/tools/test/connectivity/acts/ .

הגדרת סביבה

כדי לוודא של-ACTS יש את התלות הנדרשת להגדרה, התקן את כלי ההתקנה הבאים של Python 3:

sudo apt-get install python3-setuptools
sudo apt-get install python3-pip
sudo apt-get install adb fastboot
sudo pip3 install --upgrade pip setuptools
# Needed due to an on-going bug.
sudo apt-get install protobuf-compiler

התקנת ACTS

הסקריפט setup.py שנמצא ב- <repo>/tools/test/connectivity/acts/framework מתקין את שאר התלות ואת ACTS עצמו.

לפיתוח מתמשך ב-ACTS או עם ACTS, הפעל את הפקודה הבאה:

cd <repo>/tools/test/connectivity/acts/framework/
sudo python3 setup.py develop
cd -

אם אתה רוצה להריץ רק בדיקות, הפעל את הפקודה הזו במקום זאת:

cd <repo>/tools/test/connectivity/acts/framework/
sudo python3 setup.py install
cd -

הערה: מומלץ להשתמש בהגדרת סביבה וירטואלית .

מוודא התקנה

לאחר ההגדרה, ודא שאתה יכול להשתמש act.py בטרמינל שלך, ולייבא מודולי ACTS ב-Python. לדוגמה:

act.py -h
usage: act.py [-h] -c <PATH> [--test_args Arg1 Arg2 ... ]
python3
>>> from acts.controllers import android_device
>>> device_list = android_device.get_all_instances()

פועל ללא התקנה

משתמשים יכולים להריץ ACTS מבלי להתקין את החבילה ישירות. השלב היחיד שיש לבצע הוא שינוי הנתיב של Python לייבוא ​​מ- <repo>/tools/test/connectivity/acts/framework . לפני הפעלת ACTS, הפעל את setup.py install_deps כדי להתקין את כל התלות הנדרשת על ידי ACTS מבלי להתקין ACTS. אם גרסה קיימת של ACTS נמצאת במחשב שלך, הפעל את sudo setup.py uninstall .

כדי להפעיל ACTS, השתמש באחת מהפקודות הבאות:

• cd <repo>/tools/test/connectivity/acts/framework; acts/bin/act.py
  

• export PYTHONPATH=<repo>/tools/test/connectivity/acts/framework; acts/bin/act.py
  

ACTS מוציא הודעות המבקשות דגלי -c ו- -tc . למידע נוסף, ראה הגדרת בדיקות ACTS .

הקמת ACTS בסביבה וירטואלית

כדי לבודד את ההתקנה שלך מהתקנות אחרות של ACTS, עליך להתקין את ACTS בסביבה וירטואלית. השלבים הבאים מניחים שיש לך acts_test.zip מ- aosp-main ב- ci.android.com או שיש לך גישה ישירה למקור.

1. קבל ACTS.

   מבנים מתפרסמים. למידע נוסף, ראה אינטגרציה מתמשכת של Android . אתה יכול למשוך קבצי zip מ-build ב- ci.android.com . חפש את היעד test_suites_x86_64 .

   הקובץ acts_test.zip נמצא בכרטיסייה Artifacts. עבור דוגמה זו, נניח acts_test.zip הורד אל /tmp/acts_test.zip .

   אם יש לך גישה לקוד המקור, תוכל להשתמש בו במקום זאת.

2. התקן virtualenv במחשב שלך.

   אם עדיין אין לך את זה, אתה יכול להתקין virtualenv באמצעות:

   python3 -m pip install -U --user virtualenv
   

3. צור והפעל את הסביבה הוירטואלית (ב- /tmp/my_virtualenv עבור דוגמה זו). זה מבטיח כי חבילות חדשות מותקנות בספריית virtualenv .

   python3 -m virtualenv /tmp/my_virtualenv
   source /tmp/my_virtualenv/bin/activate
   

4. התקן את ACTS. הפעל את הפקודה הבאה.

   unzip /tmp/acts_test.zip -d /tmp/my_virtualenv/acts
   cd /tmp/my_virtualenv/acts/tools/test/connectivity/acts/framework/
   python3 setup.py install
   

   אם יש לך גישה ישירות לקוד, תוכל לדלג על הפתיחה:

   cd /path/to/acts/framework
   python3 setup.py install
   

5. הפעל את ACTS מכל מקום.

   act.py -c <config> ...
   

6. עזוב את הסביבה הוירטואלית כשתסיים להריץ בדיקות.

   deactivate
   

מהבהב מכשיר האנדרואיד (אופציונלי)

אם ברצונך לקבל שליטה מורשות מערכת במכשיר, הבזק את המכשיר עם מבנה userdebug .

כדי להבהב את המכשיר, השתמש ב- Android Flash Tool (flash.android.com/) . לפרטים נוספים, עיין בתיעוד ב- Android Flash Tool .

התקנת SL4A (אופציונלי, מומלץ)

אם אתה משתמש במכשיר עם מבנה userdebug , יש לך אפשרות לקבל שליטה על הרשאות מערכת במכשיר שלך באמצעות SL4A. אם הבדיקה שלך לא משתמשת ב-SL4A במכשיר, אתה יכול להגדיר את הדגל skip_sl4a בתצורת ACTS כדי להשבית את התכונה.

"AndroidDevice": [{"serial": "standardized serial number reference", "skip_sl4a": true}, ...]

כדי לקבל את ה-APK של SL4A, עקוב אחר ההוראות ב- Scripting Layer for Android .