Ticaret federasyonu projelerine temel kaynak dışı katkıda bulunan ekiplerin inceleme sürecinin tam sahibi olmasını sağlamak amacıyla, tüm ekipler için açık +2 haklara sahip aşağıdaki projeler oluşturulmuştur. Bu, çekirdek ticaret federasyonu ekibini çekirdek çerçeveyle ilgisi olmayan tüm kod incelemelerinin yükünden kurtarırken, diğer ekiplerin de inceleme döngülerini daha hızlı yinelemelerine olanak tanır.
Çekirdek olmayan src, ticari federasyon çerçevesi tarafından işlevsel olması gerekmeyen kod olarak tanımlanır (örn. özel testler, yapılandırmalar, belirli test yardımcı programları).
ÖNEMLİ Çekirdek olmayan src, çekirdek ticaret federasyonu sınıflarını genişletmemelidir. Bunu yapmak gelecekteki yeniden düzenlemeyi/temizlemeyi etkiler. Kodunuzun çekirdeğe mi yoksa katkıya mı ait olduğundan emin değilseniz açıklama için android-tradefed@ ile iletişime geçin. Çekirdek ticaret federasyonu ekibi, özellik taleplerini tavsiye etmekten ve almaktan mutluluk duyar.
Örnek bir çekirdek tradefederation sınıfı,
com.google.android.tradefed.buildpaketindeki herhangi bir sınıf olabilir:com.google.android.tradefed.build.LaunchControlProviderAndroid-tradefed@ için neyin çekirdek sınıf olarak değerlendirileceğinden emin değilseniz lütfen bize ulaşın.
[TOC]
Katkıda bulunan projelerin yolları
Bu katkı projeleri kimler için?
Şu anda ticaret federasyonu projelerinde testler/test yardımcı programları/yapılandırmalar yazarak ç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 sağlamaktır. Bu nedenle ekibinizin veya bağlamınıza aşina olan herhangi birinin CL'leriniz üzerinde kod incelemeleri yapmasını bekliyoruz.
Belirli bir durumda takılıp kalırsanız veya rehberliğe ihtiyaç duyarsanız her zaman android-tradefed@ ile iletişime geçmekten çekinmeyin, ancak katkı olarak kod incelemenizi yapmak için varsayılan olarak ona güvenmeyin. Katkıda kod incelemeleri söz konusu olduğunda Tradefed ekibinin SLO'su yoktur.
Bu projeler üzerinde çalışmaya nereden başlayabilirim?
Bunlar aşağıdaki şube bildirimlerine eklenmiştir ve halihazırda ana platform ödemesinin bir parçasıdır; dolayısıyla, projeleri ortamınızda göremiyorsanız, katkıda bulunmaktan bir repo senkronizasyonu uzaktasınız demektir.
- ana
- ticareti yapılan
- oc-dev
- oc-dev-plus-aosp
- nyc-mr2-dev-plus-aosp
- ana-hayal-geliştirme
- ana-satıcısız
- ana aşınma
Geliştirme ve test
Katkıda bulunan geliştirmenin, Android veri havuzlarındaki diğer yerler ile aynı kalite çıtasına sahip olması bekleniyor:
- Android biçimlendirme yönergelerine uyun
- Kod testlerle test edilir ve gönderilir
- Tasarım düşünceli ve anlamlıdır
Katkıda yerel olarak nasıl test yaparım?
AOSP
Aosp'de, katkının birim testleri platform/tools/tradefederation/contrib/tests/src/ konumunda bulunur ve birim testleri, ön gönderim ve yerel test komut dosyalarında alınmak üzere com.android.tradefed.prodtests.UnitTests'e eklenmelidir.
Öğle yemeğini çalıştırdıktan sonra Aosp yerel komut dosyaları:
tools/tradefederation/core/tests/run_tradefed_aosp_presubmit.sh
Projelere katkıda bulunmak için kural güncellemesi oluşturun
Derleme kuralları (makefiles) kendi build/ klasörleri altında bulunur ve çekirdek ekibin ekstra incelemesine gerek kalmadan bunları değiştirmenizi önleyecek bir OWNERS dosyası tarafından kilitlenir. Katkı projesinin tek sınırlaması budur.
Çekirdek 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 bazı yeni bağımlılıkların eklenmesine ihtiyacınız varsa, kullanım durumlarınızı incelemek ve size tavsiyelerde bulunmak için lütfen android-tradefed@ ile iletişime geçin.