OmniLab Android Test İstasyonu

OmniLab ATS, Android geliştiricilerinin ve test mühendislerinin kullanabileceği bir test aracıdır Android test paketlerini çalıştırmak için bir kullanıcı arayüzü Android Uyumluluk Test Paketi (CTS) Bu araç test çerçeveleri gibi çeşitli test çerçeveleri için bir web arayüzü işlevi Ticaret Federasyonu (TF) ve Google Mobly, CTS'yi çalıştırmanıza ve minimum kurulum düzeyiyle bir dizi test cihazında çoklu cihaz testlerinin yanı sıra testlerin sürekli yürütülmesi için bir zaman çizelgesi oluşturmalıdır.

OmniLab ATS'yi kurma

Bu bölümde, OmniLab ATS'yi nasıl yükleyeceğiniz ve ayarlayacağınız açıklanmaktadır.

OmniLab ATS, aşağıdaki konumlardaki kaynak kodlarını kullanır:

OmniLab ATS'yi yükleme

Çalıştırdığınız test paketleri için tüm donanım ve yazılım gereksinimlerine uyun.

CTS ile ilgili koşulları source.android.com adresinde bulabilirsiniz.

OmniLab ATS için ek donanım gereksinimi yoktur ancak şunları öneririz: CTS barındırıcı şartını kullanarak bir başlangıç noktası olarak düşünebilirsiniz.

OmniLab ATS'yi yüklemenin iki yolu vardır:

Yükleyici programıyla yükleme

Ubuntu 20.04 ve sonraki sürümlerde, yükleyici programı tüm programları yükler ve yapılandırır ve OmniLab ATS'yi çalıştırmak için gereken kaynaklar.

Yükleme programını kullanmak için:

  1. Yükleyici programını çalıştırın:

    curl https://storage.googleapis.com/android-mtt.appspot.com/prod/install.sh | bash
    
  2. OmniLab ATS CLI'ın yüklü sürümünü kontrol etmek için mtt version komutunu çalıştırın.

Manuel olarak yükleme

Docker'ı yükleme
  1. Şunu izleyin: Docker Community Edition (CE)'ı yükleme talimatları indirin.

  2. Docker'ı root olmayan bir kullanıcı olarak yönetmek için yükleme sonrası adımları uygulayın.

  3. Terminal pencerenizi yeniden başlatmanız veya oturumu kapatıp tekrar açmanız gerekebilir adresine gidin.

Python 3'ü yükleyin

OmniLab ATS CLI, Python'un 3.7-3.11 arasındaki sürümleriyle doğrulanır.

Ubuntu 16.04 veya önceki sürümler için önce bir yaparak Python 3 deposunu ekleyin şunlardan biri:

  • Bu komutu çalıştırın:

    sudo add-apt-repository ppa:deadsnakes/ppa
    
  • Depoyu derleme ve yükleme .

Python 3'ü yüklemek için şu komutları çalıştırın:

sudo apt-get update
sudo apt install python3 python3-distutils

Belirli bir Python 3 sürümünü (ör. 3.10) yüklemek için bunun yerine aşağıdaki komutları çalıştırın:

sudo apt-get update
sudo apt install python3.10 python3.10-distutils

OmniLab ATS CLI'ı edinme

Komut satırı arayüzü (KSA) paketini buradan indirin.

OmniLab ATS'yi başlat

OmniLab ATS'yi aşağıdaki komutla başlatın:

mtt start

Kullanıcı arayüzü ilk başlatıldığında, görünmesi birkaç dakika sürebilir. CLI, tarayıcıda kullanıcı arayüzüne erişmek için bir web URL'si gösterir. Varsayılan olarak web URL'si localhost:8000 Gerekirse başlatma sırasında varsayılan bağlantı noktasını --port işareti.

Daha yeni bir sürüm varsa mevcut sürüme güncelleyebilirsiniz. Şunları yapabilirsiniz: Sürüm Notları'na göz atın. en son sürümler için.

Geçerli sürüme güncellemek için şu komutu çalıştırın:

mtt start --force_update

Uygulamayı durdurmak için şu komutu çalıştırın:

mtt stop

Diğer komutların listesini görüntülemek için şunu kullanın:

mtt --help

Veritabanını yedekleme ve geri yükleme

OmniLab ATS veritabanını yedeklemek için uygulamayı durdurun ve aşağıdaki komutu çalıştırın: Bu işlem, mevcut veritabanını mtt-backup.tar adlı bir TAR dosyasına yedekler. ana dizininiz:

docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar cvf /out/mtt-backup.tar ."

Geri yüklemek için uygulamayı başlatmadan önce aşağıdaki komutu çalıştırın:

docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar xvf /out/mtt-backup.tar"

Kurulum Sihirbazı

