Bu, Android İletişim Test Paketi (ACTS) testlerinin nasıl çalıştırılacağına ilişkin bir kılavuzdur.
Kodu alma
ACTS'nin en güncel sürümü /platform/tools/test/connectivity/
adresindeki Android Açık Kaynak Projesi (AOSP) Gerrit deposunda bulunabilir.
Kodun nasıl senkronize edileceğine ilişkin ayrıntılar için Kaynağı İndirme ve Android Geliştirici Codelab'ine bakın. Kodu senkronize ederken ana dalı senkronize edin. Etiketli bir yapıyı senkronize etmeyin.
ACTS'yi indirirken tüm Android deposunu senkronize etmeniz gerekmediğini unutmayın. Yalnızca ACTS'yi senkronize etmek için repo init
komutunu çalıştırdıktan sonra şunu çalıştırın:
repo sync platform/tools/test/connectivity
ACTS <repo>/tools/test/connectivity/acts/
altında bulunabilir.
Ortam kurulumu
ACTS'nin kurulum için gerekli bağımlılıklara sahip olduğundan emin olmak için aşağıdaki Python 3 kurulum araçlarını yükleyin:
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'yi yükleme
<repo>/tools/test/connectivity/acts/framework
içinde bulunan setup.py
betiği, bağımlılıkların geri kalanını ve ACTS'nin kendisini yükler.
ACTS üzerinde veya ACTS ile sürekli geliştirme için aşağıdaki komutu çalıştırın:
cd <repo>/tools/test/connectivity/acts/framework/
sudo python3 setup.py develop
cd -
Yalnızca testleri çalıştırmak istiyorsanız bunun yerine şu komutu çalıştırın:
cd <repo>/tools/test/connectivity/acts/framework/
sudo python3 setup.py install
cd -
Yüklemeyi Doğrulama
Kurulumdan sonra, terminalinizde act.py
kullanabileceğinizden ve ACTS modüllerini Python'a aktarabildiğinizden emin olun. Örneğin:
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()
Kurulum yapmadan çalıştırma
Kullanıcılar paketi doğrudan yüklemeden ACTS'yi çalıştırabilir. Gerçekleştirilmesi gereken tek adım <repo>/tools/test/connectivity/acts/framework
adresinden içe aktarmak için Python yolunu değiştirmektir. ACTS'yi çalıştırmadan önce, ACTS'yi kurmadan gerekli tüm bağımlılıkları ACTS'ye yüklemek için setup.py install_deps
çalıştırın. Makinenizde ACTS'nin mevcut bir sürümü varsa sudo setup.py uninstall
çalıştırın.
ACTS'yi çalıştırmak için aşağıdaki komutlardan birini kullanın:
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
ve -tc
işaretlerini isteyen mesajların çıktısını verir. Daha fazla bilgi için bkz. ACTS Testlerini Yapılandırma .
ACTS'yi sanal ortamda kurma
Kurulumunuzu diğer ACTS kurulumlarından yalıtmak için ACTS'yi sanal bir ortama kurmanız gerekir. Aşağıdaki adımlarda ci.android.com'da aosp-main
acts_test.zip
sahip olduğunuz veya kaynağa doğrudan erişiminiz olduğu varsayılmaktadır.
ACTS'yi edinin.
Yapılar yayınlanıyor. Daha fazla bilgi için bkz. Android Sürekli Entegrasyonu . Zip dosyalarını ci.android.com adresindeki bir yapıdan alabilirsiniz.
test_suites_x86_64
hedefini arayın.acts_test.zip
dosyası Yapılar sekmesinin altındadır. Bu örnek için,acts_test.zip
/tmp/acts_test.zip
dosyasına indirildiğini varsayalım.Kaynak koduna erişiminiz varsa bunun yerine onu kullanabilirsiniz.
virtualenv
makinenize yükleyin.Henüz sahip değilseniz,
virtualenv
kullanarak yükleyebilirsiniz:python3 -m pip install -U --user virtualenv
Sanal ortamı oluşturun ve etkinleştirin (bu örnek için
/tmp/my_virtualenv
konumunda). Bu, yeni paketlerinvirtualenv
dizinine kurulmasını sağlar.python3 -m virtualenv /tmp/my_virtualenv
source /tmp/my_virtualenv/bin/activate
ACTS'yi yükleyin. Aşağıdaki komutu çalıştırın.
unzip /tmp/acts_test.zip -d /tmp/my_virtualenv/acts
cd /tmp/my_virtualenv/acts/tools/test/connectivity/acts/framework/
python3 setup.py install
Koda doğrudan erişiminiz varsa sıkıştırmayı açma işlemini atlayabilirsiniz:
cd /path/to/acts/framework
python3 setup.py install
ACTS'yi her yerden çalıştırın.
act.py -c <config> ...
Testleri çalıştırmayı tamamladığınızda sanal ortamdan ayrılın.
deactivate
Android cihazının yanıp sönmesi (isteğe bağlı)
Cihazın sistem ayrıcalıklı kontrolüne sahip olmak istiyorsanız, cihazı bir userdebug
yapısıyla flaşlayın.
Cihazı flaşlamak için Android Flash Aracını (flash.android.com/) kullanın. Daha fazla ayrıntı için Android Flash Aracı'ndaki belgelere bakın.
SL4A'yı yükleme (isteğe bağlı, önerilir)
userdebug
yapısına sahip bir cihaz kullanıyorsanız SL4A'yı kullanarak cihazınızın sistem ayrıcalığı kontrolünü alma seçeneğiniz vardır. Testiniz cihazda SL4A kullanmıyorsa özelliği devre dışı bırakmak için ACTS yapılandırmasında skip_sl4a
bayrağını ayarlayabilirsiniz.
"AndroidDevice": [{"serial": "standardized serial number reference", "skip_sl4a": true}, ...]
SL4A APK'sını edinmek için Android için Komut Dosyası Katmanı'ndaki talimatları izleyin.