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 durum, gelecekte yapılacak 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. Çekirdek ticaret federasyon ekibi özellik talepleriyle ilgili tavsiyelerde bulunmaktan ve bu istekleri 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 testleri/testleri yazan ticari federasyon projelerinde çalışıyorsanız yardımcı programlar/yapılandırmalar gibi, 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.
Sorun yaşarsanız veya yardıma ihtiyacınız olursa android-tradefed@ adresiyle iletişime geçebilirsiniz. anahtar kelimeleri kullanabilirsiniz, ancak kod incelemenizi katkı İşlem yapılan ekibin katkısı olan kod incelemeleri konusunda herhangi bir SLO'su 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 gönderilir
- Tasarım dikkatli bir şekilde tasarlanmış 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ı projeleri için 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.