OmniLab ATS'yi ilk kez yükleyip çalıştırdıktan sonra Kurulum Sihirbazı, aracı ortamınıza göre özelleştirmenize yardımcı olmak için sizi birkaç adımda yönlendirir. Herhangi biri Burada yaptığınız değişiklikler daha sonra Ayarlar sayfasından yeniden yapılandırılabilir.

Yapılandırma yedeğini geri yükleme

Başka bir OmniLab ATS ana makinesinden yedeklenmiş bir yapılandırma dosyanız varsa Dosya Yükle düğmesini tıklayarak bu ana makinede değiştirilen tüm yapılandırmaları kopyalamak için dosyayı yükleyebilirsiniz.

Yapılandırma Yedeğini Geri Yükle

Şekil 1. Yapılandırma Yedeklemesini Geri Yükleme.

Varsayılan hizmet hesabını ayarlama

Bir hizmet hesabı ayarlayabilirsiniz OmniLab ATS'nin kaynaklarınıza erişirken varsayılan olarak kullandığı Google Cloud Storage, Google Drive) ekleyin. Hizmet hesabınızın kimliğini doğrulamak için şunu tıklayın: Hizmet Hesabı Anahtarını Yükle'yi tıklayın ve hizmet hesabınızın JSON anahtar dosyasını seçin.

Hizmet Hesabı Ayarlama

Şekil 2. Hizmet hesabını ayarlama.

Hizmet hesabının kimliği başarıyla doğrulandığında, hesap e-posta adresi adresi sayfanın sağ üst köşesinde görünür. Hizmeti değiştirmek için hesap adını tıklayın, mevcut varsayılan hesabı kaldırın ve yeni bir hizmet hesabı anahtarı var.

Hizmet hesabını değiştir

Şekil 3. Hizmet hesabını değiştirme.

Yapılandırma kümelerini içe aktar

Yapılandırma kümesi, ilgili test paketlerini çalıştırmak için cihaz işlemleri yapabilir ve kanallar oluşturabilirsiniz. Yapılandırma kümeleri belirli bir Google Cloud Storage (GCS) paketi. GCS derleme kanalını Google Hesabı'nı seçtiğinizde, kullanabileceğiniz tüm yapılandırma gruplarının listesini görürsünüz.

Test Station ana makinenize eklemek istediğiniz yapılandırma kümelerini seçin ve Seçilenleri İçe Aktar.

Yapılandırma Kümelerini İçe Aktarın

4.Şekil Yapılandırma Kümesini içe aktarma

Kablosuz ayarlarını dahil etme

Bazı CTS testleri için cihazınızın bir kablosuz hotspot'a bağlanması gerekir. Seçmek için Kablosuz ağ, Kablosuz SSID ve isteğe bağlı Kablosuz PSK değerini girin.

Kablosuz Ayarları

5. Şekil. Kablosuz hotspot ayarları.

Kurulum Sihirbazı tamamlandıktan sonra sayfa yeni ayarlarla yeniden yüklenir geçerlidir.

Cihaz bağla

Bir cihazı test etmek için USB üzerinden hata ayıklama özelliği etkinleştirilmelidir. Hata ayıklamayı etkinleştirmek için:

  1. Şu adresteki talimatları uygulayın: Geliştirici seçeneklerini etkinleştir ve hata ayıklama ile ilgili daha fazla bilgi edinin.

  2. Özel ADB anahtarlarıyla önceden yüklenmiş test Android derlemelerini kullanmayı planlıyorsanız ~/.android/ dizinindeki özel .adb_key dosyaları.

    Dosyalar otomatik olarak yüklenir ve cihaz bu derlemeleri çalıştıracak şekilde yüklendikten sonra USB hata ayıklama özelliğini otomatik olarak etkinleştirmek için ADB'ye iletilir.

  3. Cihazı, USB kullanarak ana makineye bağlayın.

    Cihaz, işlem tamamlandıktan sonra bir dakika içinde OmniLab ATS Cihazlar sekmesinde görünür web arayüzü yenileniyor. Cihazların durumunu şurada da görüntüleyebilirsiniz: bu sekmeden erişebilirsiniz.

    Cihaz Bağlayın

    6. Şekil. Bir cihaz bağlama.

Farklı cihaz durumları şunlardır:

  • Kullanılabilir - Cihaz bağlı ve test çalıştırmaya hazırdır.
  • Ayrılmış - Cihaz bağlıdır ve bir test yürütmektedir. Her biri Aynı anda yalnızca bir test çalıştırabileceğinden cihazın testini tamamlaması gerekir ve mevcut testi kontrol edin.

Testi çalıştırma

Bir test seçin

OmniLab ATS, önceden paketlenmiş bir dizi CTS yapılandırması ile birlikte gelir. Aşağıdakilerden birini çalıştırmak için Test Paketleri sekmesine gidin ve seçilen test için Testi çalıştır'ı testi.

Bir Test Seçin

7.Şekil Test seçme.

