Skip to main content

図書館リポジトリ

いつCODESYS 4がインストールされると、さまざまな拡張機能も一緒にインストールされます。各拡張機能にはライブラリリポジトリを含めることができます。これらのライブラリリポジトリは自動的にアクティブ化され、利用可能になります。 に入力する必要はありません。LibraryRepositories.prefs.jsonファイル。

独自のライブラリリポジトリを作成する

でCODESYS 4独自のライブラリリポジトリをいくつでも作成できます。 

カスタムリポジトリは、LibraryRepositories.prefs.jsonファイル。Linux では、このファイルは次の場所にあります。~/.config/CODESYS-4/LibraryRepositories.prefs.json Windowsでは、このファイルは次の場所にあります。%APPDATA%\CODESYS-4\LibraryRepositories.prefs.jsonリポジトリ構成の形式は、デプロイメントサーバーによって定義されます。

例 8. 例LibraryRepositories.prefs.json
{
  "storages": [
    {
      "name": "LocalStorage",
      "kind": "FileSystem",
      "rootDirectory": "D:\\GoLibRepo"
    }
  ],
  "c4LibraryRepositories": [
    { "name": "LocalRepository",
      "isPublic": true,
      "kind": "Local",
      "storage": "LocalStorage"
    }
  ]
}


詳細については、以下を参照してください。Libraries.jsonそしてライブラリの解決、すべてのライブラリの解決

ライブラリ – ハードドライブ上のストレージ形式

ライブラリリポジトリは、デプロイメントサーバーのインフラストラクチャを介して管理され、ローカルリポジトリにはローカルストレージモジュールが使用されます。そのため、ハードドライブ上のフォーマットはデプロイメントサーバーによって標準的に定義されますが、その形式は単純なので、完全性を期すためにここに記載します。

リポジトリ内のフォルダ階層は、以下のように構成されています。Company/Title/Version/FileName.Suffix

Company

のCompanyプロジェクト情報からのエントリ

  • 先頭と末尾の空白が削除されます。

  • セパレーター,(、 そして)許可されていません。

  • 制御文字を含む一部の特殊文字は、オブジェクトモデルエンコーディングを使用してエンコードされます。

    特定の特殊文字、特に印刷不可能な制御文字は直接格納されず、オブジェクトモデルの特殊な文字列によって表現されます。

Title

のTitleプロジェクト情報からのエントリ

  • 先頭と末尾の空白が削除されます。

  • セパレーター,(、 そして)許可されていません。

  • 制御文字を含む一部の特殊文字は、オブジェクトモデルエンコーディングを使用してエンコードされます。

Version

のVersionプロジェクト情報からのエントリ

  • これは有効な4部構成のセマンティックバージョニング(semver)である必要があります。

  • プレリリース指定はバージョンの一部です。これはIDの一部ではないため、ビルドメタデータではありません。

  • バージョンの4番目の数値部分は、0でない場合にのみ書き込まれます。

FileName

同一Title

Suffix

許可されている4つの接尾辞のうちの1つ:

  • .compiled-library

  • .compiled-library-ge33

  • .compiled-library-v3

  • .fbslibpack

この形式により、特定のライブラリを簡単に見つけることができ、インデックスファイルなしでライブラリの利用可能なすべてのバージョンを閲覧できます。

簡単な設定

の中に localRepositories セクションでは、ローカルリポジトリを次のように指定します。 "Name": "Path" ペア。初めて起動したときには、という名前のリポジトリが Default 作成されます。

例 9. 例localRepositoriesセクション
{  
    "localRepositories": {
        "AllLibs": "D:\\C4LibRepo",
        "Default": "C:\\Users\\h.mustermann\\AppData\\Local\\CODESYS-4\\managed-libraries"
    }
}
...


重ね合わせと抑制

ユーザー固有のレベルは、システム全体のレイヤーと拡張機能の定義を継承します。このオプションサービスを使用して、これらの定義を上書きします。

  • 継承する特に指定がない限り、継承された定義は変更されません。

  • 延長: 先頭に付いたセクション名 + 継承されたリストを置き換えずに拡張する。例えば "+storages"。

  • 抑制する : 値null引用符なしは継承定義を抑制します。これは継承リポジトリを無効にする方法です。Defaultリポジトリ。

例 10. 例
{  
    "localRepositories": {
        "AllLibs": "/home/mustermann/allLibs",    
        "_Extension_ExampleExtension_1.2.3.4": null  
    }
}
...

この例では、AllLibsリポジトリが定義され、ライブラリが提供されますExampleExtensionバージョン1.2.3.4の拡張機能は抑制されています。



詳細については、以下を参照してください。復元とライブラリキャッシュそしてライブラリの依存関係の解決