命令行界面命令：`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`	检查库项目并报告检测到的任何错误和警告。

命令行界面命令：`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`– 那么只有当至少有一个具有相同[的比较器]时，才允许满足比较器集。`major, minor, patch`元组也带有预发布标签。
`--link-all-content`	仅限特殊用途。如果设置为`true`这样一来，整个库都将被集成，而不仅仅是引用的部分。
`--default-resolution`	可选（允许用作占位符）。设置此标志后，它必须是库 ID 或模式，将在库检查期间使用。
`-d, --dry-run`	可选。启用此标志后，不会对文件进行任何更改。而是将原本要写入的条目打印到控制台。

命令行界面命令：`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`– 那么只有当至少有一个具有相同[的比较器]时，才允许满足比较器集。`major, minor, patch`元组也带有预发布标签。
`--link-all-content`	仅限特殊用途。如果设置为`true`这样一来，整个库都将被集成，而不仅仅是引用的部分。
`--default-resolution`	可选（允许用作占位符）。设置此标志后，它必须是库 ID 或模式，将在库检查期间使用。
`-d, --dry-run`	可选。启用此标志后，不会对文件进行任何更改。而是将原本要写入的条目打印到控制台。

命令行界面命令：`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`– 那么只有当至少有一个具有相同[的比较器]时，才允许满足比较器集。`major, minor, patch`元组也带有预发布标签。
`--link-all-content`	仅限特殊用途。如果设置为`true`这样一来，整个库都将被集成，而不仅仅是引用的部分。
`--default-resolution`	可选（允许用作占位符）。设置此标志后，它必须是库 ID 或模式，将在库检查期间使用。
`-d, --dry-run`	可选。启用此标志后，不会对文件进行任何更改。而是将原本要写入的条目打印到控制台。

命令行界面命令：`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`文件。

选项	描述
`-h, --help`	打印该命令的帮助信息
`-v, --verbose`	启用控制台日志记录`information`级别；简称`--log-level=information`
`--log-level`	设置控制台日志记录的日志级别，例如`trace`，`debug`，`information`，`warning`，或者`error`默认情况下，控制台不会记录任何内容（`none`）。
`-d, --dry-run`	可选。设置此标志后，命令将按常规方式报告执行期间所做的更改。但是，文件系统不会被修改。

命令行界面命令：`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`	可选。设置此标志后，命令将按常规方式报告执行期间所做的更改。但是，文件系统不会被修改。

命令行界面命令：`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>`	要安装的单个特定库的命名空间。安装单个特定库时必须指定此标志。
`<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`	可选。设置此标志后，命令将按常规方式报告执行期间所做的更改。但是，文件系统不会被修改。

命令行界面命令：`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`	可选。设置此标志后，命令将按常规方式报告执行期间所做的更改。但是，文件系统不会被修改。

命令行界面命令：`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]`	如果提供了指定库，则只会恢复指定的库（只要该库尚未存在于缓存中）。

选项	描述
`-h, --help`	打印该命令的帮助信息
`-v, --verbose`	启用控制台日志记录`information`级别；简称`--log-level=information`
`--log-level`	设置控制台日志记录的日志级别，例如`trace`，`debug`，`information`，`warning`，或者`error`默认情况下，控制台不会记录任何内容（`none`）。
`-d, --dry-run`	可选。设置此标志后，命令将按常规方式报告执行期间所做的更改。但是，文件系统不会被修改。

命令行界面命令：`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`文件。

选项	描述
`-h, --help`	打印该命令的帮助信息
`-v, --verbose`	启用控制台日志记录`information`级别；简称`--log-level=information`
`--log-level`	设置控制台日志记录的日志级别，例如`trace`，`debug`，`information`，`warning`，或者`error`默认情况下，控制台不会记录任何内容（`none`）。
`-d, --dry-run`	可选。设置此标志后，命令将按常规方式报告执行期间所做的更改。但是，文件系统不会被修改。

命令行界面命令：`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`	可选。不会对文件进行任何更改。只会将命令的进度日志打印到控制台。

命令行界面命令：`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]`	如果提供了此参数，则只会解析指定的命名空间，并且只会更新锁定文件中已解析的库。