Testleri düzenlemek veya yeni testler eklemek için Test ekleme bölümüne bakın.

Test çalıştırmasını yapılandırma

Bu özel test çalıştırması için kullanılacak parametreleri düzenleyin. Çoğu parametre seçilen test yapılandırmasında tanımlanan değerlerle önceden doldurulur.

Bu adım, varsayılan değerler kullanılarak tamamlanabilir ancak Max Retry ve Command gibi parametreleri ihtiyaçlarınıza göre ayarlayın.

Test Çalıştırmayı Yapılandırma

8. Şekil. Test çalıştırması yapılandırma.

Test çalıştırması parametreleri şunlardır:

  • Ad - Çalıştırmak istediğiniz test paketinin adı.
  • Çalıştırma Sayısı: Bu test çalıştırmasının için iyi bir fırsattır. Test çalıştırmaları, Trade Federation kullanılarak planlanır. Bu araç, kapasitesi varsa 20'ye kadar test çalıştırmasını paralel olarak yürütür.
  • Maksimum Yeniden Deneme - En az bir test çalıştırması varsa bir test çalıştırmasının maksimum yeniden deneme sayısı test başarısız olur. Bu değer, genellikle kararsız testleri ele almak için tam bir CTS çalıştırması için 4-6 yeniden deneme olarak ayarlanır.
  • Sıra Zaman Aşımı: Bir test çalıştırması çok uzun süre Sırada durumunda kalırsa otomatik olarak iptal edilir. Önce beklenecek süreyi belirtin buradan iptal edebilirsiniz. Varsayılan değer 24 saattir.
  • Command: Test paketini çalıştırma komutu. Buraya ek komut satırı bağımsız değişkenleri girebilirsiniz. Örneğin, CTS 8.1'de belirli bir modül şununla:

    cts-suite -m ShortModuleName
    
  • Tekrar Deneme Komutu: Bir test paketini yeniden deneme komutu. Ekleyebileceğiniz: komut satırı bağımsız değişkenlerine buradan göz atabilirsiniz. Örneğin, yalnızca bir kez CTS 8.1'deki belirli modüller için şunu kullanın:

    cts --retry 0 -m ShortModuleName
    

    Yeniden deneme bağımsız değişkenleri, ilk komutta kullanılabilen bağımsız değişkenlerden farklı olabilir. Bu nedenle, seçilen test için resmi sitede desteklenen parametreleri kontrol edin paketinde yer alır.

  • Önceki Test Çalıştırması - Önceki bir test çalıştırmasını yeniden çalıştırmak isterseniz:

    • Yerel - Çalıştırma mevcut ana makinede başlatıldıysa test çalıştırmasını girin Test çalıştırmasının ayrıntıları görüntülenirken görülen kimlik.

      Önceki Yerel Test Çalıştırması

      9. Şekil. Önceki yerel test çalıştırması.

    • Uzaktan - Çalıştırma farklı bir ana makinede başlatıldıysa testi Remote'u seçip Test Sonuçlarını Yükle'yi tıklayarak test sonuçlarını yükleyin Dosya'ya gidin ve yerel depolama alanınızdan dosya seçin.

      Uzak Önceki Test Çalıştırma

      Şekil 10. Uzaktan önceki test çalıştırması.

Cihazları seçin

Testi çalıştırmak üzere ayrılacak cihazları seçmek için onay kutularını tıklayın paketinde yer alır. Kırık sayısı, parça sayısı ile eşleşecek şekilde otomatik olarak cihaz seçildi.

Cihazları Seçin

Şekil 11. Cihazlar seçiliyor.

Cihazları, cihaz serileri dışındaki özelliklere göre seçmek için manuel olarak "Cihaz Özellikleri"ni girin. Örneğin, ürün adı şu şekilde olan 3 cihaz seçmek için: "bramble" için aşağıdakini girin:

product:bramble;product:bramble;product:bramble

Desteklenen özellikler şunlardır:

  • build_id
  • device_serial
  • device_type [cihaz_türü]
  • ana makine adı
  • ürün
  • product_variant
  • sim_state

Test çalıştırmasını yürütmek için seçili tüm cihazların Kullanılabilir durumunda olması gerekir. ve test çalıştırması yürütüldüğünde tümü Ayrılan durumuna geçer. CEVAP test çalıştırması, cihazların etkinleştirilmesi beklenirken Sıraya durumundadır kullanılabilir.

Cihaz ekleme işlemleri

Cihaz işlemleri, her test çalıştırmasından önce yürütülebilecek komut dosyalarıdır. Biraz yanıp sönme ve yeniden başlatma gibi cihaz işlemleri halihazırda yapılandırılmıştır. Alıcı: yeni cihaz işlemleri oluşturmak için bkz. Yeni bir cihaz işlemi oluşturun.

Cihaz İşlemleri

