Hemmelere salam, JavaRush jemgyýeti! Özüm hakda azajyk: 2016-njy ýylyň ýazyndan bäri Java programma in Engineeneri bolup işleýärin. Bu ýere gelip, okuw wagtynda çözmedik meselelerimi çözmegi gowy görýärin. Bu gün size kitaphana - Surat deňeşdirmesi hakda gürrüň bererin . Bu GitHub -da köpçülige açyk çeşme kitaphanasy . Bu makalanyň maksady açyk çeşme önümini döretmek diňe wagt ýitirmek däl, ýok! Bu, ähli ösüş prosesine gözegçilik edeniňizde, her jikme-jiklikleri öwrenmeli bolanyňyzda, dürli tarapdan çekilen baý tejribe. Açyk çeşme töweregiňizdäki dünýädir. Degişmeýärin, bu kitaphananyň barlygynda ABŞ, Hindistan, Hytaý, Müsür, Russiýa, Germaniýa, Ukraina, Şwesiýa, Täze Zelandiýa, Norwegiýa ýaly dürli ýurtlardan adamlar bilen aragatnaşyk sakladym. Jointagny, bu bilelikdäki ösüş, ylalaşyk tapmak, kod barlamak we ş.m. Bu giriş, indi tertip bilen başlalyň:
Synag. 2017-nji ýylyň awgust aýynyň başy
Bularyň hemmesi ilkinji ädim synag meselesini ýazmak üçin kompaniýalaryň biri bilen söhbetdeşlik geçirendigimden başlandy. Wezipe birmeňzeş ululykdaky iki suraty deňeşdirip, arasyndaky tapawutlary tapyp, toparlara bölüp we töweregine gönüburçluk çyzjak kod ýazmakdy. Birinji surat bar:
Ikinji surat bar:
Tapawutlary tapmaly we aşakda görkezilişi ýaly tegeleklemeli boldy:
Görşüňiz ýaly, gyzyl üçburçluk bilen aýlanýan Ulanyjy ady meýdanynda tapawut bar. Işiň has jikme-jik beýany . Utandyrmazlygy üçin muny diňe bir funksional nukdaýnazardan dogry däl, owadan hem etmek isledim. Munuň üçin muny GitHub -da taslama hökmünde çap etmegi makul bildim . GitHub-ny öwrenmek we onuň bilen işlemek tejribesini köpden bäri isleýärin. Çalt gözden geçirenimden soň, koduň hilini seljermek, synaglar bilen kod örtügini döretmek we ş.m. üçin üçünji tarap hyzmatlaryny goşmagyň gowy boljakdygyna göz ýetirdim. Aşakdaky gurallar goşuldy:
Travis CI taslama gurýan, synaglary geçirýän we taslamanyň üstünlikli gurlandygyny ýa-da ýokdugyny aýdýan CI (üznüksiz integrasiýa) guraldyr. Mysal üçin, synaglaryň biri täze üýtgeşmeleriň netijesinde geçmedik bolsa, onda taslama gurluşygynyň şowsuz bolandygyny we gyzyl reňk berjekdigini aýdýar.
Coveralls, koduňyzyň göterimini synaglar bilen üpjün edýändigini görkezýän guraldyr.
“BetterCode Hub” koduň hilini seljermek üçin başga bir guraldyr. Diňe bir erbet zadyňy aýtman, eýsem sebäbini düşündirip, bu hakda bilim alyp boljak kitaba baglanyşyk berjek gaty peýdaly zat.
Bu hyzmatlaryň hersiniň kod örtügi taslamasy ýaly maglumatlar netijeleri bilen öz nyşany bar. Bu nyşany taslamanyň esasy düşündirişine - README faýlyna goşup bolýar. Wezipe taýýar - gözden geçirmek üçin iberdim. Gözden geçirilenden soň, derrew täze ýatlamadan her teswir üçin Github Issue döretdim , soň bolsa bu taslamany gowulaşdyrmaga kömek eder. Iş berijiden gowulaşdyrmak meselesi ýokdy, şonuň üçin taslamany biraz ýatdan çykardym ...
Kitaphana ýoly. Iýul 2018
Logotip
Bir gezek adamlar meniň taslamamy köplenç görýärler we bu her gün bolýar. Men muňa haýran galdym we bir ýyl töweregi wagtdan soň belli bir grafiki dizaýneriň öz taslamam üçin logotip döretmegi teklip edýändigi ýazylan MESELE döredilendigine hasam haýran galdym. "Opensource" önümleri üçin muny etmegi gowy görýändigini we düýbünden mugt etjekdigini aýdýarlar. Hyzmatdaşlyk edip başladyk. Birnäçe wariant teklip edildi, ýöne ahyrynda bu meseläni çözdük:
Men henizem ýaşdym we açyk jemgyýet bilen tanyş däldim, şeýle teklibiň hakykaty maňa ýabanydy we soradym, näme üçin beýle edýär? Oňa şeýle jogap berdi: "Lolz, diňe açyk çeşme taslamalaryna goşant goşmagy halaýaryn. Durmuş maksatly bir zat ..." ( meseläniň özi şu ýerde ). Dürli adamlar sizi açyk çeşme taslamalary arkaly tapyp, şeýle gyzykly zatlar hödürlänlerinde, nähili ajaýypdygyny ilkinji gezek duýdum!
Birinji tarapdaky kemçilik
Hytaýly belli bir işläp düzüjiniň meniň üçin bir mesele döredendigini gördüm , onda kitaphananyň işinde kemçilik tapandygyny, uly suratlary ulansaň, StackOverflowError alýandygyny aýtdy . Ol adam peýdalanmak kararyna geldi we ýalňyşlyk tapdy. Men ony tapmadym. hakda-da ýazypdyr. Bu kitaphananyň ösüşinde täze ädimdir. Mundan başga-da, hakykatdanam çözgüt tapmadym. Belli bir wagtda Russiýadan synagçylaryň biri çözgüt teklip etdi. Itöne çigdi we dogry ýasalmady we men kabul etmedim. Maven Merkezi kitaphanasyny neşir etmegiň wagty gelende, bu kemçilik bilen bir zady çözmeli boldy; men onuň bilen bilelikde neşir etmek islemedim. Mundan başga-da, hiç haçan düzedip bilmedik başga bir kemçiligim bardy we bu hem köp oňaýsyzlyk getirdi.
Buýruk setiriniň ulanylyşy. Güýz 2018
Ösüşiň indiki basgançagy, buýruk setiri arkaly kitaphanany ulanmak isleýän şwesiýaly (Renato Athaýdes) bilen aragatnaşyk boldy we munuň üçin käbir üýtgeşmeler we goşmaçalar girizmek zerur boldy. Men muňa ýene haýran galdym we geň galdym. Grafiki dizaýner maňa ýazandan soň, meniň geň galmagym birneme azdy, ýöne şonda-da gaty ýokarydy. Kimdir biri meniň kodyma hakykatdanam mätäç diýen pikir meni ajaýyp duýgular bilen doldurdy. Zerur üýtgeşmeler girizdi we kod taýýarlady. Kod gözden geçirdim, ýagny üýtgeşmelere göz aýladym, üýtgedilen teswirler bardy we üýtgeşmeler eýýäm kitaphanada bardy. Bu üýtgeşmeleri v2.0 wersiýasy diýip belledim . Indiki ädim kitaphanany Maven Central - merkezi ammarda goşmakdy, ony islendik taslama üçin göçürip alyp bilersiňiz we garaşlylyk hökmünde ulanyp bilersiňiz. Şol wagt muny nädip etmelidigimi hem bilmeýärdim, şonuň üçinem iş bilen meşgullandygymy aýtdym we taslamany gurmak üçin zerur bolan ähli ädimleri ýerine ýetirmegini haýyş etdim. Thisöne bu asla ýeterlik däldi we iň gyzyklysy Maven Central bilen baglanyşyk gurmakdy. Bu ýabany agyry, ilkinji gezek edip bilmedim we diňe 15-nji aprelde taslamany Maven Central-da çap edip bildim. Bu aňsat däldi, ýöne beýlekileriň aýdyşy ýaly "Java koduny çap etmek isleýänleriň hemmesi başdan geçirýär". Kitaphanany çap etmezden ozal, uzak wagt bäri dowam edip gelýän kemçilikleri näme we nädip etmelidigini tapdym we täze v2.0.2 wersiýasyny çykardym , onda maňa kömek edenleriň hemmesine minnetdarlyk bildirdim, näme we nädip edendigimi düşündirdim. .
Maven Central-a neşir etmek. Bahar 2019
Kitaphanany dogry neşir etmek üçin wersiýa we wersiýalary nädip dogry sazlamalydygyna gowy düşünmeli. Men bu shema ýapyşaryn:
XX.YY. _ _ _
YY ownuk täzelenme - BBBB nämedigini üýtgetmeýän içerki üýtgeşiklik ýa-da giňeltmek - bu düzedilen kemçilikler.
Mysal üçin, 2.0.2 wersiýasy esasy wersiýanyň 2 bolandygyny, ownuk täzelenmeleriň bolmandygyny we kemçilikler üçin iki täzelenmäniň bardygyny aňladýar.
Ondan soň, groupId we artifactId-i nädip dogry düzmelidigini anyklamak möhümdi . Olary bir gezek saýlamaly we mundan beýläk ulanmalydy. Kod saklanýan bukjany düzýärler. Boldy: ua.comparison.image Indi: com.github.romankh3.image.comparison We bu has gowy, sebäbi munuň GitHub-dan taslamadygyny we romankh3 lakamly adamdan tapyp boljakdygyny her kim bilýär. Bularyň hemmesini edenimden soň, v2.1.0 täze wersiýasyny çykardym .
Şwesiýalylar bilen aragatnaşyk. Maý 2019
Kitaphanany çap edenimden soň, başga bir şwesiýaly (Mika Kytöläinen) maňa e-poçta iberdi we dostundan kitaphanamda üýtgeşmeler girizmegini haýyş etdi. Oňa hakykatdanam mätäçdigini we muny çalt ýerine ýetirsek gaty begenjekdigini aýdýar. Elbetde, zerur üýtgeşmelere garşy däldim. Gönüburçlugy çyzýan çyzyk galyňlygy konfigurasiýasyny goşmagy teklip etdi. Görüşi pes bolanlar üçin bu peýdaly üýtgeşme bolar. Kod taýýarlady . Moreene birnäçe üýtgeşme goşup, v2.2.0 wersiýasyny çykardym
Bir nemes bilen aragatnaşyk. Maý 2019
Ondan soň bir nemes ony synag üçin ulanmak isleýändigini, ýöne işlemeýändigini aýdýan bir mesele döretdi. Örän gyzykly köp teklip etdi, deňeşdirmegiň netijesinde diňe alnan suraty yzyna gaýtarmagyň ýerine, maglumatlar toplumyny yzyna gaýtarmagy teklip etdi: deňeşdirilen zat, netije (zerur bolsa) we şol ýerdäki ýagdaý MATCH, MISMATCH, SIZE_MISMATCH bolar. Hatda üýtgeşmeler girizdi. Emma öňki kody asla göz öňünde tutmadylar we howlukmaç edildi. Men olary ret etdim we isleýşim ýaly ýerine ýetirmegi teklip etdim. Muňa garamazdan, ol has köp jogap berdi we men muny özüm edip, täze wersiýasyny çykarmak kararyna geldim. Şol bir wagtyň özünde Mika Kytöläinen başga bir gyzykly funksiýany teklip etdi - deňeşdirmä goşulmajak ýerleri goşdy. Bu hakyky waka. Bularyň hemmesi v3.0.0 -da çykdy
Hakyky taslamada ulanyň
Maý aýynyň ahyrynda Kiýewden awtomatlaşdyryjy synagçy maňa hat ýazdy, kitaphana bilen gyzyklandy we ony pul getirýän hakyky taslamada ulanmak isledi. Bu üstünlik boldy! Haýwanlaryň haýsydyr bir taslamasynda bir ýerde ulanmak bir zat, ýöne hakyky taslamada ulanmak düýbünden başga mesele. Nämäniň we nähili işleýändigini ara alyp maslahatlaşdyk. Programma gaty gyzykly: olaryň programmasynda çap edilen çekler bar we çekleriň belli bir şablona laýyklykda döredilendigini we üýtgemeýändigini barlamak zerur boldy. Emma sene we wagt ýaly bölümleriň hemişe üýtgäp, ünsden düşürilmeli bir meselesi bardy. Käbir ugurlary äsgermezlik etmek üçin eýýäm funksiýa goşduk, ýöne hakyky ulanmak üçin henizem çig bolup çykdy we bu meselede birnäçe hepde bilelikde bilelikde işledik. Netijede v3.1.1 wersiýasynyň çykmagy boldy
Nik tapmak
Şondan soň, kitaphanam üçin hakyky ýeriň synaglarda ulanylýandygyna düşündim. Munuň üçin synagçylar üçin haýsydyr bir forum tapmagy we käbir pikirleri almak we şöhraty artdyrmak üçin olara bu hakda ýazmagy makul bildim. Rus dilindäki forum tapdym we ol ýerde bir makala çap etdim: Synag şekillerini guramak - meňzeş iki sany deňeşdirme . Onda kody we işleýşi barada hakyky seslenme aldym, ulanyp, täze v3.2.0 wersiýasyny , soň bolsa v.3.3.0 çykardym .
Indi
Kitaphanada häzirki wagtda Github-da 60 ýyldyz bar we 33 çeňňek bar. Awtomatlar üçin forumdaky makaladan başga hiç hili mahabatlandyrmaýandygymy göz öňünde tutup, bu gaty gowy zat diýip pikir edýärin. Ahyryna çenli okanlara sag bolsun aýdýaryn. Aslynda meniň garaşyşymdan has uzyn makala boldy. Maven Central-a kitaphanany nädip neşir etmelidigi barada makala. Goşjak zadyňyz bar bolsa ýazyň! Kitaphanany gowulandyrjak bir zadyňyz bar bolsa ýazyň! Men hemme zady okaryn we oňa wagt sarp ederin. Makalany halaýan we peýdaly hasap eden her bir adam - baha beriň we teswirlerde ýazyň. Şeýle hem, github hasabyma romankh3 ýazylyň. Beýleki makalalarymy hem görüň:
GO TO FULL VERSION