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

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

ユーザライブラリを使用するには次の2ステップが必要です。

  1. ライブラリのインストール

    配布された*.libraryファイルを開発環境（XAE）へインストールします。開発環境においてライブラリが使用可能な状態となります。ライブラリが新しいバージョンに更新される場合も同様の手順でインストールが必要です。ただしライブラリバージョンが固定されたPLCプロジェクト（placeholderが指定されたPLCプロジェクト）にはインストールだけでは最新に更新されませんのでご注意ください。（ライブラリの更新節参照）

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

    インストールされたライブラリを任意のPLCプロジェクト内に「参照」設定して使用できる状態にします。

順にこの操作手順を説明します。

ライブラリのインストール#

ユーザライブラリをXAEにインストールを行う手順について説明します。

注釈

独自ライブラリのつくりかたで紹介するライブラリの作成を行ったものと同じXAEの場合、作成したライブラリ保存時にSave as library and install ...を選択すると、ライブラリのインストールも同時に実行されます。

この場合、この節の手順の実行は不要です。プロジェクトへのライブラリの追加へ進んでください。

  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に紐づいたライブラリのバージョン切替方法#

目次