Sfat rapid Configurarea textului sublim 2 pentru codarea darts

Sublime Text 2 este un editor de text puternic, popular datorită disponibilității sale cross-platform și capabilității sale de a utiliza funcțiile TextMate preexistente. Combină textul Sublime 2 cu noua limbă Dart a companiei Google, iar coderii de putere pot fi foarte fericiți.


Actualizați: Ghidul video nou

Nota editorului: Din moment ce acest articol a fost publicat pentru prima dată, a devenit depășit. Acum există un flux de lucru mult mai bun pentru utilizarea Dart în Sublime Text 2, pe care Timothy Armstrong explică în acest videoclip:


Articolul original este lăsat needitat mai jos.


Cerințe preliminare

Pentru ca aceasta să meargă repede, voi presupune că aveți cunoștințe fundamentale. Pentru acest sfat, ar trebui să cunoașteți următoarele:

  • O cunoaștere activă a pachetelor Text Sublim 2. Cea mai mare parte a acestui sfat se concentrează pe pașii necesari pentru a construi propriul nostru pachet Dart, dar dacă nu ați folosit niciodată un fragment înainte de a vă dori să creați copii de rezervă pentru o secundă și să aflați mai întâi mai multe despre textul Sublime.
  • O cunoaștere de lucru a Dart va ajuta, de asemenea. Nu vom codifica cu adevărat niciun Dart în acest sfat, dar având câteva fișiere Dart în jurul cărora să încercați lucrurile vă va ajuta foarte mult.
  • Vom verifica codul dintr-un depozit Subversion și în timp ce vă voi alimenta comanda de utilizat, sperăm că nu este prima dată când utilizați Subversion.
  • În sfârșit, este în ordine o cunoaștere generală a sistemului dvs. de operare. Va trebui să facem o mică configurație și dacă sunteți confortabil, să spuneți, modificați o .bash_profile fișier prin Terminal, atunci veți fi bine.

Dacă aveți nevoie de un material de lectură prealabilă, vă refer la următoarele:

  • Documentația Sublime Text 2 (oricât de neoficială) este păstrată la sublimetext.info/docs. Paginile de pe Pachete, Definiții de sintaxă și Fragmente au fost deosebit de utile în scrierea acestui sfat.
  • Informațiile despre darts pot fi găsite pe site-ul oficial sau urmând de-a lungul tutorialului introducerii Activetuts 'Dart
  • S-au scris multe despre Subversion, ca să nu mai vorbim de o carte online completă. Este un pic mai mult decât aveți nevoie, deoarece pur și simplu trebuie să aveți instalat Subversion și să efectuați un singur dosar
  • Google va fi prietenul tău când vine vorba să afli mai multe despre configurarea sistemului tău.

Pasul 1: Instalați Editorul Dart

Nu vom folosi cu adevărat editorul Dart (punctul de vedere al acestui tutorial este de a utiliza Sublime Text for Dart development, la urma urmei), dar descărcarea include Dart SDK, ceea ce este cu adevărat ceea ce facem. Chiar dacă sunteți un hardcore Sublime Text 2 fanatic, nu este încă o idee teribilă de a avea "oficial" Editorul Dart instalat și la îndemână.

Pe site-ul oficial Dart, puteți descărca Dart Editor de la următorul link:

http://www.dartlang.org/docs/getting-started/editor/

Sub "Pasul 1" al acelei pagini, veți găsi un link către un fișier ZIP care conține Editorii Dart. Este de aproximativ 70-100 MB, în funcție de sistemul dvs. de operare, deci nu este o descărcare teribil de greu. Dar începeți!

Editorul Dart se bazează pe Eclipse, deci dacă ați folosit că veți fi acasă cu Editorul Dart. Nu voi primi detalii despre folosirea lui în acest tutorial, dar nu ezitați să jucați cu el. Tutorialul introductiv Activetuts + Dart (disponibil în mod curent prin Facebook) vă oferă prin utilizarea de bază a editorului Dart.

Rețineți că, dacă nu doriți să instalați Editorul Dart, puteți descărca doar SDK-ul închis pentru sistemul dvs. de operare la această adresă URL (sunt doar 2 sau 3 MB):

http://www.dartlang.org/docs/getting-started/sdk/index.html


Pasul 2: Dacă aveți Linux pe 64 de biți

