2014年5月28日水曜日

1 - ol3-beta.5 5 - Workshop 1.3. OpenLayers Resources

1.3. OpenLayers のリソース
OpenLayers ライブラリは、機能が豊富にあります。開発者はその機能の例を提供するために努力を重ね、他の経験豊富な開発者がそのやり方を見つけることを可能にする方法でコードを編集してきたので、多くのユーザはそれがゼロから始めるための挑戦であることを見つけます。

1.3.1. 例から学ぶ
新規のユーザは、OpenLayers のイグザンプル(例)コードに取り組み、始めるために最も便利な方法である、ライブラリの可能な機能を使って試すことを、大概、見つけ出します。

http://ol3js.org/en/master/examples/

1.3.2. ドキュメントを参照
特定のトピックについての詳細は、拡張中の OpenLayers のドキュメントのコレクションを参照します。

http://ol3js.org/en/master/doc/quickstart.htmlhttp://ol3js.org/en/master/doc/tutorials

1.3.3. APIリファレンスを検索
マップを作成しコントロールする基本的な構成要素を理解した後に、メソッドのシグネチャとオブジェクトのプロパティの詳細については、APIリファレンスマニュアルを検索します。

signatures:プログラミングで, 関数の戻り値の型や引数の数といった特性

http://ol3js.org/en/master/apidoc/

1.3.4. コミュニティに参加
OpenLayers は、あなたのような開発者とユーザのコミュニティによってサポートされ、維持されています。問い合わせ、または、提供するコードがあるなら、メーリングリストにサインアップすることで参加することができます。

https://groups.google.com/forum/#!forum/ol3-dev

1.3.5. 問題を報告
問題を報告するためには、OpenLayers のライブラリが配布されているいくつかの性質の違いを理解することが重要です。

ol.js - Google クローザコンパイラを使用してアドバンスドモード(可読形式ではありません)で構築されたスクリプト。

ol-simple.js - Google グローザコンパイラを使用して単純なモードで構築されたスクリプト(詳細は以下を参照してください。

https://developers.google.com/closure/compiler/faq)

ol-whitespace.js - デバッグの問題のために使用することができる人間が読めるバージョン。

問題が発生した場合には、ol-whitespace.js を使用して問題を報告することが重要です。また、Chrome 開発ツールのような Web 開発ツールを使用して見つけることができる完全なスタックトレースが含まれています。ol.layer.Tile を ol.layer.Image に変更することで map.html に間違えが起こるかを試します。分かるエラーは、次のとおりです。Uncaught TypeError: Object #<yc> はメソッド 'tb' がありません。メーリングリストに報告したとき、誰もそれが何を意味するか知りません。まず最初に、代わりに ol.js の指定を ol-whitespace.js の指定にスクリプトタグを変更します。ページをリロードします。デバッガは、現在、エラー時に停止し、完全なスタックトレースを見ることができます:
(原文[http://ol3js.org/ol3-workshop/basics/resources.html]では、ここに ol-whitespace.js の出力例があります。)

スタックトレースを示すデバッガ。マウスの右ボタンを使用すると、クリップボードにコールスタックをコピーすることができます。

0 件のコメント: