CLIコマンド: `c4-cli library`

図書館の参考文献を編集する

使用法：

  c4-cli library [OPTIONS] <COMMAND>

例 24. 例

    c4-cli library set-managed ToolsNamespace "AcmeTools, 1.2.3.4 (Acme Inc)" C:/path/to/Libraries.json --optional true
    c4-cli library set-managed ToolsNamespace "AcmeTools, 1.2.3.4 (Acme Inc)" C:/path/to/Application.iecapp/ --optional true
    c4-cli library set-relative ToolsNamespace C:/path/to/library.fbslib/ C:/path/to/Libraries.json
    c4-cli library set-placeholder ToolsNamespace some_placeholder C:/path/to/Libraries.json
    c4-cli library restore

オプション	説明
`-h, --help`	コマンドのヘルプを表示します

指示	説明
`set-managed <namespace> <library>`	新しいマネージドライブラリ参照を追加します`Libraries.json`ファイルまたは既存の参照を置き換える
`set-relative <namespace> <path>`	相対パスへの新しい参照を追加します`Libraries.json`ファイルまたは既存の参照を置き換える
`set-placeholder <namespace> <placeholder>`	新しいプレースホルダー参照を追加します`Libraries.json`ファイルまたは既存の参照を置き換える
`install`	アプリケーションのすべてのライブラリを解決し、不足しているライブラリをライブラリキャッシュに復元します。
`install-placeholder <namespace> <placeholder>`	プレースホルダーへの新しい参照を追加します`Libraries.json`ファイルを変更するか、既存の参照を置き換えます。次に、アプリケーションのすべてのライブラリを解決し、不足しているライブラリをライブラリキャッシュに復元します。
`install-managed <namespace> <library>`	新しいマネージドライブラリ参照を追加します`Libraries.json`ファイルを変更するか、既存の参照を置き換えます。次に、アプリケーションのすべてのライブラリを解決し、不足しているライブラリをライブラリキャッシュに復元します。
`install-relative <namespace> <path>`	相対パスへの新しい参照を追加します`Libraries.json`ファイルを変更するか、既存の参照を置き換えます。次に、アプリケーションのすべてのライブラリを解決し、不足しているライブラリをライブラリキャッシュに復元します。
`restore`	アプリケーションの不足しているライブラリをすべてライブラリキャッシュに復元します。
`clean-install`	検証します`Libraries.lock.json`ファイルを削除し、ライブラリキャッシュを削除し、参照されているすべてのライブラリをインストールします。`Libraries.lock.json`ファイル
`library uninstall <namespace> [target-path]`	指定された名前空間に関連付けられたライブラリをアンインストールします。ライブラリ自体と、そのライブラリによってのみ参照されるすべての依存関係を削除します。
`resolve`	指定されたアプリケーションのライブラリ参照を解決し、それを書き込みます。`Libraries.lock.json`ファイル
`remove <namespace> [target-path]`	名前空間によって識別されるライブラリ参照を削除します。`Libraries.json`ファイル
`prune`	ライブラリへの未使用の間接参照を削除します。`Libraries.lock.json`ファイル
`outdated`	リポジトリをチェックして、インストールされているライブラリ（全般または特定のライブラリ）が現在古くなっているかどうかを判断します。
`list`	指定されたアプリケーションのすべての参照を一覧表示します。
`explain <library>`	指定されたライブラリが参照される原因となっている依存関係の連鎖を表示します。
`pack`	指定されたソースライブラリアーカイブを作成しますCODESYS 4ライブラリプロジェクトフォルダ。有効なライブラリである必要があります。
`save-compiled <library-path> <destination-path>`	指定されたライブラリをコンパイル済みライブラリとして保存します。
`verify`	ライブラリの解像度を確認します`Libraries.lock.json`依然として有効であり、`Libraries.json`ライブラリキャッシュ内のすべてのライブラリにアクセス可能であること、重複する参照、更新されたパッケージ、または孤立したパッケージが存在しないことを確認します。
`check`	ライブラリプロジェクトをチェックし、検出されたエラーと警告を報告します。

CLIコマンド: `c4-cli library set-managed`

新しいマネージドライブラリ参照を追加しますLibraries.jsonファイルを変更するか、既存の参照を置き換えます。

使用法：

c4-cli library set-managed <namespace> <library> [target-path] [OPTIONS]

例 25. 例

c4-cli library set-managed ToolsNamespace "AcmeTools, 1.2.3.4 (Acme Inc)" C:/path/to/Libraries.json --optional true
c4-cli library set-managed ToolsNamespace "AcmeTools, 1.2.3.4 (Acme Inc)" C:/path/to/Application.iecapp/ --optional true