Şekil 12. Cihaz işlemleri.

Test çalıştırmasına bir cihaz işlemi eklemek için Yeni işlem ekle'yi tıklayın, Eklenecek işlemlerin onay kutularını işaretleyip İşlem Ekle'yi tıklayın. Cihaz işlemleri sırayla gerçekleştirilir. İşlemleri sürükleyerek yeniden sıralayabilirsiniz.

İşlem Ekle

Şekil 13. İşlemler yeniden sıralanıyor.

Test kaynaklarını ayarlama

Test kaynakları, test çalıştırmak için gereken dosyalardır. Örneğin, CTS bir android-cts*.zip dosyası gerektirir ve bir cihazın yanıp sönmesi için şunları yapmanız gerekir: derleme görüntüsünü sağlar.

Test paketi zip dosyasının indirme URL'si varsayılan olarak iş ortaklarına verilen Google Drive bağlantıları olmalıdır. Göz at'ı tıklayarak farklı bir dosya seçebilirsiniz. Pop-up pencerede bir dosya indirme bağlantısı girebilir, kimliği doğrulanmış derleme kanalından veya yerel depolama alanından kullanmak üzere bir dosya yükleyin.

Test Kaynakları

Şekil 14. Kaynakları test edin.

Aşağıda, web URL'sine göre test kaynağı seçmek için kullanılan pop-up pencere gösterilmektedir. Şunları yapabilirsiniz: indirme URL'si bağlantısını girin ve şunu onaylamak için Seç düğmesini tıklayın: seçim.

Test Kaynak Seçicisi - Web URL'si

Şekil 15. Test Kaynak Seçici - Web URL'si.

Google Grive, Google Cloud Storage (GCS) veya Dilerseniz ilgili kanalın sekmesine gidip oradalar. Google Drive'dan kaynak seçmeyle ilgili bir örneği aşağıda bulabilirsiniz.

Test Kaynak Seçici - Google Drive

Şekil 16. Test Kaynak Seçici - Google Drive.

Sadece dosya seçmeye ek olarak, Dosya adı alanına girin. Dokümanları burada bulabilirsiniz.

Test Kaynak Seçici - Joker Karakter Modeli Desteği

Şekil 17. Test Kaynak Seçici - Joker karakter modeli desteği.

OmniLab ATS'nin yerel dosya depolama alanından da dosya seçebilirsiniz. Bu depolama alanına dosya yükleyebilir veya yerel dosyaları ve dizinleri doğrudan kullanabilirsiniz.

Test Kaynak Seçicisi - Yerel Dosya Deposu

Şekil 18. Test Kaynak Seçici - Yerel dosya deposu.

Yeniden çalıştırma yapılandırmaları ekle

Birincil çalıştırma tamamlandıktan sonra başlayan tekrarlar planlayabilirsiniz. ancak farklı cihaz, işlem veya kaynaklar kullanabiliyor.

Yeniden Çalıştırma Yapılandırmaları Ekle

19. Şekil. Yeniden çalıştırma yapılandırmaları ekleme.

Test çalıştırması başlatma

Test çalıştırması için gerekli bilgileri girdikten sonra Testi Başlat"ı tıklayın. Çalıştırın. Tüm bilgiler geçerliyse test çalıştırması başlar ve test çalıştırmasının ayrıntılarını ve ilerleme durumunu görüntüleyebileceğiniz bir sayfaya yönlendirilirsiniz.

Test Çalıştırmayı Başlatma

Şekil 20. Test çalıştırması başlatılıyor.

Test planı oluşturma

Test planları, periyodik bir programa göre test çalıştırmaları oluşturmak amacıyla kullanılır. Örneğin, her gün saat 17:00'de CTS 9.0 çalıştırıyorum. Yeni bir test planı oluşturmak için Yeni test planı oluştur'u tıklayın.

Test Planı Oluştur

Şekil 21. Test planı oluşturma.

Test planını yapılandırma

Test planının adını ve eklemek istediğiniz etiketleri girin. Ardından bir zaman çizelgesine uymanız gerekir.

  • Manuel - Test planı, yalnızca bir kullanıcı şu öğeyi tıkladığında test çalıştırmaları oluşturur: Test planı listesi sayfasında test planını çalıştırın.
  • Periyodik: Test planı, periyodik program seçildi. Örneğin, her gün saat 12:00'de bir test çalıştırması 17:00 seçeneğini tıklayın.
  • Özel: Test planı, test çalıştırmalarını cron ifadesi girildi. Örneğin, her gün saat 17:00'de bir test çalıştırması planlamak için cron ifadesi 0 17 * * *

Test Planını Yapılandırın

Şekil 22. Test planı yapılandırma.

Test paketleri ekle

