उन्नत ACTS मार्गदर्शिका

यह एंड्रॉइड कॉम्स टेस्ट सूट (ACTS) परीक्षण चलाने के तरीके पर एक मार्गदर्शिका है।

कोड मिल रहा है

ACTS का सबसे अद्यतित संस्करण एंड्रॉइड ओपन सोर्स प्रोजेक्ट (AOSP) गेरिट रिपॉजिटरी में /platform/tools/test/connectivity/ में पाया जा सकता है।

कोड को सिंक करने के तरीके के विवरण के लिए, स्रोत और एंड्रॉइड डेवलपर कोडेलैब डाउनलोड करना देखें। कोड को सिंक करते समय, मुख्य शाखा को सिंक करें। टैग किए गए बिल्ड को सिंक न करें.

ध्यान दें कि 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

अधिनियम स्थापित करना

<repo>/tools/test/connectivity/acts/framework में पाई गई setup.py स्क्रिप्ट शेष निर्भरताएँ और 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 उपयोग कर सकते हैं, और Python में ACTS मॉड्यूल आयात कर सकते हैं। उदाहरण के लिए:

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 चला सकते हैं। एकमात्र चरण जिसे पूरा किया जाना चाहिए वह <repo>/tools/test/connectivity/acts/framework से आयात करने के लिए पायथन पथ को संशोधित करना है। ACTS चलाने से पहले, ACTS स्थापित किए बिना ACTS द्वारा सभी आवश्यक निर्भरताएँ स्थापित करने के लिए setup.py install_deps चलाएँ। यदि 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 को वर्चुअल वातावरण में इंस्टॉल करना चाहिए। निम्नलिखित चरण मानते हैं कि आपके पास ci.android.com पर aosp-main से acts_test.zip है या स्रोत तक सीधी पहुंच है।

1. अधिनियम प्राप्त करें.

   बिल्ड प्रकाशित हो चुकी है।. अधिक जानकारी के लिए, Android सतत एकीकरण देखें। आप ci.android.com पर किसी बिल्ड से ज़िप फ़ाइलें खींच सकते हैं। test_suites_x86_64 लक्ष्य खोजें.

   acts_test.zip फ़ाइल कलाकृतियों टैब के अंतर्गत है। इस उदाहरण के लिए, मान लें कि 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. अधिनियम स्थापित करें. निम्न आदेश चलाएँ.

   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 बिल्ड के साथ फ्लैश करें।

डिवाइस को फ्लैश करने के लिए, एंड्रॉइड फ्लैश टूल (flash.android.com/) का उपयोग करें। अधिक विवरण के लिए, एंड्रॉइड फ़्लैश टूल पर दस्तावेज़ देखें।

SL4A स्थापित करना (वैकल्पिक, अनुशंसित)

यदि आप userdebug बिल्ड वाले डिवाइस का उपयोग कर रहे हैं, तो आपके पास SL4A का उपयोग करके अपने डिवाइस का सिस्टम विशेषाधिकार नियंत्रण प्राप्त करने का विकल्प है। यदि आपका परीक्षण डिवाइस पर SL4A का उपयोग नहीं करता है, तो आप सुविधा को अक्षम करने के लिए ACTS कॉन्फ़िगरेशन में skip_sl4a ध्वज सेट कर सकते हैं।

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

SL4A APK प्राप्त करने के लिए, Android के लिए स्क्रिप्टिंग लेयर पर दिए गए निर्देशों का पालन करें।