議論	説明
`<namespace>`	編集するライブラリの名前空間
`<library>`	ライブラリIDまたは追加するライブラリのパターン
`[target-path]`	への道`Libraries.json`参照を作成または置換するファイル、アプリケーションディレクトリ、またはライブラリディレクトリを指定します。これを省略した場合、コマンドはデフォルトで現在のディレクトリを指定します。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	コンソールへのログ出力のログレベルを設定します。例: `trace`、`debug`、`information`、`warning`、または`error`デフォルトでは、コンソールには何もログが出力されません（`none` )
`-u, --allow-unqualified-access`	これが設定されている場合`true`そうすれば、名前空間修飾なしでライブラリにアクセスできます。新しいコードに推奨される値は`false`これは、`qualifiedOnly`価値CODESYS 3デフォルトでは`false`歴史的な理由から。
`-c, --publish-symbols-in-container`	これが設定されている場合`true`すると、参照先のライブラリは、参照元のコンテナライブラリにシンボルを公開します。この設定を使用して、コンテナライブラリを作成する際に公開するシンボルを定義します。
`-o, --optional`	これが設定されている場合`true`そうすれば、ライブラリが利用できないという理由だけでコンパイラエラーが発生することはありません。（ただし、このライブラリのシンボルが不足しているためにコンパイラエラーが発生する場合があります。）
`--no-hash`	ファイルを指す相対パス参照に適用されます（`.zip`または`.compiled-library` ) SHA384 ハッシュ値の生成を抑制します。`Libraries.lock.json`ファイル。これは、参照されるファイルがパイプラインの早い段階で生成され、ハッシュ値が変化することが想定されるビルドパイプラインやテストCIパイプラインで役立ちます。
`-p, --include-prerelease`	これが設定されている場合`true`その場合、バージョンパターンは常に許可された範囲内のプレリリースバージョンに一致します。それ以外の場合は、デフォルトの動作が適用されます。「バージョンにプレリリースタグがある場合（例：`1.2.3-alpha.3`– 同じコンパレータが少なくとも 1 つある場合にのみ、コンパレータセットを満たすことが許可されます [ `major, minor, patch` ] タプルにはプレリリースタグも付いています。
`--link-all-content`	特殊な使用ケースのみ。`true`そうすれば、参照されている部分だけでなく、ライブラリ全体が統合されます。
`--default-resolution`	オプション（プレースホルダーに使用可能）。フラグを設定する場合は、図書館チェック時に使用される図書館IDまたはパターンを指定する必要があります。
`-d, --dry-run`	オプション。このフラグが設定されている場合、ファイルへの変更は一切行われません。代わりに、本来書き込まれるはずだったエントリがコンソールに表示されます。

CLIコマンド: `c4-cli library set-relative`

相対パスへの新しい参照を追加しますLibraries.jsonファイルまたは既存の参照を置き換える

使用法：

c4-cli library set-relative <namespace> <path> [target-path] [OPTIONS]

例 26. 例

    c4-cli library set-relative ToolsNamespace C:/path/to/library.fbslib/ C:/path/to/Libraries.json

議論	説明
`<namespace>`	編集するライブラリの名前空間
`<path>`	追加する（パックされた）ライブラリプロジェクトまたはコンパイル済みライブラリへのパス
`[target-path]`	への道`Libraries.json`参照を作成または置換するファイル、アプリケーションディレクトリ、またはライブラリディレクトリを指定します。これを省略した場合、コマンドはデフォルトで現在のディレクトリを指定します。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	コンソールへのログ出力のログレベルを設定します。例: `trace`、`debug`、`information`、`warning`、または`error`デフォルトでは、コンソールには何もログが出力されません（`none` )
`-u, --allow-unqualified-access`	これが設定されている場合`true`そうすれば、名前空間修飾なしでライブラリにアクセスできます。新しいコードに推奨される値は`false`これは、`qualifiedOnly`価値CODESYS 3デフォルトでは`false`歴史的な理由から。
`-c, --publish-symbols-in-container`	これが設定されている場合`true`すると、参照先のライブラリは、参照元のコンテナライブラリにシンボルを公開します。この設定を使用して、コンテナライブラリを作成する際に公開するシンボルを定義します。
`-o, --optional`	これが設定されている場合`true`そうすれば、ライブラリが利用できないという理由だけでコンパイラエラーが発生することはありません。（ただし、このライブラリのシンボルが不足しているためにコンパイラエラーが発生する場合があります。）
`--no-hash`	ファイルを指す相対パス参照に適用されます（`.zip`または`.compiled-library` ) SHA384 ハッシュ値の生成を抑制します。`Libraries.lock.json`ファイル。これは、参照されるファイルがパイプラインの早い段階で生成され、ハッシュ値が変化することが想定されるビルドパイプラインやテストCIパイプラインで役立ちます。
`-p, --include-prerelease`	これが設定されている場合`true`その場合、バージョンパターンは常に許可された範囲内のプレリリースバージョンに一致します。それ以外の場合は、デフォルトの動作が適用されます。「バージョンにプレリリースタグがある場合（例：`1.2.3-alpha.3`– 同じコンパレータが少なくとも 1 つある場合にのみ、コンパレータセットを満たすことが許可されます [ `major, minor, patch` ] タプルにはプレリリースタグも付いています。
`--link-all-content`	特殊な使用ケースのみ。`true`そうすれば、参照されている部分だけでなく、ライブラリ全体が統合されます。
`--default-resolution`	オプション（プレースホルダーに使用可能）。フラグを設定する場合は、図書館チェック時に使用される図書館IDまたはパターンを指定する必要があります。
`-d, --dry-run`	オプション。このフラグが設定されている場合、ファイルへの変更は一切行われません。代わりに、本来書き込まれるはずだったエントリがコンソールに表示されます。

