Ticaret federasyonu projelerine çekirdek dışı kaynak kodu katkısında bulunan ekiplerin inceleme sürecinin tam sahipliğini almasını sağlamak için aşağıdaki projeler tüm ekipler için açık +2 haklarıyla oluşturuldu. Bu sayede, temel Tradefederation ekibi, temel çerçeveyle ilgili olmayan tüm kod incelemelerinin yükünden kurtulurken diğer ekipler de inceleme döngülerinde daha hızlı yineleme yapabilir.
Temel olmayan src, tradefederation çerçevesinin işlevsel olması için gerekli olmayan kod olarak tanımlanır (ör. özel testler, yapılandırmalar, belirli test yardımcı programları).
ÖNEMLİ Çekirdek olmayan src, çekirdek tradefederation sınıflarını genişletmemelidir. Bunu yapmak, gelecekteki yeniden düzenleme/temizleme işlemlerini etkiler. Kodunuzun çekirdek veya katkı bölümüne ait olup olmadığından emin değilseniz netleştirmek için android-tradefed@ adresinden bizimle iletişime geçin. Çekirdek Trade Federation ekibi, tavsiyelerde bulunmaktan ve özellik isteklerini almaktan memnuniyet duyar.
Temel bir Trade Federation sınıfı örneği,
com.google.android.tradefed.buildpaketindeki herhangi bir sınıf olabilir. Örneğin:com.google.android.tradefed.build.LaunchControlProviderHangi sınıfların temel sınıf olarak kabul edileceği konusunda net bir fikriniz yoksa lütfen android-tradefed@ adresinden bizimle iletişime geçin.
[İçindekiler]
Contrib projelerinin yolları
Bu katkı projeleri kimler içindir?
Şu anda tradefederation projelerinde testler/test yardımcı programları/yapılandırmalar yazıyorsanız bu projeler sizin için oluşturulmuştur.
Katkı projelerindeki kod incelemeleri
Katkı projelerinin amacı, çekirdek ekibin (android-tradefed@) incelemesine gerek kalmadan Tradefed'de geliştirme yapmanıza olanak tanımaktır. Bu nedenle, ekibinizin veya bağlamınızı bilen herkesin CL'lerinizde kod incelemeleri yapmasını bekliyoruz.
Takılırsanız veya belirli bir konuda rehberliğe ihtiyacınız olursa android-tradefed@ adresinden her zaman yardım alabilirsiniz. Ancak katkıdaki kod incelemenizi yapmak için varsayılan olarak bu adrese güvenmeyin. Tradefed ekibi, katkıdaki kod incelemeleriyle ilgili bir SLO'ya sahip değil.
Bu projeler üzerinde çalışmaya nereden başlayabilirim?
Bu projeler aşağıdaki şube manifestlerine eklendi ve ana platform ödeme sürecinin bir parçası hâline geldi. Bu nedenle, projeleri ortamınızda görmüyorsanız katkıda bulunmak için yalnızca bir depo senkronizasyonu yapmanız yeterlidir.
- 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ştirme çalışmalarının, Android depolarının diğer bölümlerindekiyle aynı kalite standardına sahip olması beklenir:
- Android biçimlendirme kurallarına uyun.
- Kod test edilir ve testlerle birlikte gönderilir
- Tasarım düşünülerek yapılmış ve mantıklı
Katkıda bulunanlar için yerel olarak nasıl test yapabilirim?
AOSP
AOSP'de contrib birim testleri platform/tools/tradefederation/contrib/tests/src/ konumunda bulunur ve birim testleri, ön gönderme ve yerel test komut dosyalarında kullanılmak üzere com.android.tradefed.prodtests.UnitTests'e eklenmelidir.
Öğle yemeği çalıştırıldıktan sonra AOSP yerel komut dosyaları:
tools/tradefederation/core/tests/run_tradefed_aosp_presubmit.sh
Katkıda bulunulan projelerde kuralları güncelleme
Derleme kuralları (makefile'lar) kendi build/ klasöründedir ve temel ekipten ek bir inceleme almadan değiştirmenizi engelleyecek bir OWNERS dosyasıyla kilitlenir. Katkı projesinin tek sınırlaması budur.
Bu inceleme, temel ekibin bilgisi veya onayı olmadan genel Tradefed projelerine beklenmedik bağımlılıklar eklenmemesini sağlamak için gereklidir.
Gerçekten yeni bağımlılıklar eklemeniz gerekiyorsa lütfen kullanım alanlarınızı inceleyip size tavsiyelerde bulunması için android-tradefed@ ile iletişime geçin.