Gelişmiş ACTS kılavuzu

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.

  1. 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.

  2. virtualenv makinenize yükleyin.

    Henüz sahip değilseniz, virtualenv kullanarak yükleyebilirsiniz:

    python3 -m pip install -U --user virtualenv

  3. Sanal ortamı oluşturun ve etkinleştirin (bu örnek için /tmp/my_virtualenv konumunda). Bu, yeni paketlerin virtualenv dizinine kurulmasını sağlar.

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

  4. 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

  5. ACTS'yi her yerden çalıştırın.

    act.py -c <config> ...

  6. 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.