CLIコマンド: `c4-cli library set-placeholder`

新しいプレースホルダー参照を追加しますLibraries.jsonファイルまたは既存の参照を置き換える

使用法：

c4-cli library set-placeholder <namespace> <placeholder> [target-path] [OPTIONS]

例 27. 例

    c4-cli library set-placeholder ToolsNamespace some_placeholder C:/path/to/Libraries.json

議論	説明
`<namespace>`	編集するライブラリの名前空間
`<placeholder>`	ライブラリを追加するプレースホルダー
`[target-path]`	への道`Libraries.json`参照を作成または置換するファイル、アプリケーションディレクトリ、またはライブラリディレクトリを指定します。これを省略した場合、コマンドはデフォルトで現在のディレクトリを指定します。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	コンソールへのログ出力のログレベルを設定します。例: `trace`、`debug`、`information`、`warning`、または`error`デフォルトでは、コンソールには何もログが出力されません（`none` )
`-u, --allow-unqualified-access`	これが設定されている場合`true`そうすれば、名前空間修飾なしでライブラリにアクセスできます。新しいコードに推奨される値は`false`これは、`qualifiedOnly`価値CODESYS 3デフォルトでは`false`歴史的な理由から。
`-c, --publish-symbols-in-container`	これが設定されている場合`true`すると、参照先のライブラリは、参照元のコンテナライブラリにシンボルを公開します。この設定を使用して、コンテナライブラリを作成する際に公開するシンボルを定義します。
`-o, --optional`	これが設定されている場合`true`そうすれば、ライブラリが利用できないという理由だけでコンパイラエラーが発生することはありません。（ただし、このライブラリのシンボルが不足しているためにコンパイラエラーが発生する場合があります。）
`--no-hash`	ファイルを指す相対パス参照に適用されます（`.zip`または`.compiled-library` ) SHA384 ハッシュ値の生成を抑制します。`Libraries.lock.json`ファイル。これは、参照されるファイルがパイプラインの早い段階で生成され、ハッシュ値が変化することが想定されるビルドパイプラインやテストCIパイプラインで役立ちます。
`-p, --include-prerelease`	これが設定されている場合`true`その場合、バージョンパターンは常に許可された範囲内のプレリリースバージョンに一致します。それ以外の場合は、デフォルトの動作が適用されます。「バージョンにプレリリースタグがある場合（例：`1.2.3-alpha.3`– 同じコンパレータが少なくとも 1 つある場合にのみ、コンパレータセットを満たすことが許可されます [ `major, minor, patch` ] タプルにはプレリリースタグも付いています。
`--link-all-content`	特殊な使用ケースのみ。`true`そうすれば、参照されている部分だけでなく、ライブラリ全体が統合されます。
`--default-resolution`	オプション（プレースホルダーに使用可能）。フラグを設定する場合は、図書館チェック時に使用される図書館IDまたはパターンを指定する必要があります。
`-d, --dry-run`	オプション。このフラグが設定されている場合、ファイルへの変更は一切行われません。代わりに、本来書き込まれるはずだったエントリがコンソールに表示されます。

CLIコマンド: `c4-cli library install`

アプリケーションのすべてのライブラリを解決し、不足しているライブラリをライブラリキャッシュに復元します。

使用法：

c4-cli library install [target-path] [OPTIONS]

例 28. 例

    c4-cli library i    
    c4-cli library install
    c4-cli library install C:/path/to/application.iecapp

議論	説明
`[target-path]`	コマンドを実行するコンテキストとなる、特定のアプリケーションのディレクトリへのパス。フラグが設定されていない場合、コマンドはデフォルトで現在のディレクトリに設定されます。有効なターゲットは、アプリケーションディレクトリ、`Libraries.json`ファイル、または`Libraries.lock.json`ファイル。

議論

説明

[target-path]

コマンドを実行するコンテキストとなる、特定のアプリケーションのディレクトリへのパス。フラグが設定されていない場合、コマンドはデフォルトで現在のディレクトリに設定されます。有効なターゲットは、アプリケーションディレクトリ、Libraries.jsonファイル、またはLibraries.lock.jsonファイル。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	コンソールへのログ出力のログレベルを設定します。例: `trace`、`debug`、`information`、`warning`、または`error`デフォルトでは、コンソールには何もログが出力されません（`none` )
`-d, --dry-run`	オプション。このフラグが設定されている場合、コマンドは通常どおり実行中に加えられた変更内容を報告しますが、ファイルシステム自体は変更されません。

CLIコマンド: `c4-cli library install-placeholder`

プレースホルダーへの新しい参照を追加しますLibraries.jsonファイルを変更するか、既存の参照を置き換えます。次に、アプリケーションのすべてのライブラリを解決し、不足しているライブラリをライブラリキャッシュに復元します。

使用法：

c4-cli library install-placeholder <namespace> <placeholder> [target-path] [OPTIONS]

例 29. 例

    c4-cli library install-placeholder SomeOtherNamespace some_placeholder C:/path/to/application.iecapp

