npm の依存関係を追加する

関数リポジトリでは、依存関係の管理に npm ↗ を使用します。これには、Foundry オントロジーに基づくコードの生成や、コード内の関数の検出に使用するパッケージも含まれます。npm を使用して外部の依存関係をリポジトリにインストールし、数値や日付の操作、統計計算、XML などのデータ形式の処理といった用途に標準的なパッケージを利用できます。

関数のランタイムは、純粋な JavaScript ライブラリにのみ対応しています。NodeJS ランタイムに依存し、システムコールを行うパッケージは利用できません。

公開 npm レジストリからの依存関係の取得を有効にする

デフォルトでは、関数リポジトリは公開 npm レジストリからパッケージを取得しません。

リポジトリで公開 npm レジストリからの依存関係の取得がまだ有効になっていない場合、Code Repositories で package.json ファイルを開くと、有効にするためのバナーが表示されます。

Code Repositories で依存関係を追加する

Code Repositories のライブラリサイドバーを使用して、関数リポジトリにパッケージを追加できます。目的のパッケージを検索し、検索結果を選択すると、最新バージョンなどの詳細が表示されます。検索結果には、Foundry と https://npmjs.com のパッケージが含まれます。

package.json ファイルの dependencies と devDependencies のどちらにパッケージを追加するかを選択します。リポジトリにパッケージを追加するには、ライブラリの追加とインストールを選択します。

パッケージの取得元リポジトリがまだ設定されていない場合、追加のリソースをインポートするよう求めるダイアログが表示されます。ライブラリの追加とインストールボタンは、パッケージとその依存関係を関数リポジトリに自動的にインポートし、package.json と package-lock.json を更新します。

実行中のインストールタスクが完了すると、リポジトリ内でパッケージを使用できるようになります。

typescript-functions テンプレートのバージョンが 0.520.0 未満の場合、タスクランナー経由のインストールは無効になります。この場合は、更新した package.json ファイルをコミットし、チェックが正常に完了したことを確認してから、Code Assist を再起動して新しいパッケージを利用可能にしてください。

依存関係を手動で追加する

Code Repositories で package.json ファイルを変更して、パッケージを手動で追加できます。これは、特定のバージョンのパッケージをインストールする必要がある場合に便利です。package.json を開き、https://npmjs.com から適切なバージョンを選んで依存関係を追加し、コミットを選択します。チェックが正常に完了したことを確認したら、Code Assist を再起動して新しいパッケージを利用可能にします。

以下は、リポジトリの package.json ファイルに d3-array パッケージを手動で追加する例です。

Copied!
1
2
3
4
5
6
7
8
  "dependencies": {
    ...
    "d3-array": "^2.3.1"
  },
  "devDependencies": {
    ...
    "@types/d3-array": "^2.0.0"
  }