Jak napsat doplněk pro VS Code a publikovat ho na Marketplace

Na konferenci Microsoft Connect(); 2015 byl oznámen přerod Visual Studio Code (VSCode) na status Beta. VS Code je programátorský editor vhodný pro tvorbu a ladění moderních, zejména webových aplikací, a je dostupný zdarma na Linuxu, OS X i Windows.

Beta nám přinesla mnoho novinek, z nichž nejzásadnější je tvorba doplňků. A teď je řada na nás, vývojářích, abychom si začali upravovat VS Code k obrazu svému a pomáhali také ostatním vývojářům. Proto vám v tomto článku ukáži, jak jednoduché je vytvořit doplněk pro VS Code a přivést tak pár dalších nadšenců k zlepšování zajímavého nástroje jako je VS Code.

Již vytvořené doplňky i s jejich kódy hostovanými na GitHubu můžeme najít zde.

Generátor

Náš první krok bude instalace Node.js. Pro vygenerování našeho doplňku použijeme Yeoman generátor. Ten, společně s doplňkem od VS Code nainstalujeme a spustíme tímto příkazem:

npm install -g yo generator-code

yo code

Při tvorbě doplňku máte na výběr z dvou jazyků, TypeScriptu nebo JavaScriptu. Poté postupujte dle pokynů. Po vygenerování otevřeme náš doplněk ve VS Code.

Klepněte pro větší obrázek

Struktura a nastavení

Soubor package.json obsahuje všechny informace o našem doplňku, tedy i jeho účel, jeho spuštění, popis atd. Zde můžeme například přidávat také Node moduly které chceme využívat. Také obsahuje informace do Marketplace.

README.md je soubor, který obsahuje informace o popisu, které se propisují do našeho Git repositáře i do VS Marketplace.

Extension.ts ve složce src je náš kód (pokud programuje v JavaScriptu je to extension.js). Všechnu logiku našeho kódu začneme v tomto souboru.

Tvorba

Nejdříve musíme nastavit, jak náš doplněk aktivovat, a to v package.json. Takto se aktivuje náš doplněk při napsaní “Hello World” do lišty ve VS Code.

Klepněte pro větší obrázek

Pokud otevřete soubor Extension.ts a najdete “activate” funkci, tak tato funkce se aktivuje právě při parametrech, které jsme zadali, a zde už můžeme vytvářet logiku našeho doplňku. Můžeme využívat všechny standardní funkce a postupy, jaké jsme zvyklí v jiných projektech. Než se ale do kódování pustíte, doporučuji projít si API VS Code.

Testování a debugování

Pokud náš doplněk otevřete ve VS Code, tak si jej můžete ihned spustit, a to kliknutím na tlačítko debuggeru a následném spuštění. Otevře se nám separátní VS Code, ve kterém je náš doplněk, po vypnutí se doplněk smaže.

Pokud chcete náš doplněk debugovat, můžete využít nástrojů přímo ve VS Code.

Klepněte pro větší obrázek

Publikace

Pokud chcete doplněk poskytnout také ostatním vývojářům, tak musíte začít tím, že nainstalujete doplněk od Microsoftu, vsce.

npm install -g vsce

Dále budeme potřebovat MS Token. Nejdříve bude potřeba se zaregistrovat, https://www.visualstudio.com/en-us/get-started/setup/sign-up-for-visual-studio-online poté na stránce vašeho Visual Studia Online přejdete na stránku “My Profile”.

Klepněte pro větší obrázek

Přejděte na “Security” záložku a poté klikněte na “Add”.

Klepněte pro větší obrázek

Token si libovolně pojmenujeme, a nastavíme na 1 rok, poté nám expiruje a bude potřeba nový. Poté ho zkopírujeme.

Klepněte pro větší obrázek

V terminálu (nebo CMD) přejdeme do složky našeho doplňku a poté vyvoláme tento příkaz, který vytvoří nového vydavatele.

vsce create-publisher nazev

A přihlásíme se na něj.

vsce login nazev

Teď už stačí vyvolat jen příkaz “Publish” a náš doplněk je dostupný v Marketplace.

vsce publish

V tomto článku jsou použity informace z https://code.visualstudio.com/Docs a https://github.com/Microsoft/vscode.

Články ze série Microsoft TechNet nevytváří redakce Živě.cz, ale partneři programu Microsoft TechNet. Jsou publikovány v rámci mediálního partnerství Živě.cz a společnosti Microsoft.

Témata článku: Microsoft, Programování, Marketplace, Yo, Token, Generator

Určitě si přečtěte

Nové úlovky kamer Googlu: Šmírovačka na Street View nepřestává bavit

Nové úlovky kamer Googlu: Šmírovačka na Street View nepřestává bavit

Google stále fotí celý svět do své služby Street View. A novodobou zábavou je hledat v mapách Googlu vtipné záběry. Podívejte se na výběr nejlepších!

19.  5.  2017 | redakce | 39

To tu ještě nebylo. Specialisté ukázali, že zavirované mohou být i titulky SRT

To tu ještě nebylo. Specialisté ukázali, že zavirované mohou být i titulky SRT

** Stáhnete si film a titulky třeba z OpenSubtitles.org ** A osud vás za ten warez záhy potrestá ** Specialisté totiž ukázali, že i v titulcích může být schovaný virus

24.  5.  2017 | Jakub Čížek | 57

WannaCry se neměl vůbec rozšířit. Stačilo, abychom používali Windows Update

WannaCry se neměl vůbec rozšířit. Stačilo, abychom používali Windows Update

** WannaCry se masivně rozšířil kvůli zranitelnosti ve Windows ** Ta mu umožnila, aby se pokusil sám napadnout další počítače ** Jenže ta chyba už je dva měsíce opravená!

22.  5.  2017 | Jakub Čížek | 96

Nastal čas znovu vynalézt klávesnici. Anebo vám ta současná opravdu vyhovuje?

Nastal čas znovu vynalézt klávesnici. Anebo vám ta současná opravdu vyhovuje?

**Měli bychom provést revoluci klávesnice? ** Anebo je její dnes už hodně zastaralý koncept prostě nejlepší? ** Budeme na klávesnici odkázaní už navždy?

20.  5.  2017 | Jakub Čížek | 60


Aktuální číslo časopisu Computer

Bojujeme proti Fake News

Dva velké testy: fotoaparáty a NASy

Co musíte vědět o změně evropského roamingu

Radíme s výběrem základní desky