Snelle Tip: AMD Packages

ReneRubalcava

<\/HEAD>

<\/P>

<\/P>

Misschien ben je nieuw met de ArcGIS API for JavaScript of misschien ben je zelfs een ervaren gebruiker, maar op een gegeven moment heb je vast diep gegraven in AMD<\/A> en modulair JavaScript.<\/P>

<\/P>

Ik heb hier eerder een paar berichten over geschreven, één daarvan is

Omarm je AMD modules<\/A>, evenals een bericht over aangepaste builds<\/A>. Ik heb zelfs een video opgenomen over het gebruik van de Bower release van de ArcGIS JS API<\/A>.<\/P>

<\/P>

Een vraag lijkt vaak terug te komen en dat is een vraag over packages.<\/P>

<\/P>

Wat zijn ze en waarom zijn ze belangrijk?<\/H2><\/P>Maak je geen zorgen, packages zijn een concept dat mij ook ooit in de war bracht. Packages kunnen worden gezien als namespaces, vergelijkbaar met wat je zou zien in Java<\/A> of een andere taal.<\/P>

<\/P>

Laten we een paar uitspraken ontleden, gebruikmakend van standaard ES5-syntaxis.<\/P>

<\/P>

define(["esri\/_map"], function(map) {});<\/PRE><\/P>Wat we hier doen is het opvragen van de map<\/EM> module uit het esri<\/EM> package. De gehele ArcGIS API for JavaScript zit binnen het esri<\/EM> package. Er zijn andere afhankelijkheden van andere packages zoals dojo<\/EM> of dojox<\/EM>.<\/P><\/P>Meestal hoef je je niet al te veel zorgen te maken over packages als je een eenvoudige applicatie bouwt. Als je de CDN van de API gebruikt, ben je waarschijnlijk bekend met deze 

kleine truc<\/A> om je lokale code te gebruiken.<\/P>

<\/P>

Gebruik van packages<\/H2><\/P>Dat is allemaal prima, maar als je de Bower release van de API<\/A> gebruikt en je wilt aangepaste lokale builds doen, dan zijn packages belangrijk. Omdat je het Dojo build systeem moet laten weten welke packages het moet herkennen. De makkelijkste manier om dit te doen is door het toevoegen van het esri<\/EM> package en de afhankelijkheidspackages onder een source map. Je applicatiecode moet in een app<\/EM> map geplaatst worden.<\/P><\/P>Dit betekent dat je uitkomt met een applicatiestructuur die er ongeveer zo uitziet.<\/P><\/P>src
  app
  dgrid
  dijit
  dojo
  dojox
  dstore
  xstyle
  put-selector
  esri<\/PRE><\/P>Je kunt deze gids<\/A> lezen om te ontdekken hoe Bower installeert naar je source directory. Nu kun je het Dojo build systeem vertellen welke packages het moet herkennen in je build profiel.

  packages: [
    \/\/'app' is een voorbeeldpad voor jouw applicatie
    \/\/'stel dit dienovereenkomstig in
    'app',
    'dijit',
    'dojo',
    'dojox',
    'dstore',
    'dgrid',
    'xstyle',
    'put-selector',
    'esri'
  ],

Je kunt hier een

voorbeeld build profiel vinden<\/A>. Als je meer libraries toevoegt, zoals Bootstrap<\/EM> en jQuery, kun je ze gewoon aan de lijst met packages toevoegen.
Dus uiteindelijk zijn packages niets meer dan een manier om je code georganiseerd te houden.
Nog is dat niet het einde van het verhaal voor packages. Er zijn meer details die je kunt leren om het Dojo build systeem te laten weten dat een map een package is en dat het een AMD package is. Er zijn zelfs dingen die je kunt doen om eventuele testmappen die zich binnen jouw package map bevinden te negeren.
Die details behandel ik de volgende keer!<\/<STRONG>

Voor meer geodev tips en trucs, bekijk mijn blog.