Test planı tarafından programlanmasını istediğiniz test paketlerini eklemek için + Ekle test çalıştırması yapılandırmasını inceleyin. Ad açılır listesinden bir test paketi seçin ve Sonraki adım. Ardından, testi çalıştırmak istediğiniz cihazları seçin ve Add Configuration'ı (Yapılandırma Ekle) tıklayın. Her test için birden fazla yapılandırma ekleyebilirsiniz daha fazla bilgi edineceksiniz.

Test Çalıştırmayı Yapılandırma

Şekil 23. Test çalıştırması yapılandırma.

Cihaz ekleme işlemleri

Her test çalıştırmasından önce yürütülmesini istediğiniz cihaz işlemlerini ekleyin. Daha fazla ayrıntı için Cihaz işlemleri ekleme başlıklı makaleye bakın.

Cihaz işlemleri ekleme

Şekil 24. Cihaz işlemleri ekleniyor.

Test kaynaklarını ayarlama

Test planlarına test kaynakları eklemek, onları bireysel teste eklemekle aynıdır koşar. Daha fazla bilgi için Test kaynaklarını ayarlama bölümüne bakın.

Test Kaynaklarını Ayarlayın

Şekil 25. Test kaynaklarını ayarlama.

Test çalıştırmalarını göster

Test çalıştırma listesi

Test Çalıştırmaları sayfasındaki planlanmış test çalıştırmalarının listesini görüntüleyin. Test çalışmasıyla ilgili daha fazla ayrıntı görmek için Görüntüle'yi tıklayın.

Filtre çubuğuna bir dize girerek ve Enter tuşuna basarak da listeyi filtreleyebilirsiniz. Filtreleri birbirinden ayırarak birden çok filtre kullanabilirsiniz. virgül olabilir. Filtre, tam metni (alt dize içermeyen) içeren tüm satırları döndürür eşleme) herhangi bir sütunda (Durum ve Oluşturuldu hariç) görünür.

Boş bir filtre tüm satırları döndürür. Şu anda satırları filtrelemenin bir yolu yoktur kullanabilirsiniz.

Test Çalıştırma Listesi

Şekil 26. Test çalıştırması listesi.

Test çalıştırması ayrıntıları

Bir test çalıştırmasının durumu, günlükler ve sonuç.

Test Çalıştırma Ayrıntıları

Şekil 27. Test çalıştırması ayrıntıları.

Test çalıştırma durumu

Test çalıştırması ilerleme durumu, Durum bölümünde gösterilir. Konuyla ilgili bir indirme işleminin ilerleme durumu, iptal nedeni veya hata mesajı gibi burada da gösteriliyor.

Test Çalıştırma Durumu

28. Şekil. Test çalıştırması durumu.

Test çalıştırma durumları şunlardır:

  • Beklemede: Gerekli kaynaklar indiriliyor.
  • Kuyruğa alındı - Test, bir cihaz kullanılabilir olduğunda çalıştırılmaya hazırdır.
  • Çalışıyor - Test, tahsis edilen bir cihazda çalışmaktadır.
  • Tamamlandı: Test tamamlandı ve sonuçları raporlandı.
  • İptal edildi: Test, kullanıcı tarafından iptal edilmiştir veya şunu yapmaya çalışırken zaman aşımına uğramıştır kullanılabilir cihazları bulabilir.
  • Hata: Testin çalışmasını engelleyen bir hata oluştu.

Test çalıştırmasını iptal etme

Test çalıştırması tamamlanmadıysa İptal'i ve ardından ardından onay iletişim kutusunda Evet'i tıklayın. Test çalıştırmaları ayrıca daha uzun süre Sırada durumunda kalırsa otomatik olarak iptal edilir queue_timeout_seconds alanına ekleyin. Çalışıyor durumundayken test çalıştırmasını iptal etme birkaç dakika sürebilir.

Test Çalıştırmasını İptal Et

29. Şekil. Test çalıştırmasını iptal etme

Test çalıştırması sonuçları

Test çalıştırması bittikten sonra, sonuçlar toplanır ve görüntülenir. Her çalıştırma için oku tıklayarak ek ayrıntıları görüntüleyebilirsiniz. Çıktıyı Görüntüle'yi tıklayın. Files'ı kullanarak toplanan test yapılarını görebilirsiniz. Örneğin, test_result.xml ve test_result_failures.html.

Test Çalıştırma Sonuçları

Şekil 30. Test çalıştırması sonuçları.

Canlı ana makine ve Tradefed günlüklerini Günlükler sekmesinde görüntüleyebilirsiniz.

Test Çalıştırma Günlükleri

Şekil 31. Günlükler sekmesi.

Modüllerin sonuçları Test Sonuçları sekmesinde yer alır.

Test Sonuçları Sekmesi

Şekil 32. Test Sonuçları sekmesi.

Test kaynağı olarak kullanılan dosyaları 'ı tıklayarak indirebilirsiniz. Test Kaynakları sekmesi.

Test Kaynakları sekmesi