选项	描述
`-h, --help`	打印该命令的帮助信息
`-v, --verbose`	启用控制台日志记录`information`级别；简称`--log-level=information`
`--log-level`	设置为任何有效的日志级别。如果未指定此标志，则禁用日志记录。
`-d, --dry-run`	可选。设置此标志后，命令将按常规方式报告执行期间所做的更改。但是，文件系统不会被修改。
`-a, --all`	当标志位被设置时，当前`Libraries.lock.json`该文件将被丢弃，并重新写入一个全新的文件。

命令行界面命令：`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`	设置为任何有效的日志级别。如果未指定此标志，则禁用日志记录。

命令行界面命令：`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`	可选。设置此标志后，命令将按常规方式报告执行期间所做的更改。但是，文件系统不会被修改。

命令行界面命令：`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`	如果设置了该标志，预发布库也会被考虑在内。

命令行界面命令：`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`	启用该标志后，所有间接引用也将被列出。

命令行界面命令：`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`文件。如果省略此参数，则命令默认使用当前目录。

选项	描述
`-h, --help`	打印该命令的帮助信息
`-v, --verbose`	启用控制台日志记录`information`级别；简称`--log-level=information`
`--log-level`	设置控制台日志记录的日志级别，例如`trace`，`debug`，`information`，`warning`，或者`error`默认情况下，控制台不会记录任何内容（`none`）。
`-p, --show-paths`	启用该标志后，还会显示所显示引用的路径。

命令行界面命令：`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`）。

命令行界面命令：`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>`	编译后的库文件将保存到该路径。如果这是一个目录，则编译后的库文件将保存到名为 `.lib` 的文件中。`{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`	覆盖库版本。如果设置了此标志，则使用此值而不是语义化版本号。`ProjectInfo.json`库文件。
`--assert-version`	检查版本`ProjectInfo.json`如果文件与指定版本不匹配，则中止该进程。
`--compression-level`	ZIP压缩包的压缩级别
`--set-released-flag`	如果设置了此标志，则编译后的库中的“已发布”标志将被覆盖为指定的值。如果设置此标志，则还会强制预发布标签字段为空。在这种情况下，如果满足以下任一条件，库生成将会失败：`--set-prerelease-labels`选项设置为非空字符串，或者`SemVer version`领域`ProjectInfo.json`该文件指定了预发布标签，这些标签尚未通过以下方式显式地用空字符串覆盖：`--set-prerelease-labels`选项。
`--set-prerelease-labels`	覆盖预发布版本标签。如果设置此标志，则将使用此值代替语义化版本预发布版本标签。`ProjectInfo.json`库文件。如果该值设置为`--`那么，即使在指定了标签，创建的库也不会带有预发布标签。`ProjectInfo.json`文件。非空的预发布标签与`--set-released-flag` ; 所以，`--set-prerelease-labels`当标签非空时，不能与此一起使用。`--set-released-flag`标志位设置为 true，或者`released`项目信息中已设置标志。此值不包括前导项。`-`它以语义化版本控制的方式分隔版本标签和预发布标签。
`--set-buildinfo-labels`	覆盖构建信息标签。如果设置此标志，则此值将代替语义化版本构建信息标签。`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 语言/国家代码相对应。

命令行界面命令：`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`）。

命令行界面命令：`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`	以逗号分隔的编译器定义列表，用于设置

本节内容如下:

命令行界面命令：c4-cli library

命令行界面命令：c4-cli library set-managed

命令行界面命令：c4-cli library set-relative

命令行界面命令：c4-cli library set-placeholder

命令行界面命令：c4-cli library install

命令行界面命令：c4-cli library install-placeholder

命令行界面命令：c4-cli library install-managed

命令行界面命令：c4-cli library install-relative

命令行界面命令：c4-cli library restore

命令行界面命令：c4-cli library clean-install

命令行界面命令：c4-cli library uninstall

命令行界面命令：c4-cli library resolve

命令行界面命令：c4-cli library remove

命令行界面命令：c4-cli library prune

命令行界面命令：c4-cli library outdated

命令行界面命令：c4-cli library list

命令行界面命令：c4-cli library explain

命令行界面命令：c4-cli library pack

命令行界面命令：c4-cli library save-compiled

命令行界面命令：c4-cli library verify

命令行界面命令：c4-cli library check

搜索结果