クイックヒント: AMD Packages

ReneRubalcava

<\/HEAD>

<\/P>

<\/P>

ArcGIS API for JavaScript を初めて使う方も、経験豊富なユーザーの方も、ある時点でAMD<\/A>やモジュール式JavaScriptについて深く掘り下げたことがあると思います。<\/P>

<\/P>

以前にいくつか投稿を書いており、その一つが

Embrace your AMD modules<\/A>で、またカスタムビルド<\/A>に関する投稿もあります。さらにArcGIS JS API の Bower リリースの使用についてのビデオも録画しました<\/A>。<\/P>

<\/P>

よく出てくる質問の一つにパッケージに関するものがあります。<\/P>

<\/P>

パッケージとは何で、なぜ重要なのか？<\/H2><\/P>心配しないでください。パッケージは私も一度は混乱した概念です。パッケージは名前空間として考えることができ、これはJava<\/A>や他の言語で見られるものに似ています。<\/P>

<\/P>

いくつかの文を分解してみましょう。ここではデフォルトの ES5 構文を使います。<\/P>

<\/P>

define(["esri\/map"], function(map) {});<\/PRE><\/P>ここで行っているのは、esri<\/EM> パッケージから map<\/EM> モジュールを要求していることです。ArcGIS API for JavaScript 全体は esri<\/EM> パッケージ内にあります。他にも dojo<\/EM> や dojox<\/EM> のような他のパッケージからの依存関係があります。<\/P><\/P>通常、単純なアプリケーションを構築している場合はパッケージについてあまり気にする必要はありません。API の CDN を使っているなら、おそらくこの

ちょっとしたハック<\/A>を使ってローカルコードを利用していることでしょう。<\/P>

<\/P>

パッケージの使用方法<\/H2><\/P>それはそれで良いですが、もしAPI の Bower リリース<\/A>を使ってカスタムローカルビルドを行いたい場合、パッケージが重要になります。なぜなら Dojo ビルドシステムにどのパッケージを認識させるべきか知らせる必要があるからです。一番簡単な方法は esri<\/EM> とその依存パッケージをソースフォルダの下に追加することです。アプリケーションコードは app<\/EM> フォルダに入れるべきです。<\/P><\/P>つまり、次のようなアプリケーション構造になります。<\/P><\/P>src
  app
  dgrid
  dijit
  dojo
  dojox
  dstore
  xstyle
  put-selector
  esri<\/PRE><\/P>Bower を使ってソースディレクトリにインストールする方法についてはこのガイド<\/A>をご覧ください。これでビルドプロファイル内で Dojo ビルドシステムに認識させるべきパッケージを指定できます。

  packages: [
    \/\/'app' はあなたのアプリケーション用のサンプルパスです
    \/\/'適切に設定してください'
    'app',
    'dijit',
    'dojo',
    'dojox',
    'dstore',
    'dgrid',
    'xstyle',
    'put-selector',
    'esri'
  ],<\pre>
Bower リリース用のサンプルビルドプロファイルは

こちらで確認できます. もし Bootstrap や jQuery のようなライブラリを追加したい場合は、それらを packages リストに加えればよいだけです。

結局のところ、パッケージとはコードを整理するための方法に過ぎません。

しかし、それがパッケージについての全てではありません. Dojo ビルドシステムにフォルダがパッケージであり AMD パッケージであることを知らせるための詳細があります。また、パッケージフォルダ内に存在する可能性があるテストディレクトリを無視するための設定もあります。

これらの詳細については次回説明します！

もっと geodev のヒントやコツが知りたい方は、ぜひ私のブログをご覧ください。