Şekil 33. Test Kaynakları sekmesi.

Test çalıştırmasının ayrıntılarını (ör. create_time) görmek için Yapılandırma sekmesine gidin.

Test Yapılandırması Sekmesi

Şekil 34. Config (Yapılandırma) sekmesini tıklayın.

İleri seviye özellikler

Yapılandırma dosyalarını yönet

OmniLab ATS, testler, derleme kanalları ve cihaz işlemleri gibi önceden tanımlanmış seçenekleri yüklemek için YAML ile yazılmış yapılandırma dosyalarını kullanır. Aşağıda örnek bir yapılandırma dosyası verilmiştir:

// example_file.yaml
tests:
- id : android.cts.9_0.arm
  name: CTS 9.0 (ARM)
  test_resource_defs:
  - name: android-cts.zip
    default_download_url: https://dl.google.com/dl/android/cts/android-cts-9.0_r7-linux_x86-arm.zip
    test_resource_type: TEST_PACKAGE
  command: cts
  env_vars:
  - name: TF_PATH
    value: ${TF_WORK_DIR}/android-cts/tools:${TF_WORK_DIR}/android-cts/testcases
  - name: LD_LIBRARY_PATH
    value: ${TF_WORK_DIR}/android-cts/lib:${TF_WORK_DIR}/android-cts/lib64
  setup_scripts:
  output_file_patterns:
  - android-cts/logs/latest/.*
  - android-cts/results/latest/.*\.html
  - android-cts/results/latest/compatibility_result\..*
  - android-cts/results/latest/logo.png
  - android-cts/results/latest/test_result.xml
  result_file: test_result.xml
  java_properties:
  - name: CTS_ROOT
    value: ${TF_WORK_DIR}
  context_file_dir: android-cts/results/
  context_file_pattern: '[\d_\.]+\.zip'
  retry_command_line: retry --retry 0
  runner_sharding_args: --shard-count ${TF_SHARD_COUNT}

build_channels:
- id: google_drive
  name: Google Drive
  provider_name: Google Drive

device_actions:
- id: flash
  name: Flash
  test_resource_defs:
  - name: bootloader.img
    test_resource_type: DEVICE_IMAGE
  - name: radio.img
    test_resource_type: DEVICE_IMAGE
  - name: img.zip
    test_resource_type: DEVICE_IMAGE
  tradefed_target_preparers:
  - class_name: com.android.tradefed.targetprep.RunHostCommandTargetPreparer
    option_values:
    - name: work-dir
      values:
      - ${TF_WORK_DIR}
    - name: host-setup-command
      values:
      - adb -s $SERIAL reboot-bootloader
      - fastboot -s $SERIAL flash bootloader bootloader.img
      - fastboot -s $SERIAL flash radio radio.img
      - fastboot -s $SERIAL reboot-bootloader
      - fastboot -s $SERIAL -w update img.zip
      - adb -s $SERIAL wait-for-device
    - name: host-cmd-timeout
      values:
      - 10m

OmniLab ATS örneğinizi oluşturduğunuzda yapılandırmanızı diğer kullanıcılara gönderebilirsiniz. Bunu yapmak için Ayarlar sayfasına gidin ve sağ üstteki Dışa aktar'ı tıklayın.

Yapılandırma Dosyası Yönetimi

35. Şekil. Yapılandırma dosyası yönetimi.

Yapılandırma dosyanız indirildikten sonra dosyayı diğer kullanıcılarla paylaşın. Bunun için yapılandırma dosyasını OmniLab ATS örneğine eklemek için İçe aktar'ı tıklayın ve yapılandırma dosyasını seçin.

Yeni cihaz işlemi oluşturma

Cihaz işlemleri, cihaz kurulum sürecini otomatikleştirmek için kullanılır. İşlemler testin çalıştırıldığı her cihazda çalıştırılan komut dosyalarıdır. ve yeniden denemelerden önceki kısımlar dahil. Kullanılabilir cihaz işlemlerinin listesini görüntülemek için şuraya gidin: Ayarlar sayfasına gidin ve Cihaz İşlemleri sekmesini tıklayın. Çeşitli cihaz işlemleri, yeniden başlatma ve yanıp sönme gibi önceden yapılandırılmıştır.

Cihaz İşlemleri sekmesi

Şekil 36. Cihaz İşlemleri sekmesi.

