İleri düzey ACTS kılavuzu

Bu, Android Comms Test Suite (ACTS) testlerinin nasıl çalıştırılacağıyla ilgili bir kılavuzdur.

Kodu alın

ACTS'nin en güncel sürümünü /platform/tools/test/connectivity/ bölgesindeki Android Açık Kaynak Projesi (AOSP) Gerrit deposunda bulabilirsiniz.

Kodun nasıl senkronize edileceğiyle ilgili ayrıntılar için Kaynağı indirme ve Android Developer Codelab konularına bakın. Kodu senkronize ederken ana dalı senkronize edin. Etiketli bir derlemeyi senkronize etmeyin.

ACTS'yi indirirken Android deposunun tamamını senkronize etmeniz gerekmediğini unutmayın. Yalnızca ACTS'leri senkronize etmek için repo init komutunu çalıştırdıktan sonra şu komutu ç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ükle

<repo>/tools/test/connectivity/acts/framework içinde bulunan setup.py komut dosyası, diğer bağımlılıkları ve ACTS'yi 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 kullanabildiğinizden emin olun ve ACTS modüllerini Python'a aktarın. Örnek:

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()

Yüklemeden çalıştır

Kullanıcılar, paketi doğrudan yüklemeden ACTS'yi çalıştırabilir. Uygulanması gereken tek adım, <repo>/tools/test/connectivity/acts/framework kaynağından içe aktarma işleminin yapılacağı Python yolunu değiştirmektir. ACTS'yi çalıştırmadan önce, ACTS'yi yüklemeden önce ACTS tarafından gereken tüm bağımlılıkları yüklemek için setup.py install_deps komutunu çalıştırın. Makinenizde ACTS'nin mevcut bir sürümü varsa sudo setup.py uninstall komutunu ç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şaretleri isteğinde bulunan mesajların çıkışını verir. Daha fazla bilgi için ACTS testlerini yapılandırma bölümüne bakın.

ACTS'yi sanal ortamda kurun

Yüklemenizi diğer ACTS kurulumlarından ayırmak için ACTS'yi sanal bir ortama yüklemeniz gerekir. Aşağıdaki adımlarda ci.android.com'da aosp-main sağlayıcısından acts_test.zip sahibi olduğunuz veya kaynağa doğrudan erişiminizin olduğu varsayılır.

  1. ACTS'yi indir.

    Derlemeler yayınlanır. Daha fazla bilgi için Android Sürekli Entegrasyonu bölümüne bakın. ci.android.com adresindeki bir derlemeden ZIP dosyaları alabilirsiniz. test_suites_x86_64 hedefini bulun.

    acts_test.zip dosyası, Yapılar sekmesinin altındadır. Bu örnekte, acts_test.zip dosyasının /tmp/acts_test.zip hedefine indirildiğini varsayalım.

    Kaynak koda erişiminiz varsa bunun yerine onu kullanabilirsiniz.

  2. virtualenv uygulamasını makinenize yükleyin.

    Henüz yüklemediyseniz virtualenv uygulamasını kullanarak şunları yükleyebilirsiniz:

    python3 -m pip install -U --user virtualenv

  3. Sanal ortamı oluşturun ve etkinleştirin (bu örnek için /tmp/my_virtualenv ürününde). Bu, yeni paketlerin virtualenv dizinine yüklenmesini 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 istediğiniz yerden çalıştırın.

    act.py -c <config> ...

  6. Testleri çalıştırmayı bitirdiğinizde sanal ortamdan ayrılın.

    deactivate

Android cihaza Flash uygulama (isteğe bağlı)

Cihazın sistem ayrıcalıklı kontrolünü almak istiyorsanız cihazı bir userdebug derlemesi ile yükleyin.

Cihaza yüklemek için Android Flash Aracı'nı (flash.android.com/) kullanın. Daha fazla ayrıntı için Android Flash Aracı'ndaki dokümanlara bakın.

SL4A'yı yükleyin (isteğe bağlı, önerilir)

userdebug derlemesi olan bir cihaz kullanıyorsanız SL4A kullanarak cihazınız için sistem ayrıcalığı denetimi 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 işaretini ayarlayabilirsiniz.

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

SL4A APK'sını edinmek için Android için Komut Dosyası Katmanı talimatlarını izleyin.