İleri düzey ACTS kılavuzu

Bu kılavuzda, Android Comms Test Suite (ACTS) testlerinin nasıl çalıştırılacağına dair bilgiler verilmektedir.

Kodu edinin

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

Kodun nasıl senkronize edileceğiyle ilgili ayrıntılar için Kaynağı indirme bölümüne ve Android Developer Codelab'e bakın. Kodu senkronize ederken ana dalı senkronize edin. Etiketlenmiş bir derlemeyi senkronize etmeyin.

ACTS'yi indirirken Android deposunun tamamını senkronize etmeniz gerekmez. Yalnızca ACTS'i senkronize etmek için repo init komutunu çalıştırdıktan sonra şunu çalıştırın:

repo sync platform/tools/test/connectivity

ACTS'yi <repo>/tools/test/connectivity/acts/ altında bulabilirsiniz.

Ortam kurulumu

ACTS'in kurulum için gerekli bağımlılıklara sahip olduğundan emin olmak üzere 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 dosyasında bulunan setup.py komut dosyası, bağımlılıkların geri kalanını ve ACTS'i yükler.

ACTS üzerinde veya ACTS ile sürekli geliştirme yapmak 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 -

Kurulumu doğrulama

Kurulumdan sonra terminalinizde act.py kullanabildiğinizden ve Python'a ACTS modüllerini içe aktarabildiğinizden emin olun. Ö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ı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'ten içe aktarılacak Python yolunu değiştirmektir. ACTS'yi çalıştırmadan önce, ACTS'yi yüklemeden ACTS tarafından gerekli tüm bağımlılıkları 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 dosyasını ç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ı döndürür. Daha fazla bilgi için ACTS Testlerini Yapılandırma başlıklı makaleyi inceleyin.

ACTS'yi sanal bir ortamda ayarlama

Yüklemenizin diğer ACTS kurulumlarından izole edilmesi için ACTS'yi sanal bir ortama yüklemeniz gerekir. Aşağıdaki adımlarda, ci.android.com adresindeki aosp-main'dan acts_test.zip'e sahip olduğunuz veya kaynağa doğrudan erişiminiz olduğu varsayılır.

  1. ACTS'yi edinin.

    Derlemeler yayınlanır. Daha fazla bilgi için Android Sürekli Entegrasyonu başlıklı makaleyi inceleyin. ci.android.com adresindeki bir derlemeden zip dosyalarını 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'e indirildiğini varsayalım.

    Kaynak koda erişiminiz varsa bunun yerine onu kullanabilirsiniz.

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

    Henüz yoksa virtualenv'ı şu platformları kullanarak yükleyebilirsiniz:

    python3 -m pip install -U --user virtualenv

  3. Sanal ortamı oluşturun ve etkinleştirin (bu örnekte /tmp/my_virtualenv içinde). Bu işlem, yeni paketlerin virtualenv dizinine yüklenmesini sağlar.

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

  4. ACTS'i 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

    Kodu doğrudan erişebiliyorsanız sıkıştırılmış dosyayı açma işlemini atlayabilirsiniz:

    cd /path/to/acts/framework
python3 setup.py install

  5. ACTS'i 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 cihazı flaşlayın (isteğe bağlı)

Cihazın sistem ayrıcalıklı kontrolünü almak istiyorsanız cihazı userdebug derlemesiyle flaşlayın.

Cihaza yüklemek için Android Flash Aracı'nı (flash.android.com/) kullanın. Daha fazla bilgi için Android Flash Tool'daki dokümanları inceleyin.

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

userdebug derlemesi yüklü bir cihaz kullanıyorsanız SL4A'yı kullanarak cihazınızın sistem ayrıcalıklarını kontrol edebilirsiniz. Testinizde cihazda SL4A kullanılmı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.