daca tu nu face aveți o instalare Linux pe 64 de biți, puteți trece peste acest pas. (Da, care vă include pe dvs., utilizatorii Windows și Mac, derulați în jos pentru instrucțiunile dvs.)

daca tu sunteți pe o instalare Linux pe 64 de biți, va trebui să instalați o bibliotecă pe 32 de biți pentru a rula compilatorul Dart, chiar dacă ați descărcat Dart Editor pe 64 de biți. Eu nu sunt un guru Linux de orice întindere, dar acest lucru a lucrat pentru mine, la instalarea mea Ubuntu 11.

Mergeți la Centrul de Software și căutați "lib32stdc ++ 6" sau "Biblioteca Standard C ++ GNU 32 bit". Instalați-l. Puteți continua cu următorii pași în timp ce se instalează - asigurați-vă că această bibliotecă a fost instalată cu succes înainte de a încerca să executați sistemul de construire.


Pasul 3: Descărcați fișierul lingvistic Dart TextMate Google

Fișierul de limbă TextMate este găzduit aici pe Google Code (vizualizare bazată pe web în depozit).

Aceasta este de fapt parte dintr-un pachet TextMate mai mare (dar nu atât de mare), dar suntem interesați doar de gramatica limbajului.

Înainte de a lua acest fișier, creați o locație pentru ca acesta să trăiască în sistemul dvs. Va trebui să creați un folder numit Lance în următoarea locație, în funcție de sistemul dvs. de operare:

  • Mac OS: ~ / Bibliotecă / Suport pentru aplicații / Sublime Text 2 / Pachete / Dart
  • Windows 7: C: \ Users \ Administrator \ AppData \ Roaming \ Sublime Text 2 \ Pachete \ Dart
  • Linux: ~ / .Config / sublimă-text-2 / Pachete / Dart

Apoi, deschideți interfața liniei de comandă și navigați în interiorul acelui nou creat Lance pliant.

Subversiunea nu facilitează verificarea unui singur fișier, dar putem exporta un singur fișier. Introduceți această comandă:

 svn export http://dart.googlecode.com/svn/branches/bleeding_edge/dart/tools/utils/textmate/Dart.tmbundle/Syntaxes/Dart.tmLanguage

După un moment ar trebui să aveți Dart.tmLanguage fișier în dosarul Dart.

Continuați și încercați (este posibil să fie necesar să reporniți textul Sublime). Deschideți un fișier Dart și verificați sintaxa colorată:


Un fișier Dart simplu în textul Sublime 2, prezentând evidențierea sintaxei

Pasul 4: Localizați-vă frogc executabilă

frogc este compilatorul Dart-to-JavaScript. Este un instrument de linie de comandă, dar este din fericire ușor de utilizat. O vom folosi într-un sistem Sublime Build mai târziu pentru a transforma fișierele noastre Dart în JavaScript, așa că nici nu trebuie să le folosim pe linia de comandă oricum.

Pentru a face sistemul Build, avem nevoie de calea către noi frogc executabil. Acest lucru a fost descărcat cu Dart SDK (pe care l-ați descărcat fie cu Editorul Dart, fie singur). Va fi localizat la DART-sdk / bin / frogc. "dart-sdk" va fi oriunde ați descărcat și dezarhivat SDK-ul singur, sau imbricat chiar în interiorul lance care conține, de asemenea, aplicația Dart Editor, care va fi locul unde l-ați plasat.

Avem nevoie de o cale compatibilă cu linia de comandă la frogc. Pe Mac OS, puteți face acest lucru:

Deschideți o fereastră Terminal și trageți frogc în ea. Fereastra va conține textul căii fișierului pe care l-ați scos.

Pentru Windows:

Faceți clic pe bara de adrese a ferestrei. Ar trebui să se transforme într-o cale de text simplu pentru dosar, pe care apoi să o copiați. Va trebui să adăugați "\ frogc.bat" la sfârșit pentru a obține calea către frogc, nu doar folderul bin.

Dacă sunteți pe Linux, probabil că deja știți cum să faceți acest lucru.

Asigurați-vă că calea este absolută și disponibilă. Plasați-l în clipboard sau într-un fișier text pentru următoarea etapă.


Pasul 5: Creați un sistem Dart Build pentru a compila JavaScript

Pentru a face acest pachet de limbă într-adevăr util, ar trebui să creăm un sistem Build, care ne permite să rulam fișiere printr-o comandă de construire a shell-ului.

