Bölünmüş IRemoteTest test çalıştırıcı yazma

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Test çalıştırıcısı yazarken ölçeklenebilirliği göz önünde bulundurmak önemlidir. Soru "test çalıştırıcımın 200 bin test durumu çalıştırması gerektiyse" ne kadar sürer?

Parçalama, Ticaret Federasyonu'nda bulunan yanıtlardan biridir. Bu, çalıştırıcının ihtiyaç duyduğu tüm testlerin paralelleştirilebilecek birkaç parçaya bölünmesini gerektirir.

Bu sayfada, koşucunuzu Tradefed için nasıl parçalanabilir hale getirebileceğiniz açıklanmaktadır.

Uygulanacak arayüz

TF tarafından parçalanabilir olarak kabul edilmek için uygulanması gereken en önemli arayüz IShardableTest'tir. Bu arayüz, split(int numShard) ve split() olmak üzere iki yöntem içerir.

Parçalama işleminiz istenen parça sayısına bağlı olacaksa split(int numShard) öğesini uygulamalıdır. Aksi takdirde split() uygulayın.

Bir TF test komutu, --shard-count ve parçalama parametreleriyle yürütüldüğünde --shard-index, TF, IRemoteTest boyunca yineleme yaparak yenilerini arar IShardableTest uygulanıyor. Bulunduğunda split çağrısını şu şekilde verir: belirli bir için test senaryolarının bir alt kümesini çalıştırmak üzere yeni bir IRemoteTest nesnesi alın kırık.

Bölünmüş uygulama hakkında bilmem gerekenler nelerdir?

• Runner'ınız yalnızca bazı koşullarda parçalara ayırabilir. Bu durumda, parçalara ayırmadığınızda null döndürün.
• Mantıklı olduğu kadar bölmeye çalışın: Runner'ınızı, kendisi için mantıklı olan bir yürütme birimine bölün. Bu, koşucunuza bağlıdır. Örneğin: HostTest sınıf düzeyinde parçalara ayrılır, her test sınıfı ayrı bir parçaya yerleştirilir.
• Anlamlıysa, parçalamayı biraz kontrol etmek için bazı seçenekler ekleyin. Örnek: AndroidJUnitTest maksimum parça sayısını belirtmek için bir ajur-max-shard öğesine sahip bölünmesini istemeyiz.

Ayrıntılı örnek uygulama

Aşağıda, IShardableTest uygulayan bir kod snippet'i örneği verilmiştir: bir referans noktası olarak kabul edilir. Tam kodu şu adreste bulabilirsiniz: (https://android.googlesource.com/platform/tools/tradefederation/+/refs/heads/main/test_framework/com/android/tradefed/testtype/installedInstrumentationsTest.java)

/**
 * Runs all instrumentation found on current device.
 */
@OptionClass(alias = "installed-instrumentation")
public class InstalledInstrumentationsTest
        implements IDeviceTest, IResumableTest, IShardableTest {
    ...

    /** {@inheritDoc} */
    @Override
    public Collection<IRemoteTest> split(int shardCountHint) {
        if (shardCountHint > 1) {
            Collection<IRemoteTest> shards = new ArrayList<>(shardCountHint);
            for (int index = 0; index < shardCountHint; index++) {
                shards.add(getTestShard(shardCountHint, index));
            }
            return shards;
        }
        // Nothing to shard
        return null;
    }

    private IRemoteTest getTestShard(int shardCount, int shardIndex) {
        InstalledInstrumentationsTest shard = new InstalledInstrumentationsTest();
        try {
            OptionCopier.copyOptions(this, shard);
        } catch (ConfigurationException e) {
            CLog.e("failed to copy instrumentation options: %s", e.getMessage());
        }
        shard.mShardIndex = shardIndex;
        shard.mTotalShards = shardCount;
        return shard;
    }
    ...
}

Bu örnekte, kendi yeni bir örneği oluşturulur ve bu örnek için bölüm parametreleri ayarlanır. Ancak bölme mantığı, testten teste tamamen farklı olabilir. Belirleyici olduğu ve toplu olarak kapsamlı alt kümeler sağladığı sürece bu sorun teşkil etmez.

Bağımsızlık

Parçaların bağımsız olması gerekir. Runner'ınızda split uygulamanız tarafından oluşturulan iki parçanın birbirine bağımlılığı veya paylaşılan kaynakları olmamalıdır.

Parçaların bölünmesi belirlenebilir olmalıdır. Geçerli olduğu sürece aynı koşullar altında, split yönteminiz her zaman aynı anahtar kelime listesini döndürmelidir aynı sıraya sokar.

NOT: Her kırık farklı TF örneklerinde çalışabileceğinden split mantığının birbirini dışlayan ve birbirini dışlayan alt kümeler getirdiğinden emin olun. ayrıntılı bir şekilde ele alacağız.

Testi yerel olarak parçalama

Yerel bir TF'de testi bölme işlemini yapmak için komut satırına --shard-count seçeneğini eklemeniz yeterlidir.

tf >run host --class com.android.tradefed.UnitTests --shard-count 3

Ardından TF, her bir parça için otomatik olarak komut oluşturur ve bunları çalıştırır.

tf >l i
Command Id  Exec Time  Device          State
3           0m:03      [null-device-2]  running stub on build 0 (shard 1 of 3)
3           0m:03      [null-device-1]  running stub on build 0 (shard 0 of 3)
3           0m:03      [null-device-3]  running stub on build 0 (shard 2 of 3)

Test sonucu toplama

TF, parçalara ayrılmış çağrılar için herhangi bir test sonucu toplama işlemi yapmadığından, raporlama hizmetinizin bunu desteklediğinden emin olmanız gerekir.