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.
Çekirdek olmayan src, ticari federasyon ç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 öğesi, temel ticari federasyon 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. Tradefederation'ın çekirdek ekibi, size tavsiye vermekten ve özellik istekleri almaktan memnuniyet duyar.
com.google.android.tradefed.buildpaketindeki şu gibi herhangi bir sınıf, temel federasyon sınıfına örnek olarak 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 bulunan projelerin yolları
Bu katkı projeleri kimler için?
Şu anda test/test yardımcı programları/yapılandırma yazan ticari federasyon projelerinde çalışı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 yönergelerine uyun
- Kod test edilir ve testlerle birlikte gönderilir
- Tasarım dikkatli bir şekilde yapılmış ve mantıklı
Katkıda bulunurken nasıl yerel test yapabilirim?
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 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.