นี่คือคำแนะนำเกี่ยวกับวิธีการเรียกใช้การทดสอบ Android Comms Test Suite (ACTS)
รับรหัส
ACTS เวอร์ชันล่าสุดสามารถพบได้ในที่เก็บ Android Open Source Project (AOSP) Gerrit ใน /platform/tools/test/connectivity/
สำหรับรายละเอียดเกี่ยวกับวิธีซิงค์โค้ด โปรดดู การดาวน์โหลดซอร์ส และ Codelab สำหรับนักพัฒนาซอฟต์แวร์ Android เมื่อซิงค์โค้ด ให้ซิงค์สาขาหลัก อย่าซิงค์บิลด์ที่ติดแท็ก
โปรดทราบว่าเมื่อดาวน์โหลด ACTS คุณไม่จำเป็นต้องซิงค์พื้นที่เก็บข้อมูล Android ทั้งหมด หากต้องการซิงค์เฉพาะ 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 ให้รันคำสั่งต่อไปนี้:
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 หรือมีสิทธิ์เข้าถึงแหล่งที่มาโดยตรง
รับการกระทำ
มีการเผยแพร่งานสร้างแล้ว สำหรับข้อมูลเพิ่มเติม โปรดดูที่ การผสานรวมอย่างต่อเนื่องของ Android คุณสามารถดึงไฟล์ zip จากบิลด์บน ci.android.com มองหาเป้าหมาย
test_suites_x86_64
ไฟล์
acts_test.zip
อยู่ใต้แท็บ Artifacts สำหรับตัวอย่างนี้ สมมติว่าacts_test.zip
ถูกดาวน์โหลดไปที่/tmp/acts_test.zip
หากคุณมีสิทธิ์เข้าถึงซอร์สโค้ด คุณสามารถใช้สิ่งนั้นแทนได้
ติดตั้ง
virtualenv
บนเครื่องของคุณหากคุณยังไม่มี คุณสามารถติดตั้ง
virtualenv
โดยใช้:python3 -m pip install -U --user virtualenv
สร้างและเปิดใช้งานสภาพแวดล้อมเสมือน (ใน
/tmp/my_virtualenv
สำหรับตัวอย่างนี้) เพื่อให้แน่ใจว่ามีการติดตั้งแพ็คเกจใหม่ในไดเร็กทอรีvirtualenv
python3 -m virtualenv /tmp/my_virtualenv
source /tmp/my_virtualenv/bin/activate
ติดตั้ง 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
เรียกใช้ ACTS ได้จากทุกที่
act.py -c <config> ...
ออกจากสภาพแวดล้อมเสมือนเมื่อรันการทดสอบเสร็จแล้ว
deactivate
การกระพริบอุปกรณ์ Android (อุปกรณ์เสริม)
หากคุณต้องการได้รับการควบคุมอุปกรณ์โดยใช้ระบบสิทธิพิเศษ ให้แฟลชอุปกรณ์ด้วยบิลด์ userdebug
หากต้องการแฟลชอุปกรณ์ ให้ใช้ เครื่องมือ Android Flash (flash.android.com/) สำหรับรายละเอียดเพิ่มเติม โปรดดูเอกสารประกอบที่ Android Flash Tool
การติดตั้ง SL4A (เป็นทางเลือก แนะนำ)
หากคุณใช้อุปกรณ์ที่มีบิลด์ userdebug
คุณจะมีตัวเลือกในการรับการควบคุมสิทธิ์ของระบบอุปกรณ์ของคุณโดยใช้ SL4A หากการทดสอบของคุณไม่ได้ใช้ SL4A บนอุปกรณ์ คุณสามารถตั้งค่าสถานะ skip_sl4a
ในการกำหนดค่า ACTS เพื่อปิดใช้งานคุณสมบัตินี้ได้
"AndroidDevice": [{"serial": "standardized serial number reference", "skip_sl4a": true}, ...]
หากต้องการรับ SL4A APK ให้ทำตามคำแนะนำที่ Scripting Layer สำหรับ Android