トラブルシューティング

トラブルシューティング

本セクションでは一般的な問題と回避策をリストアップします。

あなたのコードが実行されない、またはコンソールにエラーメッセージが表示される

コードが実行されない場合、以下のチェックを行ってください。

  • 「grunt pluginRegisterAll」と「grunt appRegister」を再実行して、登録が最新かどうか確認します。
  • Chromeをお使いの場合、Chromeのデベロッパーツールを開いてください。
  • 「Sources」タブをクリックし、「apps」フォルダを開きます。
  • プラグインがすべてロードされ、マニフェストの「import」セクションのリストに入っているかどうか、確認します。
  • あなたのプラグインに必要なファイルがすべてロードされているか、チェックしてください。
  • ファイルが欠落している場合、該当するマニフェストのリストに記載されているかどうか、チェックしてください。例えば、JavaScriptファイルはロード対象の「js」セクションのリストに記載されている必要があります。

あなたのコードがローカルでは実行されるが、テナント経由だと実行されない

テナント経由でアプリケーションを実行した場合のみエラーメッセージが表示される場合:

  • 必要なファイルがすべて「build」フォルダに格納されているか、確認してください。ファイルが欠落している場合、マニフェストにおいて該当する「copy」、「css」および「less」のセクションをチェックしてください。
  • ファイルがすべてリビジョン管理に追加されているかどうか、確認してください。例えば、Mercurialの場合、「hg status」を実行して欠落しているファイルをチェックし、追加します。
  • あなたのソースコードリポジトリに最新版をプッシュしてください。例えば、Mercurialの場合は「hg push」を使用します。

サードパーティライブラリをあなたのプラグインで動作させることができない

サードパーティライブラリを手軽にあなたのプラグインに含める方法は、Bowerの使用です。あなたのbower.jsonファイル内のリストにそのサードパーティライブラリを入れ、「bower install」を使用してインストールします。その後、サードパーティライブラリから必要なアーチファクトを選び、あなたのプラグインのリストに入れます。

例えば、Chart.jsの最新版をあなたのプラグインに含めたい場合、あなたのアプリケーションのルートフォルダに、以下の内容のbower.jsonファイルを作成します。

{
    "name": "<your app>",
    "version": "<your version>",
    "dependencies": {
        "Chart.js": "latest"
    }
}

次いで「bower install」を実行します。あなたのプラグインの「cumulocity.json」マニフェストにおいて、Chart.jsを以下のように参照します。

"js": [
    ...
    "bower_components/Chart.js/Chart.js"
]