議論	説明
`<namespace>`	インストールする特定のライブラリの名前空間。この引数を指定する場合は、次の引数も指定する必要があります。`library`。
`<placeholder>`	ライブラリを追加するプレースホルダー
`[target-path]`	コマンドを実行するコンテキストとなる、特定のアプリケーションのディレクトリへのパス。フラグが設定されていない場合、コマンドはデフォルトで現在のディレクトリに設定されます。有効なターゲットは、アプリケーションディレクトリ、`Libraries.json`ファイル、または`Libraries.lock.json`ファイル。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	コンソールへのログ出力のログレベルを設定します。例: `trace`、`debug`、`information`、`warning`、または`error`デフォルトでは、コンソールには何もログが出力されません（`none` )
`-d, --dry-run`	オプション。このフラグが設定されている場合、コマンドは通常どおり実行中に加えられた変更内容を報告しますが、ファイルシステム自体は変更されません。

CLIコマンド: `c4-cli library install-managed`

新しいマネージドライブラリ参照を追加しますLibraries.jsonファイルを変更するか、既存の参照を置き換えます。その後、アプリケーションのすべてのライブラリを解決し、不足しているライブラリをライブラリキャッシュに復元します。

使用法：

c4-cli library install-managed <namespace> <library> [target-path] [OPTIONS]

例 30. 例

    c4-cli library install-managed ToolsNamespace "AcmeTools, 1.2.3.4 (Acme Inc)" C:/path/to/application.iecapp

議論	説明
`<namespace>`	インストールする特定のライブラリの名前空間。特定のライブラリを1つだけインストールする場合は、このフラグを指定する必要があります。
`<library>`	ライブラリIDまたは追加するライブラリのパターン
`[target-path]`	コマンドを実行するコンテキストとなる、特定のアプリケーションのディレクトリへのパス。フラグが設定されていない場合、コマンドはデフォルトで現在のディレクトリに設定されます。有効なターゲットは、アプリケーションディレクトリ、`Libraries.json`ファイル、または`Libraries.lock.json`ファイル。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	コンソールへのログ出力のログレベルを設定します。例: `trace`、`debug`、`information`、`warning`、または`error`デフォルトでは、コンソールには何もログが出力されません（`none` )
`-d, --dry-run`	オプション。このフラグが設定されている場合、コマンドは通常どおり実行中に加えられた変更内容を報告しますが、ファイルシステム自体は変更されません。

CLIコマンド: `c4-cli library install-relative`

相対パスへの新しい参照を追加しますLibraries.jsonファイルを変更するか、既存の参照を置き換えます。次に、アプリケーションのすべてのライブラリを解決し、不足しているライブラリをライブラリキャッシュに復元します。

使用法：

c4-cli library install-relative <namespace> <path> [target-path] [OPTIONS]

例 31. 例

    c4-cli library install-relative ToolsNamespace ../some/relative/library.fbslib C:/path/to/application.iecapp

議論	説明
`<namespace>`	インストールする特定のライブラリの名前空間。この引数を指定する場合は、次の引数も指定する必要があります。`library`。
`<path>`	追加する（パックされた）ライブラリプロジェクトまたはコンパイル済みライブラリへのパス
`[target-path]`	コマンドを実行するコンテキストとなる、特定のアプリケーションのディレクトリへのパス。フラグが設定されていない場合、コマンドはデフォルトで現在のディレクトリに設定されます。有効なターゲットは、アプリケーションディレクトリ、`Libraries.json`ファイル、または`Libraries.lock.json`ファイル。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	コンソールへのログ出力のログレベルを設定します。例: `trace`、`debug`、`information`、`warning`、または`error`デフォルトでは、コンソールには何もログが出力されません（`none` )
`-d, --dry-run`	オプション。このフラグが設定されている場合、コマンドは通常どおり実行中に加えられた変更内容を報告しますが、ファイルシステム自体は変更されません。

CLIコマンド: `c4-cli library restore`

アプリケーションの不足しているライブラリをすべてライブラリキャッシュに復元します。

使用法：

c4-cli library restore [target-path] [library-id] [OPTIONS]

例 32. 例

    c4-cli library restore
    c4-cli library restore "AcmeTools, 1.2.3.4 (Acme Inc)"

議論	説明
`[target-path]`	コマンドを実行するコンテキストとなる、特定のアプリケーションのディレクトリへのパス。フラグが設定されていない場合、コマンドはデフォルトで現在のディレクトリに設定されます。有効なターゲットは、アプリケーションディレクトリ、`Libraries.json`ファイル、または`Libraries.lock.json`ファイル。
`[library-id]`	指定された場合、指定されたライブラリのみが復元されます（ただし、キャッシュに既に存在しない場合に限ります）。

議論

説明

[target-path]

[library-id]

指定された場合、指定されたライブラリのみが復元されます（ただし、キャッシュに既に存在しない場合に限ります）。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	コンソールへのログ出力のログレベルを設定します。例: `trace`、`debug`、`information`、`warning`、または`error`デフォルトでは、コンソールには何もログが出力されません（`none` )
`-d, --dry-run`	オプション。このフラグが設定されている場合、コマンドは通常どおり実行中に加えられた変更内容を報告しますが、ファイルシステム自体は変更されません。

CLIコマンド: `c4-cli library clean-install`

検証しますLibraries.lock.jsonファイルを削除し、ライブラリキャッシュを削除し、参照されているすべてのライブラリをインストールします。Libraries.lock.jsonファイル