În Sublime Text, alegeți Instrumente> Sistem de construire> Sistem nou construit ... meniul. Veți primi un fișier nou cu următorul conținut implicit:

"cmd": ["face"]

Acesta este doar un obiect JSON care descrie o comandă de bază foarte construită. Vom adăuga mult mai mult la acest lucru pentru al face utile dezvoltării Dart.

Cu calea pe care ați determinat-o în ultima etapă, disponibilă, putem să ne editați sublimă-build fişier.

Dacă sunteți pe Mac sau Linux, schimbați conținutul fișierului la:

(\\ d +): (\\ d +): (\ "dc / dart / dart-sdk / bin / frogc" \ d +):. + \\ [0m (. +) $ "," selector ":" source.dart "

Cele de mai sus este ceea ce am pe sistemul meu Mac. Unde se spune / Aplicații / darts / darts-sdk / bin / frogc, adăugați-vă propria cale de frogc.

Dacă vă aflați pe Windows, fișierul va arăta mai degrabă similar, dar ar trebui să modificați "cmd"linia către:

 "cmd": ["cmd", "/ C", "C: \\ inserați calea aici \\ frogc.bat", "$ file"], "file_regex" : (\\ d +): (\\ d +):. + \\ [0m (. +) $ "," selector ":" source.dart "

Pentru a explica pe scurt ceea ce face, cmd proprietatea este, în principiu, doar ceea ce se execută pe linia de comandă. frogc este simplu de utilizat: trebuie doar să invocați comanda și să o încărcați cu un fișier. fișier $ o parte a acelei linii este o variabilă care se extinde automat la pagina fișierului curent.

Pe Windows, lucrurile sunt puțin mai funcționale în mod implicit (cel puțin în acest scenariu, asta nu este o sapă la Microsoft, jur!). Ceea ce avem vom rula linia de comandă Windows (cmd) cu parametrul "nu păstrați fereastra terminalului" (/ C, deși chiar și "păstrați fereastra terminalului" / K parametrul nu se afișează niciodată) și executați frogc.bat, trecând calea completă a fișierului. Aceasta este modalitatea rapidă de ao face să funcționeze, dar pare să genereze erori în construirea actuală. Aceasta este probabil o problemă temporară, deoarece la momentul acestei scrieri aceste erori sunt produse cu SDK standard și nu cu cel mai recent SDK. Consultați următorul pas pentru un traseu alternativ.

file_regex line este pentru raportarea erorilor. Dacă o linie din ieșirea comenzii se potrivește cu acest model de expresie regulată, este recunoscută ca o eroare și apăsând F4 le va evidenția în panoul de ieșire.

Din păcate, frogc folosește coduri de text-styling pentru a face ca anumite părți ale mesajului de eroare să aibă o culoare diferită și / sau boldă. Atunci când sunt transmise în text sublim, aceste coduri de stil sunt prezentate ca text obișnuit, astfel încât rezultatul poate fi puțin greu de citit, cu [0m și coduri asemănătoare păstrate între textul care poate fi citit de om. Nu știu deloc despre asta, din păcate.

Linia finală, selector, specifică domeniul de aplicare în care ar trebui să aibă loc acest sistem Build. Cu această setare source.dart, Darts ar trebui să aleagă automat acest sistem Build. Sublime Text 2 știe că un fișier ".dart" este un fișier Dart datorită gramaticii limbajului pe care l-am instalat.

Salvați acest fișier ca Dart-frogc.sublime-build în [Sublime Data] / Pachete / Utilizator / Dart /


Opțional, pasul Power-User pentru Windows

Pentru a evita erorile menționate mai sus pe Windows și, de asemenea, pentru a face sistemul dvs. de construcție să se potrivească mai mult cu versiunile Mac și Linux, putem adăuga directorul dart-sdk bin în mediul Windows, astfel încât Sublime Text știe să se uite acolo pentru frogc.

Pentru a adăuga calea, faceți clic pe Start, apoi faceți clic dreapta pe Computer și selectați Properties. (Alternativ: Panou de control> Sistem și securitate> Sistem.) Faceți clic pe "Setări avansate de sistem", apoi pe "Variabile de mediu".

Acum, găsiți variabila "calea", fie în Variabile de utilizator, fie în Variabile de sistem (funcționează cu oricare dintre acestea). Dacă nu există, puteți face clic pe Nou pentru a-l crea, dar dacă acesta există, faceți clic pe Nou va suprascrie, deci aveți grijă.

Adăugați calea corectă până la capătul a ceea ce există deja, utilizând o punct și virgulă pentru ao separa de orice altceva. Nu este nevoie să scăpați de șireturi sau să înlocuiți spațiile cu subliniere sau ceva similar. Mina arată ca:

C: \ Windows \ System32; C: \ Windows; C: \ Windows \ System32 \ Wbem; C: \ Users \ Administrator \ Downloads \ DART-win32-târziu \ DART-sdk \ bin

(Derulați caseta de mai sus spre dreapta.)

Asta te lasă să fugi frogc c: \ whatever \ source.dart din fereastra de comandă, dar tot nu va funcționa în textul Sublime 2. Din anumite motive, ST2 pe Windows vă cere să specificați extensia de fișier în fișierul sistemului de execuție, cum ar fi:

"cmd": ["frogc.bat", "fișier $"]

În acest moment, ar trebui să aveți un sistem de construcție utilizabil pe Windows, care este mai puțin probabil să se rupă.


Pasul 6: Utilizarea sistemului Build

Continuați și încercați noul nostru sistem de construcție. Deschideți un fișier Dart și apăsați F7 sau Control-B (pe Mac, Command-B). "B" pentru Build.

Ar trebui să vedeți că panoul de ieșire se deschide în partea de jos și dacă Dart este fără erori, veți vedea doar [Terminat].

Dacă aveți erori, veți obține rezultate mult mai complexe. De exemplu:

Când se întâmplă acest lucru, apăsați F4 pentru a avansa prin diferitele linii de eroare și Shift-F4 pentru a vă deplasa înapoi. Linia de eroare va fi evidențiată în panoul de ieșire, iar cursorul dvs. va fi plasat la rândul și coloana identificate de eroare.


Pasul 7: Începeți crearea de fragmente

Există multe fragmente utile care pot fi adăugate la un pachet Dart. Permiteți-mi să încep prin adăugarea unui fragment care creează o nouă metodă.

Din meniul Sublime Text, alegeți Instrumente> Snippet nou ... Veți primi din nou un fișier implicit, acesta în format XML. Modificați conținutul acestuia la:

  metodă source.dart 

Nu ezitați să modificați conținutul nod de la metodă la altceva pe care îl veți găsi mai util. Aceasta este ceea ce tastați înainte de a apăsa pe Tab pentru a obține fragmentul.

Salvați fișierul ca method.sublime-fragment (extensia este crucială, numele de bază este ceea ce fragmentul dvs. va apărea ca în meniuri), în următoarea locație în raport cu folderul Sublime Text 2 Packages:

/Dart/method.sublime-snippet

Ar trebui să aveți deja dosarul "Dart" de la instalarea fișierului de limbă gramatică.

Încercați acum fragmentul nou (poate fi necesar să reporniți textul Sublime, dar cred că acest lucru nu mai este o problemă).

Într-un fișier Dart, tastați "method" (sau orice ați specificat dacă ați falsificat propriul declanșator), apăsați Tab și vizionați-l să se extindă. Puteți trece prin diferite opriri, începând cu tipul retur, apoi cu numele metodei și, în final, între paranteze, dacă doriți să adăugați argumente. Ultima fila vă va lăsa la prima linie a metodei.

Partea rece este dacă schimbați tipul returului vid, ai automat reveniți nul declarație la sfârșitul corpului metodei. Desigur, veți dori să adaptați acest lucru nevoilor dvs., dar, sperăm, este o caracteristică care salvează o mică tastare. Magia se întâmplă în cea de-a doua linie dificilă a fragmentului; dacă nu ați mai văzut acest lucru înainte, atunci este oarecum dificil de explicat în mod concis, dar se uită la conținutul primei opriri tab (tipul de returnare) și dacă este altceva decât "vid", adaugă reveniți nul. S-ar putea să aveți sens dacă ați folosit expresii regulate, în special cu sintaxa de substituție din / Model / substitut / găsită în Perl.

Câmpul este deschis pentru crearea de fragmente Dart de economisire a timpului. Simțiți-vă liber să publicați fragmentele în comentarii.


Asta e tot

Și acolo aveți; utilizatorii care preferă un anumit editor de text peste orice altceva pot continua să facă acest lucru, chiar și cu acest nou limbaj Dart. Vă mulțumim pentru lectură și sper că ați învățat ceva despre extensibilitatea Sublime Text 2 de-a lungul drumului.

Cod