Dica Rápida: Pacotes AMD

ReneRubalcava

<\/HEAD>

<\/P>

<\/P>

Talvez você seja novo na ArcGIS API for JavaScript ou talvez seja um usuário experiente, mas em algum momento tenho certeza que você já se aprofundou em AMD<\/A> e JavaScript modular.<\/P>

<\/P>

Eu já escrevi alguns posts sobre isso antes, um deles sendo

Aceite seus módulos AMD<\/A>, assim como um post sobre builds personalizados<\/A>. Eu até gravei um vídeo sobre como usar a versão Bower da ArcGIS JS API<\/A>.<\/P>

<\/P>

Uma pergunta parece surgir com bastante frequência e é uma questão sobre pacotes.<\/P>

<\/P>

O que são e por que são importantes?<\/H2><\/P>Não se preocupe, pacotes são um conceito que também me confundiu em algum momento. Pacotes podem ser pensados como namespaces, semelhante ao que você pode ver em Java<\/A> ou outra linguagem.<\/P>

<\/P>

Vamos analisar algumas declarações, usando a sintaxe padrão ES5.<\/P>

<\/P>

define(["esri\/map"], function(map) {});<\/PRE><\/P>O que estamos fazendo aqui é solicitando o módulo map<\/EM> do pacote esri<\/EM>. Toda a ArcGIS API for JavaScript está dentro do pacote esri<\/EM>. Existem outras dependências de outros pacotes como dojo<\/EM> ou dojox<\/EM>.<\/P><\/P>Normalmente, você não precisa se preocupar muito com pacotes se estiver construindo uma aplicação simples. Se você está usando o CDN da API, provavelmente está familiarizado com esse 

pequeno truque<\/A> para usar seu código local.<\/P>

<\/P>

Usando pacotes<\/H2><\/P>Tudo isso é ótimo, mas se você está usando a versão Bower da API<\/A> e quer fazer builds locais personalizados, é aí que os pacotes importam. Porque você precisa informar ao sistema de build Dojo quais pacotes ele deve conhecer. A maneira mais fácil de fazer isso é adicionar o esri<\/EM> e seus pacotes dependentes dentro de uma pasta source. O código da sua aplicação deve ir para uma pasta app<\/EM>.<\/P><\/P>Isto significa que você acabaria com uma estrutura de aplicação semelhante a esta.<\/P><\/P>src
  app
  dgrid
  dijit
  dojo
  dojox
  dstore
  xstyle
  put-selector
  esri<\/PRE><\/P>Você pode ler este guia<\/A> para descobrir como fazer o Bower instalar no seu diretório source. Agora você pode informar ao sistema de build Dojo quais pacotes ele deve conhecer no seu perfil de build.

  packages: [
    \/\/_ 'app' é um caminho exemplo para sua aplicação
    \/\/_ configure isso conforme necessário
    'app',
    'dijit',
    'dojo',
    'dojox',
    'dstore',
    'dgrid',
    'xstyle',
    'put-selector',
    'esri'
  ],

Você pode ver um

perfil de build exemplo aqui<\/A>. Se você adicionar mais bibliotecas, como Bootstrap e jQuery, basta adicioná-las à lista de pacotes.
No final das contas, pacotes não são nada mais do que uma forma de manter seu código organizado.
Agora, essa não é a história completa dos pacotes. Existem mais detalhes que você pode aprender para informar ao sistema de build Dojo que uma pasta é um pacote e que ele é um pacote AMD. Há até coisas que você pode fazer para ignorar quaisquer diretórios de testes que possam residir dentro da pasta do seu pacote.
Cobrirei esses detalhes na próxima vez!Para mais dicas e truques geodev, confira meu blog.