使用法：

c4-cli library clean-install [target-path] [OPTIONS]

例 33. 例

    c4-cli library clean-install
    c4-cli library ci C:/path/to/application.iecapp/
    c4-cli library ci C:/path/to/device.fbsdev/ --dry-run

議論	説明
`[target-path]`	コマンドを実行するコンテキストとなる、特定のデバイスプロジェクトのディレクトリへのパス。値が指定されていない場合、コマンドはデフォルトで現在のディレクトリになります。有効なターゲットは、デバイスプロジェクトディレクトリ、アプリケーションディレクトリ、`Libraries.json`ファイル、または`Libraries.lock.json`ファイル。

議論

説明

[target-path]

コマンドを実行するコンテキストとなる、特定のデバイスプロジェクトのディレクトリへのパス。値が指定されていない場合、コマンドはデフォルトで現在のディレクトリになります。有効なターゲットは、デバイスプロジェクトディレクトリ、アプリケーションディレクトリ、Libraries.jsonファイル、またはLibraries.lock.jsonファイル。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	コンソールへのログ出力のログレベルを設定します。例: `trace`、`debug`、`information`、`warning`、または`error`デフォルトでは、コンソールには何もログが出力されません（`none` )
`-d, --dry-run`	オプション。このフラグが設定されている場合、コマンドは通常どおり実行中に加えられた変更内容を報告しますが、ファイルシステム自体は変更されません。

CLIコマンド: `c4-cli library uninstall`

指定された名前空間に関連付けられたライブラリをアンインストールし、ライブラリ自体と、そのライブラリのみが参照するすべての依存関係を削除します。

使用法：

c4-cli library uninstall <namespace> [target-path] [OPTIONS]

例 34. 例：

c4-cli library uninstall LibraryNamespace
c4-cli library uninstall LibraryNamespace C:/path/to/Libraries.json
c4-cli library uninstall LibraryNamespace C:/path/to/Libraries.lock.json
c4-cli library uninstall LibraryNamespace C:/path/to/Application.iecapp

議論	説明
`<namespace>`	アンインストールするライブラリの名前空間
`[target-path]`	への道`Libraries.json`ファイルまたは`Libraries.lock.json`ファイル、またはアンインストールコマンドを実行するアプリケーションディレクトリを指定します。これを省略した場合、コマンドはデフォルトで現在のディレクトリに実行されます。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	コンソールへのログ出力のログレベルを設定します。例: `trace`、`debug`、`information`、`warning`、または`error`デフォルトでは、コンソールには何もログが出力されません（`none` )
`-d, --dry-run`	オプション。ファイルへの変更は一切行われません。コマンドの実行状況ログのみがコンソールに表示されます。

CLIコマンド: `c4-cli library resolve`

指定されたアプリケーションのライブラリ参照を解決し、それを書き込みます。Libraries.lock.jsonファイル

使用法：

c4-cli library resolve [target-path] [namespace] [OPTIONS]

例 35. 例：

    c4-cli library resolve C:/path/to/Project.fbsdev/Application.iecapp/
    c4-cli library resolve C:/path/to/Project.fbsdev/Application.iecapp/ LibraryNamespace
    c4-cli library resolve C:/path/to/Project.fbsdev/Application.iecapp/ --all

議論	説明
`[target-path]`	コマンドを実行する特定のアプリケーションのディレクトリへのパス。値が指定されていない場合、コマンドはデフォルトで現在のディレクトリになります。有効なターゲットは、アプリケーションディレクトリ、ライブラリプロジェクトディレクトリ、`Libraries.json`ファイル、または`Libraries.lock.json`ファイル。
`[namespace]`	この引数が指定されている場合、指定された名前空間のみが解決され、解決されたライブラリのみがロックファイル内で更新されます。

議論

説明

[target-path]

コマンドを実行する特定のアプリケーションのディレクトリへのパス。値が指定されていない場合、コマンドはデフォルトで現在のディレクトリになります。有効なターゲットは、アプリケーションディレクトリ、ライブラリプロジェクトディレクトリ、Libraries.jsonファイル、またはLibraries.lock.jsonファイル。

[namespace]

この引数が指定されている場合、指定された名前空間のみが解決され、解決されたライブラリのみがロックファイル内で更新されます。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	任意の有効なログレベルを設定します。このフラグが指定されていない場合、ログ記録は無効になります。
`-d, --dry-run`	オプション。このフラグが設定されている場合、コマンドは通常どおり実行中に加えられた変更内容を報告しますが、ファイルシステム自体は変更されません。
`-a, --all`	フラグが設定されると、現在の`Libraries.lock.json`ファイルは破棄され、まったく新しいファイルが作成されます。

CLIコマンド: `c4-cli library remove`

名前空間によって識別されるライブラリ参照を削除します。Libraries.jsonファイル

使用法：

c4-cli library remove <namespace> [target-path] [OPTIONS]

例 36. 例：

c4-cli library remove ToolsNamespace C:/path/to/Libraries.json

