Herhangi bir açık kaynak katkısı ile başlamak için en iyi yer Bilginize, deneyiminize ve ilgi alanınıza uygun bir şey.
Başlamadan önce
Katkıda bulunmaya başlamadan önce, proje hakkında bir fikir edinmek yardımcı olabilir bir bütün olarak. Eğer daha önce BeeWare Tutorial, oradan başlayın. Bu size şunları verecektir En önemli BeeWare araçlarına maruz kalma, böylece nasıl olduklarını görebilirsiniz hepsi birbirine uyuyor.
Bu eğitimi tamamladıktan sonra, bir şey seçmeye hazır olacaksınız üzerinde çalışmak için. Eğer öğreticiyi yaparken herhangi bir sorun yaşadıysanız - eğer bir hata veya bir adımı tanımlamak için kullanılan dil açık değilse - bu bir başlamak için harika bir yer! Eğer deneyiminizi bir öğreticideki iyileştirme, öğreticiyi yapan bir sonraki kişi aynı sorunu yaşadım.
Ancak, eğitim deneyiminiz tamamen sorunsuz geçtiyse (ve umarız öyleydi!), işte size nerede yer alabileceğinize dair bazı fikirler becerileriniz ve ilgi alanlarınız.
Python programlama
Evrak Çantası
Açıkça tanımlanmış bir sorunu olan bir araca katkıda bulunmak istiyorsanız
ancak hataların giderilmesi ve özelliklerin eklenmesi gerekiyor,
[Evrak Çantası] (https://github.com/beeware/briefcase) için proje olabilir
sen. Briefcase, bir Python projesini bağımsız bir proje olarak paketlemek için bir araçtır.
GUI uygulaması. Bir pyproject.toml
yapılandırma dosyası alır ve
yükleyiciler veya dağıtılabilir dosyalar oluşturmak için bu yapılandırma verilerini kullanır.
uygulama paketleri.
Evrak Çantası sayı tracker bir koleksiyona sahiptir çok sayıda özellik önerisi (ve daha az sayıda hata). Eğer bu sizin ilk kez katkıda bulunuyorsanız, iyi] etiketli biletlerden birini arayın. önce issue - Bunlar, ilk kez karşılaşacaklar için özel olarak seçilmiş konulardır. katkıda bulunanlar için nispeten kolay olmalıdır. uygulayın. Biletleri filtrelemeyi de yararlı bulabilirsiniz Geliştirme için kullandığınız platform - düzeltmek zor olacaktır Test için kullanabileceğiniz bir Linux makineniz yoksa bir Linux hatası!
Belirli bir projeye katkıda bulunmak istiyorsanız, şunları da yapabilirsiniz Bu bağlantıları kullanarak belirli projelere göre iyi ilk sayıları filtreleyin:
Bir bilet seçin, sorunu incelediğinize dair bir yorum bırakın ve bir düzeltme uygulayan bir çekme isteği geliştirmeye çalışın!
GUI programlama
Yerel bir widget kütüphanesi ile deneyiminiz varsa - macOS'ta Cocoa, Linux üzerinde GTK+, Windows Forms veya yerel iOS veya Android kütüphaneleri, Toga] (https://github.com/beeware/toga) konusunda yardımcı olabilirsiniz. Toga, platformlar arası bir widget araç setidir - ortak bir arayüz sağlar düğmeler ve ağaçlar gibi kullanıcı arayüzü öğeleri için.
Toga'nın halihazırda tanımlanmış bir dizi arayüzü vardır; ancak Bu arayüzlerin uygulanması tüm platformlarda tamamlanmamıştır. Bir widget seçin ve seçtiğiniz platform için bu widget'ı uygulayın!
Yerel bir widget kütüphanesi bilmiyor olsanız bile Toga'ya yardım etmek için. Yeni widget'lar yazmak çok daha az karmaşıktır görünebilir. Her platformun kendi yerel platformlarını nasıl kullanacaklarına dair belgeleri vardır. API'leri ve bu platform dokümantasyonunu başka bir dil (örneğin Objective C veya C#) nispeten basit bir süreç. Mevcut kod size bazı ipuçları verecektir BeeWare ekibi bunun nasıl yapılabileceği konusunda size yardımcı olmaktan mutluluk duyacaktır. ihtiyacım var. BeeWare Discord]'a (/bee/chat/) girin ve ne isterseniz yapalım yardım edebiliriz!
Kodu bir dilden diğerine dönüştürmek istemiyorsanız - her zaman test paketi vardır. Toga'nın çekirdek kütüphanesinde ayrıca bir test paketi, ancak bu test paketinin kapsamı çok iyi değil. Bir tane seç widget arayüzü ve bunun için bir test yazıp yazamayacağınıza bakın!
Dokümantasyon
Başarılı bir proje için iyi bir dokümantasyon şarttır. Biliyoruz ki Toga ve Evrak Çantası] (https://github.com/beeware/briefcase) her ikisi de önemli dokümantasyonlarında iyileştirmeler. Eğitimi tamamladınız; şimdi Toga için belgelere bir göz atın ve [Evrak Çantası] (https://briefcase.readthedocs.io) ve bir eğitimleri, referansları ve konu kılavuzlarını geliştirmenin bir yolu Orada.
Öğreticiler
Katkıda bulunmanın en iyi yollarından biri, tanıtım ve pazarlama faaliyetlerimizin öğretici dokümantasyon kaya gibi sağlamdır. İlginizi çeken bir proje seçin BeeWare paketini açın ve başlangıç kılavuzunu takip etmeye çalışın ve öğretici. Eğer başlangıç kılavuzunu bulamıyorsanız - o zaman bu rapor edilecek ilk şey!
Eğitim boyunca çalışırken, aşağıdakileri içermeyen her şeyi not alın mantıklı gelmiyor ya da çalışmıyor. Ardından bu sorunlar için bir hata raporu açın.
Windows
Eğer bir Windows kullanıcısıysanız, BeeWare kesinlikle yardımınızı kullanabilir. Bu çekirdek ekibinin tamamı günlük geliştirme çalışmalarında Linux ve macOS kullanıyor ve Sonuç olarak, Windows uyumsuzluklarının araya girmesi gerçekten kolaydır. Bu neredeyse her zaman bir dikkatsizlikten kaynaklanır. Tanımlama - ve hatta belki BeeWare araçlarının Windows üzerinde çalıştırılmasıyla ilgili sorunların giderilmesi muazzam bir Yardım edin.
Diller
İngilizce dışında bir dil konuşuyor musunuz? Şu anda çekirdek ekip hepsi ana dili İngilizce olan kişilerdir. Çevirilerinin sağlanması dokümantasyon veya tamamen yeni öğreticiler veya kılavuzlar dili katkıda bulunmak için harika bir yoldur. Zaten sahip olan bir proje seçin belgelerini inceleyin ve bu metni tercüme edin. Alternatif olarak, sıfırdan başlayın ve tamamen yeni bir öğretici yazın.
Latince olmayan karakter setine sahip bir dil konuşuyorsanız (örn. Rusça veya Çince) veya sağdan sola yazıya sahip bir dil (örneğin, İbranice veya Arapça) varsaydığımız tüm yerleri gösterebileceksiniz basit ASCII kodlaması veya soldan sağa kurallar. Herhangi birini seçin aktif BeeWare projeleri ile birlikte kullanmayı deneyin. Dil. Herhangi bir sorunla karşılaşırsanız, bu sorunları hata olarak bildirin; eğer özellikle maceraperest hissediyorsanız, nasıl yapacağınızı bulmaya çalışın *Hatayı da düzeltin.
Pratik kullanım
Eksikliklerimizin nerede olduğunu belirlememizin en iyi yollarından biri - her iki alanda da dokümantasyon ve API'ler - insanların BeeWare'i gerçekten kullanarak bir şey. Eğer şu ana kadarki fikirlerden hiçbiri ilginç gelmediyse, neden olmasın Kendinize ait bir şey mi denemek istiyorsunuz? Bu uygulamayı oluşturmak için BeeWare paketini kullanın Her zaman istediğiniz - bir veri kaynağının masaüstü görselleştirmesi veya faaliyetlerinizi takip etmek için mobil uygulama - her ne olursa olsun inşa et.
Sorunlarla karşılaşacağınızı neredeyse garanti edebiliriz. BeeWare hala bir çok genç bir proje. Ama karşılaştığınız sorunlar bize büyük bir Neyin ele alınması gerektiğinin göstergesi. Hangi widget'ları kullanacağımızı gösterecek ve hangi dokümantasyonun iyileştirilmesi gerektiği. Yani, vurduğunuz gibi Kendi uygulamanızı oluştururken sorun yaşıyorsanız, BeeWare projeleriyle ilgili sorunları günlüğe kaydedin sorunlara neden olan. Bu, neye ihtiyacımız olduğunu belirlememizi sağlayacaktır geliştirmeniz için bir ilham kaynağı bile olabilir. katkıda bulunun!