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 kaynak, 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İ Temel olmayan src, temel tradefederation 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 isteklerini almaktan memnuniyet duyar.
Temel tradefederation sınıfı örneği olarak
com.google.android.tradefed.buildpaketindeki aşağıdaki gibi sınıflar verilebilir:com.google.android.tradefed.build.LaunchControlProviderTemel 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?
Ş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 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 ekipten yardım almamaya çalışın. 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 yapmanız yeterli.
- ana
- tradefed
- oc-dev
- oc-dev-plus-aosp
- nyc-mr2-dev-plus-aosp
- main-daydream-dev
- main-without-vendor
- 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 birlikte gönderilir
- Tasarım dikkatli 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.
Temel ekibin bilgisi veya onayı olmadan genel Tradefed projelerine beklenmedik bağımlılıkların eklenmediğinden emin olmak için bu incelemeye ihtiyacımız var.
Gerçekten yeni bağımlılıkların eklenmesi gerekiyorsa lütfen kullanım alanlarınızı incelemesi ve size tavsiyede bulunması için android-tradefed@ ile iletişime geçin.