議論	説明
`<namespace>`	削除するライブラリの名前空間
`[target-path]`	への道`Libraries.json`参照を削除するファイル、アプリケーションディレクトリ、またはライブラリディレクトリを指定します。これを省略した場合、コマンドはデフォルトで現在のディレクトリを指定します。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	任意の有効なログレベルを設定します。このフラグが指定されていない場合、ログ記録は無効になります。

CLIコマンド: `c4-cli library prune`

ライブラリへの未使用の間接参照を削除します。Libraries.lock.jsonファイル

使用法：

c4-cli library prune [target-path] [OPTIONS]

例 37. 例：

c4-cli library prune C:/path/to/Libraries.lock.json

議論	説明
`[target-path]`	コマンドのターゲットへのパス。これを省略すると、コマンドはデフォルトで現在のディレクトリになります。有効なターゲットは、アプリケーションディレクトリ、`Libraries.json`ファイル、または`Libraries.lock.json`ファイル。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	任意の有効なログレベルを設定します。このフラグが指定されていない場合、ログ記録は無効になります。
`-d, --dry-run`	オプション。このフラグが設定されている場合、コマンドは通常どおり実行中に加えられた変更内容を報告しますが、ファイルシステム自体は変更されません。

CLIコマンド: `c4-cli library outdated`

リポジトリをチェックして、インストールされているライブラリ（全般または特定のライブラリ）が古いかどうかを判断します。

使用法：

c4-cli library outdated [target-path] [library-id] [OPTIONS]

例 38. 例：

    c4-cli library outdated
    c4-cli library outdated C:/path/to/application.iecapp/
    c4-cli library outdated . "AcmeTools, 1.2.3.4 (Acme Inc)" --all --include-prerelease

議論	説明
`[target-path]`	コマンドのターゲットへのパス。これを省略すると、コマンドはデフォルトで現在のディレクトリになります。有効なターゲットは、アプリケーションディレクトリ、`Libraries.json`ファイル、または`Libraries.lock.json`ファイル。
`[library-id]`	より新しいバージョンを確認する必要があるライブラリのID

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	任意の有効なログレベルを設定します。このフラグが指定されていない場合、ログ記録は無効になります。
`-a, --all`	このフラグが設定されている場合、古い間接参照も報告されます。
`-p, --include-prerelease`	このフラグが設定されている場合、プレリリース版ライブラリも対象となります。

CLIコマンド: `c4-cli library list`

定義されたアプリケーションのすべての参照を一覧表示します。

使用法：

 c4-cli library list [target-path] [OPTIONS]

例 39. 例：

    c4-cli library list
    c4-cli library list C:/path/to/application.iecapp/
    c4-cli library list --all

議論	説明
`[target-path]`	への道`Libraries.lock.json`参照をリストする必要があるファイル、またはそれを含むアプリケーションディレクトリ`Libraries.lock.json`ファイルを指定します。これを省略した場合、コマンドはデフォルトで現在のディレクトリを指定します。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	コンソールへのログ出力のログレベルを設定します。例: `trace`、`debug`、`information`、`warning`、または`error`デフォルトでは、コンソールには何もログが出力されません（`none` )
`-a, --all`	このフラグが設定されている場合、すべての間接参照も一覧表示されます。

CLIコマンド: `c4-cli library explain`

指定されたライブラリが参照される原因となっている依存関係の連鎖を表示します。

使用法：

c4-cli library explain <library> [target-path] [OPTIONS]

例 40. 例：

    c4-cli library explain "AcmeTools, 1.2.3.4 (Acme Inc)"
    c4-cli library explain "AcmeTools, 1.2.3.4 (Acme Inc)" C:/path/to/Libraries.lock.json
    c4-cli library explain "AcmeTools, 1.2.3.4 (Acme Inc)" C:/path/to/Libraries.lock.json --show-paths

議論	説明
`<library>`	依存関係の連鎖を表示するライブラリを指定します。ライブラリIDまたは名前空間で指定できます。
`[target-path]`	への道`Libraries.lock.json`それぞれのライブラリが参照されているファイル、または`Libraries.json`ファイルの隣`Libraries.lock.json`ファイル、またはアプリケーションディレクトリには、`Libraries.lock.json`ファイルを指定します。これを省略した場合、コマンドはデフォルトで現在のディレクトリを指定します。

議論

説明

<library>

依存関係の連鎖を表示するライブラリを指定します。ライブラリIDまたは名前空間で指定できます。

[target-path]

への道Libraries.lock.jsonそれぞれのライブラリが参照されているファイル、またはLibraries.jsonファイルの隣Libraries.lock.jsonファイル、またはアプリケーションディレクトリには、Libraries.lock.jsonファイルを指定します。これを省略した場合、コマンドはデフォルトで現在のディレクトリを指定します。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	コンソールへのログ出力のログレベルを設定します。例: `trace`、`debug`、`information`、`warning`、または`error`デフォルトでは、コンソールには何もログが出力されません（`none` )
`-p, --show-paths`	このフラグが設定されている場合、表示されている参照のパスも表示されます。

CLIコマンド: `c4-cli library pack`

指定されたソースライブラリアーカイブを作成しますCODESYS 4ライブラリプロジェクトフォルダ。有効なライブラリである必要があります。

使用法：

    c4-cli library pack [target-path] [zip-path] [OPTIONS]

