উন্নত ACTS গাইড

এটি কিভাবে Android Comms Test Suite (ACTS) পরীক্ষা চালাতে হয় তার একটি নির্দেশিকা।

কোড পাচ্ছেন

ACTS-এর সবচেয়ে আপ-টু-ডেট সংস্করণটি /platform/tools/test/connectivity/ এ Android ওপেন সোর্স প্রজেক্ট (AOSP) Gerrit সংগ্রহস্থলে পাওয়া যাবে।

কোডটি কিভাবে সিঙ্ক করতে হয় তার বিস্তারিত জানার জন্য, সোর্স ডাউনলোড করা এবং অ্যান্ড্রয়েড ডেভেলপার কোডল্যাব দেখুন। কোড সিঙ্ক করার সময়, প্রধান শাখা সিঙ্ক করুন। একটি ট্যাগ করা বিল্ড সিঙ্ক করবেন না।

মনে রাখবেন যে 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 ইনস্টল করা হচ্ছে

<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 ব্যবহার করতে পারেন এবং পাইথনে 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. ACTS পান।

   বিল্ডগুলি প্রকাশিত হয়। আরও তথ্যের জন্য, দেখুন 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. 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 বিল্ড দিয়ে ডিভাইসটিকে ফ্ল্যাশ করুন।

ডিভাইসটি ফ্ল্যাশ করতে, অ্যান্ড্রয়েড ফ্ল্যাশ টুল (flash.android.com/) ব্যবহার করুন। আরো বিস্তারিত জানার জন্য, Android Flash Tool- এ ডকুমেন্টেশন দেখুন।

SL4A ইনস্টল করা হচ্ছে (ঐচ্ছিক, প্রস্তাবিত)

আপনি যদি userdebug বিল্ড সহ একটি ডিভাইস ব্যবহার করেন তবে আপনার কাছে SL4A ব্যবহার করে আপনার ডিভাইসের সিস্টেম বিশেষাধিকার নিয়ন্ত্রণ পাওয়ার বিকল্প রয়েছে। যদি আপনার পরীক্ষা ডিভাইসে SL4A ব্যবহার না করে, তাহলে আপনি বৈশিষ্ট্যটি নিষ্ক্রিয় করতে ACTS কনফিগারেশনে skip_sl4a পতাকা সেট করতে পারেন।

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

SL4A APK পেতে, Android এর জন্য স্ক্রিপ্টিং লেয়ারের নির্দেশাবলী অনুসরণ করুন।