V tomto tutoriálu probereme, co je to Příze , jak nainstalovat správce balíčků Yarn v Linuxu a nakonec se podíváme na základní použití Yarn.
Úvod do příze
Příze, znamená Y et A další R zdroj N avigator, je moderní správce balíčků pro instalaci a správu programů JavaScript v operačních systémech Linux, macOS a Windows.
Yarn je rychlý, bezpečný a spolehlivý správce balíků. Příze je plně kompatibilní s npm registry
a může pracovat společně s npm
správce balíčků.
Dělá vše současně, aby maximalizovalo využití zdrojů a ukládá do mezipaměti všechny stažené balíčky. Není tedy nutné stahovat stejný balíček znovu a znovu. Příze je také bezpečná z hlediska návrhu, protože před instalací využívá kontrolní součty k zajištění integrity každého balíku.
Ve výchozím nastavení Yarn podporuje Node . Podporu můžete také rozšířit na další programovací jazyky pomocí pluginů. I když je použití příkazu Yarn podobné jako u Npm, má několik dalších příkazů. Například má "yarn why"
příkaz, který vám řekne, proč je určitý balíček nainstalován.
Yarn původně vyvinul Facebook, aby řešil a opravoval problémy s výkonem a bezpečností s npm. Nyní je Yarn nezávislý projekt s otevřeným zdrojovým kódem navázaný ani na Facebook, ani na žádnou jinou společnost.
Nainstalujte správce balíčků Yarn v systému Linux
Yarn je k dispozici ve výchozích úložištích mnoha mých distribucí Linuxu. Oficiálně doporučeným způsobem instalace Yarn je však použití Npm , správce balíčků Nodejs.
Npm bude standardně nainstalován s instalací Nodejs. Chcete-li Nodejs na Linuxu, podívejte se do následujícího průvodce:
- Jak nainstalovat NodeJS na Linux
Po instalaci Nodejs použijte npm k instalaci Yarn na váš počítač se systémem Linux:
$ npm install -g yarn
Zkontrolujte nainstalovanou verzi příze:
$ yarn --version
1.22.10
Jak můžete vidět ve výše uvedeném výstupu, nainstalovaná verze příze je 1.22.10 .
Upgradujte Yarn 1.x na Yarn 2
Vývojáři Yarn doporučují migrovat z verze Yarn 1.x na verzi 2.x, abyste získali rychlý a stabilní zážitek z Yarn.
Chcete-li migrovat Yarn 1.x na Yarn 2, přejděte do složky projektu a spusťte následující příkaz pro upgrade na verzi Yarn 2:
$ yarn set version berry
Tady berry
je kódové označení verze vydání Yarn 2. Verzi můžete zkontrolovat pomocí příkazu:
$ yarn --version 2.4.1
Pro trvalou aktualizaci verze Yarn 1.x na verzi Yarn 2.x můžete také použít následující příkaz:
$ yarn set version latest
Zkontrolujte, zda je příze úspěšně upgradována nebo zda nepoužívá příkaz:
$ yarn --version
2.4.1
Skvělý! Příze byla migrována do verze 2.x. V době psaní této příručky byla nejnovější verze Yarn 2.4.1 .
Začínáme s Yarn
Nainstalovali jsme Yarn a upgradovali na nejnovější verzi. Nyní se naučíme několik základních příkazů příze.
1. Zobrazit sekci nápovědy
Chcete-li zobrazit seznam dostupných příkazů Příze, přejděte k části nápovědy Příze spuštěním následujícího příkazu:
$ yarn help
Tento příkaz zobrazí seznam všech příkazů Yarn včetně jejich možností/příznaků spolu s malým popisem každého příkazu. Můžete také zobrazit sekci nápovědy libovolného dílčího příkazu, jako je níže:
$ yarn add -h
Nebo,
$ yarn add --help
Sekce nápovědy Příze na mě opravdu udělala dojem. Sekce nápovědy každého dílčího příkazu Yarn je přehledně napsána s ukázkovými příkazy. Nápověda ke všem příkazům je velmi podrobná a všechny možnosti jsou důkladně vysvětleny. Předpokládám, že nepotřebujete žádnou online dokumentaci. Vše lze získat offline.
2. Zahájit nový projekt
Spusťte následující příkaz ke spuštění nového projektu:
$ yarn init
Tento příkaz vytvoří nový projekt se jménem aktuálního uživatele.
Ukázkový výstup:
{ name: 'ostechnix' }
3. Instalovat závislosti
Chcete-li nainstalovat všechny potřebné závislosti pro náš nový projekt, spusťte:
$ yarn
Nebo,
$ yarn install
4. Nainstalujte balíčky
Můžeme nainstalovat další balíčky nebo závislosti pomocí yarn add
příkaz. Existuje několik způsobů, jak přidat nový balíček pomocí příkazu yarn.
Chcete-li přidat běžný balíček, například lodash
, do aktuálního pracovního prostoru, spusťte:
$ yarn add lodash
Konkrétní verzi balíčku můžete přidat do aktuálního pracovního prostoru příkazem:
$ yarn add [email protected]
Můžete také přidat balíček z hlavní větve úložiště GitHub do aktuálního pracovního prostoru pomocí adresy URL:
$ yarn add [email protected]://github.com/lodash/lodash
Nebo pomocí protokolu GitHub, jak je uvedeno níže:
$ yarn add [email protected]/lodash
Pokud chcete přidat jinou kategorii závislostí, použijte --dev
příznak pro přidání závislostí pro vývojáře a --peer
přidat vzájemné závislosti.
$ yarn add lodash --dev
$ yarn add lodash --peer
Jak jsem již řekl, část nápovědy dílčího příkazu Yarn můžeme zobrazit pomocí -h/--help
příznak:
$ yarn add -h
5. Upgradovat balíčky
Chcete-li upgradovat balíček pomocí Yarn, spusťte:
$ yarn up lodash
6. Zobrazit informace o balíčku
Chcete-li zobrazit informace související s balíkem, spusťte:
$ yarn info lodash
└─ [email protected]:4.17.21
└─ Version: 4.17.21
Pokud chcete zobrazit všechny dostupné informace o balíku používajícím přízi, příkaz by byl:
$ yarn npm info lodash
7. Spusťte příkaz shell
Můžeme provést příkaz shellu pomocí yarn exec
příkaz.
Ukažme například text Hello World s přízí, jak je uvedeno níže:
$ yarn exec echo Hello World
Hello World
Zobrazit verzi jádra Linuxu pomocí příkazu Yarn:
$ yarn exec uname -mrs
Linux 5.4.0-72-generic x86_64
8. Zobrazte, proč je balíček nainstalován
To je jedna z jedinečných vlastností příze. Yarn může zobrazit důvod, proč je balíček nainstalován.
$ yarn why lodash
9. Zobrazit pracovní prostory
Další pozoruhodnou funkcí Yarn je Workspaces. Workspace umožňuje uživatelům instalovat závislosti z více package.json
soubory v podsložkách jednoho kořenového adresáře package.json
soubor, vše najednou.
Chcete-li vytisknout všechny dostupné pracovní prostory, spusťte:
$ yarn workspaces list
10. Zobrazit aktuální nastavení konfigurace
Chcete-li vytisknout aktuální nastavení aktivní konfigurace, spusťte:
$ yarn config
11. Zobrazit pluginy
Chcete-li vytisknout pluginy dostupné přímo z úložiště Yarn, spusťte:
$ yarn plugin list
Výše uvedený příkaz zobrazí všechny dostupné oficiální pluginy. Pokud chcete zobrazit pouze aktuálně aktivní pluginy, spusťte:
$ yarn plugin runtime
12. Stáhněte si pluginy
Můžeme si stáhnout a aktivovat pluginy z oficiálního úložiště Yarn nebo z místních úložišť nebo úložišť třetích stran. Pokud přidáváte plugin z úložiště třetí strany, zadejte adresu URL pluginu. Pokud přidáte plugin z místního systému, jednoduše zadejte jeho cestu.
Chcete-li stáhnout a aktivovat plugin, například plugin-version
, z úložiště Yarn, spusťte:
$ yarn plugin import @yarnpkg/plugin-version
13. Odebrat pluginy
Chcete-li odebrat plugin importovaný z úložiště Yarn, spusťte:
$ yarn plugin remove @yarnpkg/plugin-stage
Pokud jste jej importovali z místního systému, jednoduše uveďte jeho název.
14. Odebrat balíčky
Chcete-li odinstalovat balíček pomocí Yarn, spusťte:
$ yarn remove lodash
15. Odebrat mezipaměť
Chcete-li odstranit všechny místní archivy, spusťte:
$ yarn cache clean
Můžete také odstranit všechny archivy uložené v ~/.yarn
adresář pomocí příkazu:
$ yarn cache clean --mirror
To stačí k tomu, abyste mohli začít se správcem balíčků Yarn. K dispozici je však mnoho příkazů. Nechám je na vás, abyste se je naučili a vyzkoušeli. Úplný seznam příkazů Yarn můžete zobrazit pomocí yarn --help
příkaz. Pokud neznáte použití konkrétního dílčího příkazu, stačí spustit "yarn sub-command -h"
vyvolat sekci nápovědy k tomuto konkrétnímu příkazu.