例 41. 例：

    c4-cli library pack
    c4-cli library pack C:/path/to/library.fbslib C:/path/to/DestinationDirectory/
    c4-cli library pack C:/path/to/library.fbslib
    c4-cli library pack . C:/path/to/DestinationDirectory/

議論	説明
`[target-path]`	オプションパッケージ化するライブラリプロジェクトフォルダーへのパス。これを省略すると、コマンドはデフォルトで現在のディレクトリを使用します。`[zip-path]`設定されている場合は、`.`これは現在のディレクトリのプレースホルダーとしてここに表示されます。
`[zip-path]`	圧縮されたライブラリアーカイブが保存されるディレクトリ。このディレクトリを省略した場合、アーカイブはライブラリと同じディレクトリに作成されます。

議論

説明

[target-path]

オプション

パッケージ化するライブラリプロジェクトフォルダーへのパス。これを省略すると、コマンドはデフォルトで現在のディレクトリを使用します。[zip-path]設定されている場合は、.これは現在のディレクトリのプレースホルダーとしてここに表示されます。

[zip-path]

圧縮されたライブラリアーカイブが保存されるディレクトリ。このディレクトリを省略した場合、アーカイブはライブラリと同じディレクトリに作成されます。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	コンソールへのログ出力のログレベルを設定します。例: `trace`、`debug`、`information`、`warning`、または`error`デフォルトでは、コンソールには何もログが出力されません（`none` )

CLIコマンド: `c4-cli library save-compiled`

特定のライブラリをコンパイル済みライブラリとして保存します。

使用法：

    c4-cli library save-compiled <library-path> <destination-path> [OPTIONS]

例 42. 例：

    c4-cli library save-compiled C:/path/to/library.fbslib/ C:/path/to/library.compiled-library-v3

議論	説明
`<library-path>`	コンパイルするライブラリへのパス。有効なターゲットは、ライブラリプロジェクトディレクトリ、`Libraries.json`ファイル、または`Libraries.lock.json`ファイルを使用します。`.`現在のディレクトリに対して。
`<destination-path>`	コンパイルされたライブラリが保存されるパス。これがディレクトリの場合、コンパイルされたライブラリはという名前のファイルに保存されます。`{LibraryName}.compiled-library-v3`ディレクトリ内。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	コンソールへのログ出力のログレベルを設定します。例: `trace`、`debug`、`information`、`warning`、または`error`デフォルトでは、コンソールには何もログが出力されません（`none` )
`-d, --dry-run`	オプション。このフラグが設定されている場合、コマンドは通常どおり実行中に加えられた変更内容を報告しますが、ファイルシステム自体は変更されません。
`--overwrite`	宛先ファイルが既に存在する場合は上書きします。
`--compiler-version`	定義済みのコンパイラバージョンを使用します
`--set-version`	ライブラリのバージョンを上書きします。このフラグが設定されている場合は、semver バージョンの代わりにこの値を使用します。`ProjectInfo.json`ライブラリのファイル。
`--assert-version`	バージョンをチェックします`ProjectInfo.json`ファイルを確認し、指定されたバージョンと一致しない場合は処理を中止します。
`--compression-level`	ZIPアーカイブの圧縮レベル
`--set-released-flag`	このフラグが設定されている場合、コンパイルされたライブラリでは「Released」フラグが指定された値に上書きされます。このフラグが設定されている場合、空のプレリリースラベルフィールドも強制されます。この場合、ライブラリ生成は、以下のいずれかに該当する場合に失敗します。`--set-prerelease-labels`オプションに空でない文字列が設定されている場合、または`SemVer version`分野で`ProjectInfo.json`ファイルには、空の文字列で明示的に上書きされていないプレリリースラベルが指定されています。`--set-prerelease-labels`オプション。
`--set-prerelease-labels`	プレリリースラベルを上書きします。このフラグが設定されている場合、この値は semver プレリリースラベルの代わりに使用されます。`ProjectInfo.json`ライブラリのファイル。値が次のように設定されている場合`--`そうすれば、たとえラベルが指定されていても、プレリリースラベルのないライブラリが作成されます。`ProjectInfo.json`ファイル。空でないプレリリースラベルは`--set-released-flag` ; したがって、`--set-prerelease-labels`空でないラベルと一緒に使用することはできません`--set-released-flag`フラグがtrueに設定されている場合、または`released`フラグはプロジェクト情報で設定されます。この値には先頭の文字は含まれません。`-`これは、セマンティックバージョニング表記において、バージョンラベルとプレリリースラベルを区別するものです。
`--set-buildinfo-labels`	ビルド情報ラベルを上書きします。このフラグが設定されている場合、この値は、ビルド情報ラベルの semver バージョンの代わりに使用されます。`ProjectInfo.json`ライブラリのファイル。値が次のように設定されている場合`--`すると、たとえラベルが指定されていても、ビルド情報ラベルのないライブラリが作成されます。`ProjectInfo.json`ファイル。この値には先頭の文字は含まれません。`+`これは、セマンティックバージョニング表記において、バージョンラベルまたはプレリリースラベルをビルド情報部分から分離するものです。
`--assert-prerelease-labels`	プレリリースラベルをチェックします`semver version`分野で`ProjectInfo.json`ライブラリのファイルであり、指定されたラベルと一致しない場合はプロセスを中止します。パイプラインでの健全性チェックに使用できます。値が設定されている場合`--`これにより、`ProjectInfo.json`ファイルにはプレリリースラベルが指定されていません。
`--assert-buildinfo-labels`	semver バージョンフィールドのビルド情報ラベルをチェックします。`ProjectInfo.json`ライブラリのファイルであり、指定されたラベルと一致しない場合はプロセスを中止します。パイプラインでの健全性チェックに使用できます。値が設定されている場合`--`これにより、`ProjectInfo.json`ファイルにはビルド情報ラベルが指定されていません。この値には先頭の`+`これは、セマンティックバージョニング表記において、バージョンラベルまたはプレリリースラベルをビルド情報部分から分離するものです。
`--include-libdoc`	libdocツールチェーンによって作成されたメインのコンパイル済みドキュメントアーカイブへのパス。通常は、`doc.lmd`または`__lmd__.aux[iliary]`同じフォルダ内の、命名規則に準拠したファイルをコンパイルします。`__lmd__.aux[iliary]`また、`` ISO言語/国コードに対応します。

