streamalism.org

1. Prehľad

Nahliadnutie do zdrojového kódu a dokumentácie rôznych knižníc a rámcov je dobrý spôsob, ako sa o nich dozvedieť viac.

V tomto krátkom tutoriáli sa dozvieme, ako nakonfigurovať Maven, alebo ako požiadať Maven, aby nám sťahoval zdroje závislostí a ich Javadocs.

2. Príkazový riadok

Maven predvolene sťahuje iba skutočný súbor JAR každej závislosti, nie súbory zdrojov a dokumentácie.

Ak chcete stiahnuť iba zdroje, najskôr by sme mali prejdite do adresára obsahujúceho pom.xml a potom vykonajte príkaz:

závislosť mvn: zdroje

Stiahnutie zdrojov môže chvíľu trvať. Podobne na stiahnutie iba Javadocs môžeme vydať príkaz:

závislosť mvn: resolve -Dclassifier = javadoc

Samozrejme si ich môžeme stiahnuť aj jedným príkazom:

závislosť mvn: závislosť zdrojov: vyriešiť -Dclassifier = javadoc

Je zrejmé, že ak po vydaní týchto príkazov pridáme novú závislosť, musíme znova vydať príkazy na stiahnutie zdrojov a Javadocs pre novú závislosť.

3. Nastavenia Maven

Je tiež možné stiahnuť zdroje a dokumentáciu v celom systéme pre všetky projekty Maven. Aby sme to dosiahli, mali by sme upraviť ~ / m2 / settings.xml súbor alebo ho vytvorte a pridajte do neho nasledujúcu konfiguráciu:

    skutočné zdroje na stiahnutie 

Ako je uvedené vyššie, vytvárame profil a predvolene ho aktivujeme. V tomto profile nastavujeme dve vlastnosti, ktoré hovoria Mavenovi, aby sťahoval zdroje a dokumentáciu. Maven navyše použije tieto nastavenia na všetky projekty.

4. The pom.xml

Je dokonca možné vložiť túto konfiguráciu do pom.xml. Týmto spôsobom prinútime všetkých prispievateľov do projektu, aby si v rámci riešenia závislostí stiahli zdroje a dokumentáciu:

   org.apache.maven.plugins zdroje maven-dependency-plugin 3.1.2 vyriešiť javadoc 

Tu konfigurujeme maven-dependency-plugin na stiahnutie zdrojov a dokumentácie.

5. Nastavenie IDE

Môžeme tiež nastaviť naše obľúbené IDE, ktoré to urobia za nás. Napríklad v IntelliJ IDEA musíme ísť na Predvoľba> Zostavenie, spustenie, nasadenie> Nástroje na zostavenie> Maven> import a začiarknite políčka zdroje a dokumentácia:

6. Záver

V tomto rýchlom výučbe sme videli, ako sťahovať zdroje závislostí a dokumentáciu v Mavene rôznymi spôsobmi, od riešení príkazového riadku po konfigurácie podľa projektu alebo celého systému.