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. Bu durum, 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, özellik isteklerini memnuniyetle kabul eder ve tavsiyelerde bulunur.
Temel bir Tradefederation 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.
[İÇİNDEKİLER]
Contrib projelerinin yolları
Bu katkı projeleri kimler içindir?
Şu anda testler/test yardımcı programları/yapılandırmalar yazarak tradefederation projelerinde çalışıyorsanız bu projeler sizin için oluşturulmuştur.
Katkı projelerinde 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 dal 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 dikkatli ve mantıklı
Katkı modülünde 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 sonraki 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.