CLIコマンド: `c4-cli library verify`

ライブラリの解決がLibraries.lock.json依然として有効であり、Libraries.jsonライブラリキャッシュ内のすべてのライブラリにアクセス可能であること、重複する参照、更新されたパッケージ、または孤立したパッケージが存在しないことを確認します。

使用法：

c4-cli library verify [target-path] [OPTIONS]

例 43. 例：

    c4-cli library verify C:/path/to/application.iecapp/

議論	説明
`[target-path]`	コマンドのターゲットへのパス。これを省略すると、コマンドはデフォルトで現在のディレクトリになります。有効なターゲットは、アプリケーションディレクトリ、`Libraries.json`ファイル、または`Libraries.lock.json`ファイル。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	コンソールへのログ出力のログレベルを設定します。例: `trace`、`debug`、`information`、`warning`、または`error`デフォルトでは、コンソールには何もログが出力されません（`none` )

CLIコマンド: `c4-cli library check`

ライブラリプロジェクトをチェックし、検出されたエラーと警告を報告します。

使用法：

c4-cli library check [library-path] [OPTIONS]

議論	説明
`[library-path]`	チェック対象となるライブラリプロジェクトへのパス。省略した場合、コマンドはデフォルトで現在のディレクトリを参照します。

オプション	説明
`-h, --help`	コマンドのヘルプを表示します
`-v, --verbose`	コンソールでのログ記録を有効にします。`information`レベル; 短縮形`--log-level=information`
`--log-level`	コンソールへのログ出力のログレベルを設定します。例: `trace`、`debug`、`information`、`warning`、または`error`デフォルトでは、コンソールには何もログが出力されません（`none` )
`-d, --dry-run`	オプション。このフラグが設定されている場合、コマンドは通常どおり実行中に加えられた変更内容を報告しますが、ファイルシステム自体は変更されません。
`--pointer-size`	想定されるポインタサイズ（ビット単位）。`32`または`64`（デフォルト値）`32`）
`--compiler-defines`	設定するコンパイラ定義のカンマ区切りリスト

このセクションの内容:

CLIコマンド: c4-cli library

CLIコマンド: c4-cli library set-managed

CLIコマンド: c4-cli library set-relative

CLIコマンド: c4-cli library set-placeholder

CLIコマンド: c4-cli library install

CLIコマンド: c4-cli library install-placeholder

CLIコマンド: c4-cli library install-managed

CLIコマンド: c4-cli library install-relative

CLIコマンド: c4-cli library restore

CLIコマンド: c4-cli library clean-install

CLIコマンド: c4-cli library uninstall

CLIコマンド: c4-cli library resolve

CLIコマンド: c4-cli library remove

CLIコマンド: c4-cli library prune

CLIコマンド: c4-cli library outdated

CLIコマンド: c4-cli library list

CLIコマンド: c4-cli library explain

CLIコマンド: c4-cli library pack

CLIコマンド: c4-cli library save-compiled

CLIコマンド: c4-cli library verify

CLIコマンド: c4-cli library check

検索結果

CLIコマンド: `c4-cli library`

CLIコマンド: `c4-cli library set-managed`

CLIコマンド: `c4-cli library set-relative`

CLIコマンド: `c4-cli library set-placeholder`

CLIコマンド: `c4-cli library install`

CLIコマンド: `c4-cli library install-placeholder`

CLIコマンド: `c4-cli library install-managed`

CLIコマンド: `c4-cli library install-relative`

CLIコマンド: `c4-cli library restore`

CLIコマンド: `c4-cli library clean-install`

CLIコマンド: `c4-cli library uninstall`

CLIコマンド: `c4-cli library resolve`

CLIコマンド: `c4-cli library remove`

CLIコマンド: `c4-cli library prune`

CLIコマンド: `c4-cli library outdated`

CLIコマンド: `c4-cli library list`

CLIコマンド: `c4-cli library explain`

CLIコマンド: `c4-cli library pack`

CLIコマンド: `c4-cli library save-compiled`

CLIコマンド: `c4-cli library verify`

CLIコマンド: `c4-cli library check`