Yeni cihaz işlemi ekleme

  1. Yeni cihaz işlemi'ni tıklayın.

    Yeni Cihaz İşlem düğmesi

    37 Şekil. Yeni cihaz işlem düğmesi.

  2. Ad ve açıklama girin.

    Cihaz İşlem adı

    38. Şekil. Cihaz işleminin adı.

  3. Hedef Hazırlayıcı Ekle'yi tıklayın.

  4. Ticaret Federasyonu Hedefini girin Hazırlayıcının tam sınıf adı, örneğin, com.android.tradefed.targetprep.RunHostCommandTargetPreparer.

    Hedef Hazırlayıcı Ekle

    39. Şekil. Hedef hazırlayıcı ekleniyor.

    Kullanılabilir hedef hazırlayıcıların listesini com.android.tradefed.targetprep referansında bulabilirsiniz.

    Hedef Hazırlayıcı Listesi

    Şekil 40. Hedef Hazırlayıcı listesi.

  5. Hedef hazırlayıcıyla kullanılacak seçenekleri ekleyin. Mevcut seçenekleri görmek için: kontrol etmek targetprep kodunu ekleyin:

    İşlem Seçeneği Örneği

    Şekil 41. İşlem seçeneği örneği.

  6. Bir seçenek eklemek için Add Target Preparer Option'ı (Hedef Hazırlayıcı Seçeneği Ekle) tıklayın ve değerleridir.

    İşlem Komutu Örneği

    Şekil 42. İşlem komutu örneği.

  7. Cihaz işlemini yürütmek için gereken test kaynaklarını (ör. önyükleme için resim oluşturma) tanımlayın. Kaynak tanımı eklemek için Test Kaynağı ekleyin ve zorunlu alanları doldurun. Dosyalarınızın nerede olduğunu biliyorsanız göz at'ı tıklayarak varsayılan bir indirme URL'si sağlayabilirsiniz. Hedef hazırlayanlar, dizini test kaynağı olarak kabul ederse Sıkıştırmayı aç'ı seçin. Daha sonra, göreli Destination dizinini belirtin. altındaki Dosya Adları'na sıkıştırılmış. Herhangi bir dosya adı sağlanmazsa, test kaynağı.

    İşlem Testi Kaynakları

    Şekil 43. İşlem testi kaynakları.

  8. Güncelle'yi tıklayın.

    İşlem Değişiklikleri Kaydet

    Şekil 44. İşlemin kaydettiği değişiklikler.

Testleri yönetin

Testi düzenleme

Kayıtlı bir testi düzenlemek için Testler sayfasına gidin ve test edin. Test yapılandırmasını değiştirdikten sonra, Güncelle

Testi düzenleyin

45.şekilde Testi düzenleme

Yeni test ekle

Yeni bir test eklemek için Testler sayfasına gidin ve Yeni Test Oluştur'u tıklayın. Girin ilgili bilgileri girin ve Oluştur'u tıklayın.

Test oluştur

Şekil 46. Test oluşturma.

Testi kopyalama

47.Şekil Test kopyalanıyor.

Ana makine yapılandırmalarını dışa aktarma

Bir ana makineyi yapılandırdıktan sonra ana makinenin yapılandırmalarını bir dosyaya aktarabilirsiniz. Kayıtlı yapılandırmaları kopyalamak için bu dosyayı diğer ana makinelere yükleyebilirsiniz.

Bir ana makinenin yapılandırmalarını dışa aktarmak için Ayarlar sayfasına gidip sağ üst köşedeki Dışa aktar'ı tıklayın.

Ana makine yapılandırmalarını dışa aktarma

48. Şekil. Ana makine yapılandırmasını dışa aktarma.

Bir ana makine yapılandırma dosyasını içe aktarmak için Ayarlar sayfasına gidin ve İçe aktar'ı tıklayın.

Ana makine yapılandırmalarını içe aktarma

Şekil 49. Ana makine yapılandırmasını içe aktarma.

Yerel dosyaları ve dizinleri kullanın

R11 sürümünden itibaren $HOME/.ats_storage dizinindeki dosyalar OmniLab ATS üzerinden otomatik olarak erişilebilir. İlgili klasöre bir dosya kopyalayın veya taşıyın seçebilirsiniz. Bunu, dosyayı planlarken Local File (Yerel Dosya) sekmesinden test çalıştırması yapabilirsiniz.

cp /path/to/file $HOME/.ats_storage

Yerel dosya seçme

50.şekilde: $HOME/.ats_storage dizininden bir dosya seçin.

Yerel dosya deposuna daha fazla dizin eklemek için --mount_local_path işareti.

mtt start --mount_local_path=/path/to/dir1 --mount_local_path=/path/to/dir2:renamed_dir2

Ek olarak monte edilen dizinler

Şekil 51. Yerel dosya deposuna eklenen ek dizinler.

Çoklu ana makine modunu etkinleştir

Çoklu ana makine modunda, kullanıcılar tek bir ATS denetleyici ana makinesiyle şunları yönetebilir: cihazlar ve testler için geçerlidir.

Çoklu ana makine modu mimarisi

Şekil 52. Çoklu ana makine modu mimarisi.

  1. ATS denetleyicisini başlatmak için aşağıdaki komutu kullanın:

    mtt start --operation_mode=ON_PREMISE
    
  2. Kontrol kumandasına http://${CONTROLLER_HOSTNAME}:8000 adresinden erişilebilir.

  3. Çalışanları başlatmak için aşağıdaki komutu kullanın:

    mtt start --control_server_url=http://CONTROLLER_HOSTNAME:8000 --operation_mode=ON_PREMISE
    

