ライブラリを読み込んで使う#

ライブラリを読み込む方法#

ユーザライブラリは、XAE単位でインストールが必要となり、プロジェクト毎にインポートする必要があります。ここではユーザライブラリをXAEにインストールを行う手順について説明します。

ライブラリを作成したXAEにおいて、ライブラリ保存時にSave as library and install ...を選択された場合はこの節の手順を実施する必要はありません。

ただし、ライブラリを更新インストールされた場合は必ずライブラリ読み出し側のプロジェクトのVisualStudioもしくはXAEシェルを再起動してください。

  1. PLCのプロジェクトツリーからReferences以下のメニューをダブルクリックします。

    これによりメインウィンドウにライブラリマネージャが現れます。

    ../_images/2023-02-21-13-37-07.png
  2. Library repositoryボタンを押してください。

    ../_images/LibraryManager_Main.png
  3. Library Repositoryウィンドウからインストールする

    Install...ボタンを押すとエクスプローラが現れます。インストールしたい library ファイルを選択します。

    ../_images/LibraryRepository_Main.png
  4. ここで一度プロジェクトを上書き保存してXAEを終了します。

    警告

    インストールしたライブラリを正しくお使いいただくには一度ライブラリ呼び出し側のプロジェクトのVisualStudioもしくはXAEシェルを再起動する必要があります。再起動なしにライブラリマネージャを閲覧した場合、特にライブラリドキュメントの作成で説明する、ライブラリのドキュメントの表示が行われない問題が生じます。

  5. 再度プロジェクトを開いてライブラリマネージャの Library repositoryを開くと、インストールしたライブラリが一覧されていることが確認できます。

    ../_images/LibraryRepository_InstalledLibrary.png

    図 3.6 追加したライブラリ#

プロジェクトへのライブラリの追加#

XAEにインストールしたライブラリをプロジェクトへ追加する手順を説明します。

  1. 以下いずれかの方法でライブラリの追加を行います。

    • Library Manager からAdd libraryボタンを押す

      ../_images/LibraryManager_Addlibrary.png
    • PLCプロジェクトツリーのReferencesを右クリックしてAdd library...を選択する

  2. 登録したライブラリを追加します。

    ../_images/AddLibrary_UseLibrary.png
  3. ライブラリパラメータがあれば設定します。

    ライブラリパラメータの設定方法に示す通りライブラリ内で使用されるリソースがスケールする場合は、パラメータ化されている可能性があります。この場合、ライブラリを追加した後にLibrary Parametersタブからリソース量を変更することができます。

  4. 登録したライブラリが References に追加されることを確認します。

    ../_images/Solution_References.png

ライブラリの更新#

新しいライブラリが発行されましたらライブラリを読み込む方法を行うことで最新版が使える状態となります。

デフォルトでは常に最新版を使う設定になっていますので、新しいライブラリをインストールすれば即プログラムは更新された状態となります。しかし、Placeholderを使わずにライブラリをインストールしていたり、特定バージョンにPlaceholderが固定されている場合は、新しいライブラリをインストール後、そのバージョンを使うように設定しなおす必要があります。

この場合、図 3.7の図の通りReferences以下の目的のライブラリを選択し、右クリックして現れたサブメニューからPropertiesを選ぶと、Propertiesウィンドウが現れます。この中のMiscカテゴリにResolutionという項目から選択することができます。

常に最新バージョンを使う設定にする場合は、ライブラリ名の後がバージョン番号ではなくアスタリスク*のものを選択してください。

../_images/2023-03-02-16-13-13.png

図 3.7 Placeholderに紐づいたライブラリのバージョン切替方法#