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

Test çalıştırıcı yazarken ölçeklenebilirliği düşünmek önemlidir. "Test çalıştırıcım 200.000 test senaryosu çalıştırması gerekiyorsa ne kadar sürer?" diye kendinize sorun.

Bölme, Trade Federation'da sunulan çözümlerden biridir. Bu, çalıştırıcıya ihtiyaç duyulan tüm testlerin paralelleştirilebilecek birkaç parçaya bölünmesini gerektirir.

Bu sayfada, çalıştırıcınızın Tradefed için nasıl parçalara bölünebileceği açıklanmaktadır.

Uygulanacak arayüz

TF tarafından parçalanabilir olarak kabul edilmesi 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.

Bölme işleminiz, istenen parça sayısına bağlı olacaksa split(int numShard) uygulamanız gerekir. Aksi takdirde split()'ü uygulayın.

Bir TF test komutu, --shard-count ve --shard-index bölme parametreleriyle yürütüldüğünde TF, IShardableTest'ı uygulayan IRemoteTest öğelerini aramak için tüm IRemoteTest öğelerini iteratif olarak tarar. Bulunursa belirli bir bölüm için test durumlarının bir alt kümesini çalıştırmak üzere yeni bir IRemoteTest nesnesi almak için split çağrılır.

Bölünmüş uygulama hakkında ne bilmem gerekiyor?

• 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.
• Mantıklıysa parçalamayı biraz kontrol etmek için bazı seçenekler ekleyin. Örneğin: AndroidJUnitTest, istenen sayıdan bağımsız olarak bölünebileceği maksimum parça sayısını belirtmek için bir ajur-max-shard içerir.

Ayrıntılı örnek uygulama

Referans olarak kullanabileceğiniz IShardableTest uygulamasını gösteren örnek bir kod snippet'i aşağıda verilmiştir. Kodun tamamını şu adreste bulabilirsiniz: (https://android.googlesource.com/platform/tools/tradefederation/+/refs/heads/android16-release/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 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. Bu da zorunludur. Aynı koşullarda split yönteminiz her zaman aynı sırada tam olarak aynı parça listesini döndürmelidir.

NOT: Her bir parça farklı TF örneklerinde çalışabileceğinden, split mantığının birbirini hariç tutan ve toplu olarak kapsamlı olan alt kümeler sağladığından emin olmak belirleyici bir şekilde önemlidir.

Testi yerel olarak bölme

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.