Ağınız, ana makinelerin birbiriyle iletişim kurmasına izin vermiyorsa aşağıdaki daha gelişmiş kurulum talimatlarını uygulamanız gerekir: ATS çalışanı üzerinde.

  1. SSH tünellerini kullanarak iki ana makineyi birbirine bağlayın. Şu bağlantı için bağlantı noktası seçin: bağlantı noktaları hakkında daha fazla bilgi edinin. Örneğin, 9000 ve 9006.

    ssh -L ATS_PORT:localhost:8000 -L FS_PORT:localhost:8006 CONTROLLER_HOSTNAME
    
  2. ATS'yi yapılandırın ve başlatın.

    DOCKER_GATEWAY_IP_ADDRESS=$(ip -4 addr show dev docker0 | grep -Eo 'inet [.0-9]+/' | grep -Eo '[.0-9]+')
    socat tcp-listen:ATS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:ATS_PORT &
    socat tcp-listen:FS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:FS_PORT &
    mtt start --control_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:ATS_PORT \
                    --control_file_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:FS_PORT \
                    --operation_mode=ON_PREMISE
    

Dosya temizleyici

Dosya temizleyici, e-tablonuza göre dosyaları temizlemek için saatlik kullanıcı tanımlı yapılandırmalar var. ATS'nin testi arşivlemek için iki varsayılan yapılandırması vardır sonuçları çalıştırıp geçici dosyaları silebilirsiniz. Bu kılavuzda, DMAIC ve Yalın Altı Sigma yaklaşımının politikaları ve yapılandırmayı inceleyin.

Politikalar

Politika, dosyalar veya dizinler üzerinde gerçekleştirilecek işlemi tanımlar. ölçütleri nasıl belirleyeceğinizi öğrendiniz. Kullanılabilir işlemler tabloda gösterilir:

İşlem türüParametreler
ARCHIVEremove_file: true ise dosyayı arşivledikten sonra kaldırın.
DELETE

Kriterler, dosya özelliklerine ve sistem bilgilerine dayanır. Uygun aşağıdaki ölçütler tabloda gösterilir:

Ölçüt türüAçıklamaParametreler
LAST_MODIFIED_TIMEDosyaları son değişiklik tarih ve saatine göre filtreleyin.ttl: 10m, 2h, 7 days, 4w gibi çeşitli zaman ifadeleri desteklenir. Desteklenen biçimler için pytimeparse bölümüne bakın.
LAST_ACCESS_TIMEDosyaları son erişim tarihlerine ve saatlerine göre filtreleyin.LAST_MODIFIED_TIME ile aynı.
NAME_MATCHNormal ifade kullanarak dosyaları adlarına göre filtreleyin.pattern: Normal ifade (ör. sonuç ZIP dosyalarıyla eşleştirmek için [a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}\.zip).
SYSTEM_AVAILABLE_SPACESistemdeki kullanılabilir alana göre işlemleri tetikleyin.threshold: Kullanılabilir alan eşiğin altına düştüğünde işlemi tetikleyin. Örneğin, 200(B), 200KB, 200MB, 200GB, 2TB.

Yeni dosya temizleyici politikası

Şekil 53. Yeni bir dosya temizleyici politikası ekleyin.

Yapılandırmalar

Yapılandırma, bir veya daha fazla politikayı belirli dizinlerle birleştirir. Dosyalar ve belirtilen dizinlerdeki dizinler, tanımlanmış politikalar. Politikalar, yapılandırmada göründükleri sırayla uygulanır.

Tüm hedef dizinler, /data dizininin altında olmalıdır. Eğer config, hedef dizini logs olarak belirtiyorsa, şu şekilde yorumlanır: /data/logs.

Dosya temizleyici yapılandırmasını düzenleme

Şekil 54. Dosya temizleyici yapılandırmasını düzenleyin.

Sıfırla

Ayarları Sıfırla'yı tıkladığınızda dosya temizleyici yapılandırması, eski haline döner. varsayılan duruma getirin. Bu işlem TÜM özel öğeleri temizler.

Dosya temizleyici ayarlarını sıfırlama

55. Şekil. Dosya temizleyici ayarlarını sıfırlayın.

Destek

Hata raporları

OmniLab ATS'ye yaptığınız katkı, aracın iyileştirilmesine yardımcı olur. görüşlerinizi öğrenmek istiyoruz! Bkz. OmniLab ATS sürüm notları ziyaret edin. Hataları bildirmek veya öneride bulunmak için hata raporu gönderin. İş ortakları, hataları veya önerileri iş ortağı kanallarını kullanarak bildirmelidir.