Temel olmayan kodla katkıda bulunun

Tradefederation projelerine temel olmayan kaynak katkıda bulunan ekiplerin inceleme sürecinin tam sahibi olmasını sağlamak için aşağıdaki projeler, tüm ekipler için açık +2 haklarıyla oluşturulmuştur. Bu sayede, temel tradefederation ekibi temel çerçeveyle ilgili olmayan tüm kod incelemelerinin yükünden kurtulur ve diğer ekipler de inceleme döngülerinde daha hızlı iterasyon yapabilir.

Temel olmayan src, tradefederation çerçevesinin işlevsel olması için gerekli olmayan kod (ör. özel testler, yapılandırmalar, belirli test yardımcı programları) olarak tanımlanır.

ÖNEMLİ Çekirdek olmayan src öğesi, temel ticari federasyon sınıflarını genişletmemelidir. Bu, gelecekteki yeniden düzenleme/temizlik işlemlerini etkiler. Kodunuzun core'a mı yoksa contrib'e mi ait olduğundan emin değilseniz daha fazla bilgi için android-tradefed@ ile iletişime geçin. Tradefederation'ın çekirdek ekibi, size tavsiye vermekten ve özellik istekleri almaktan memnuniyet duyar.

Temel tradefederation sınıfı örneği olarak com.google.android.tradefed.build paketindeki aşağıdaki gibi sınıflar verilebilir: com.google.android.tradefed.build.LaunchControlProvider

Temel sınıf olarak nelerin kabul edileceği konusunda kafanıza takılan bir konu olursa lütfen android-tradefed@ adresine ulaşın.

[TOC]

Katkıda bulunulan projelerin yolları

Bu katkı projeleri kimler için oluşturuldu?

Şu anda tradefederation projelerinde test/test yardımcı programları/yapılandırmalar yazıyorsanız bu projeler sizin için oluşturulmuştur.

Katkıda bulunma projelerinde kod incelemeleri

Katkı projelerinin amacı, ana ekibin (android-tradefed@) incelemesine gerek kalmadan Tradefed'de geliştirme yapmanıza olanak tanımaktır. Bu nedenle, ekibinizin veya bağlamınız hakkında bilgi sahibi olan herhangi bir kişinin, CL'lerinizde kod incelemelerini yapmasını bekliyoruz.

Takılırsanız veya belirli bir konuda yardıma ihtiyacınız olursa android-tradefed@ ile iletişime geçebilirsiniz. Ancak contrib'de kod incelemenizi yapmak için varsayılan olarak bu adrese güvenmeyin. Tradefed ekibinin, contrib'deki kod incelemeleri için hizmet düzeyi hedefi yoktur.

Bu projeler üzerinde çalışmaya nereden başlayabilirim?

Bu projeler aşağıdaki şube manifestlerine eklendi ve ana platform ödemesinin bir parçası. Dolayısıyla, projeleri ortamınızda görmüyorsanız katkıda bulunmak için bir depo senkronizasyonu uzaktasınız demektir.

  • ana
  • tradefed
  • oc-dev
  • oc-dev-plus-aosp
  • nyc-mr2-dev-plus-aosp
  • main-daydream-dev
  • satıcı-olmayan-ana-
  • wear-main

Geliştirme ve test

contrib'deki geliştirmelerin, Android depolarındaki diğer yerlerle aynı kalite standardına sahip olması beklenir:

  • Android biçimlendirme kurallarına uyma
  • Kod test edilir ve testlerle gönderilir
  • Tasarım dikkatli bir şekilde yapılmış ve mantıklı

contrib'de yerel olarak nasıl test edebilirim?

AOSP

aosp'de, katkının birim testleri platform/tools/tradefederation/contrib/tests/src/ adresinde bulunur ve birim testleri, göndermeden önce ve yerel test komut dosyalarında alınabilmesi için com.android.tradefed.prodtests.UnitTests adresine eklenmelidir.

Yemek çalıştırıldıktan sonra Aosp yerel komut dosyaları:

tools/tradefederation/core/tests/run_tradefed_aosp_presubmit.sh

Katkıda bulunan projelerde derleme kuralları güncellemesi

Derleme kuralları (makefile'ler) kendi build/ klasörlerinde bulunur ve temel ekipten ek bir inceleme olmadan bunları değiştirmenizi engelleyen bir OWNERS dosyasıyla kilitlenir. contrib projesinin tek sınırlaması budur.

Bu inceleme, çekirdek ekibin bilgisi veya onayı olmadan genel Tradefed projelerine beklenmedik bir bağımlılık eklenmediğinden emin olmak için gereklidir. Gerçekten bazı yeni bağımlılıklar eklenmesine ihtiyacınız varsa kullanım alanlarınızı incelemek ve size tavsiyede bulunmak için lütfen android-tradefed@ ile iletişime geçin.