Skip to main content

Commande CLI : c4-cli library

Modifications des références de la bibliothèque

Usage:

  c4-cli library [OPTIONS] <COMMAND>
Exemple 24. Exemples
    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


Options

Description

-h, --help

Affiche l'aide relative à la commande

Commande

Description

set-managed <namespace> <library>

Ajoute une nouvelle référence à une bibliothèque gérée à la Libraries.json fichier ou remplace une référence existante

set-relative <namespace> <path>

Ajoute une nouvelle référence à un chemin relatif vers le Libraries.json fichier ou remplace une référence existante

set-placeholder <namespace> <placeholder>

Ajoute une nouvelle référence d'espace réservé à la Libraries.json fichier ou remplace une référence existante

install

Résout tous les problèmes liés aux bibliothèques de l'application et restaure les bibliothèques manquantes dans le cache de bibliothèques.

install-placeholder <namespace> <placeholder>

Ajoute une nouvelle référence à un espace réservé dans le Libraries.json modifie un fichier ou remplace une référence existante. Ensuite, résout toutes les bibliothèques de l'application et restaure les bibliothèques manquantes dans le cache de bibliothèques.

install-managed <namespace> <library>

Ajoute une nouvelle référence à une bibliothèque gérée à la Libraries.json modifie un fichier ou remplace une référence existante. Ensuite, résout toutes les bibliothèques de l'application et restaure les bibliothèques manquantes dans le cache de bibliothèques.

install-relative <namespace> <path>

Ajoute une nouvelle référence à un chemin relatif vers le Libraries.json modifie un fichier ou remplace une référence existante. Ensuite, résout toutes les bibliothèques de l'application et restaure les bibliothèques manquantes dans le cache de bibliothèques.

restore

Restaure toutes les bibliothèques manquantes d'une application dans le cache de bibliothèques

clean-install

Vérifie le Libraries.lock.json fichiers, supprime le cache de la bibliothèque et installe toutes les bibliothèques référencées par le Libraries.lock.json fichiers

library uninstall <namespace> [target-path]

Désinstalle la bibliothèque associée à un espace de noms spécifié. Supprime la bibliothèque elle-même ainsi que toutes les dépendances référencées exclusivement par cette bibliothèque.

resolve

Résout les références de bibliothèque pour une application spécifiée et les écrit dans le Libraries.lock.json déposer

remove <namespace> [target-path]

Supprime la référence à la bibliothèque identifiée par l'espace de noms de la Libraries.json déposer

prune

Supprime les références indirectes inutilisées aux bibliothèques de la Libraries.lock.json déposer

outdated

Vérifie les dépôts pour déterminer si des bibliothèques installées (de manière générale ou spécifique) sont actuellement obsolètes.

list

Liste toutes les références d'une application spécifiée

explain <library>

Affiche la chaîne de dépendances qui fait qu'une bibliothèque spécifiée est référencée.

pack

Crée une archive de bibliothèque source à partir de la bibliothèque spécifiée. CODESYS 4 Dossier du projet de bibliothèque. Il doit s'agir d'une bibliothèque valide.

save-compiled <library-path> <destination-path>

Enregistre une bibliothèque spécifiée en tant que bibliothèque compilée

verify

Vérifie si les résolutions de la bibliothèque dans Libraries.lock.json sont toujours valides et correspondent toujours aux Libraries.json Vérifie que toutes les bibliothèques sont accessibles dans le cache de bibliothèques et qu'il n'existe aucune référence dupliquée, aucun paquetage mis à jour ni aucun paquetage orphelin.

check

Vérifie le projet de bibliothèque et signale les erreurs et avertissements détectés.

Commande CLI : c4-cli library set-managed

Ajoute une nouvelle référence à une bibliothèque gérée à la Libraries.json fichier ou remplace une référence existante.

Usage:

c4-cli library set-managed <namespace> <library> [target-path] [OPTIONS]
Exemple 25. Exemples
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


Arguments

Description

<namespace>

Espace de noms de la bibliothèque à modifier

<library>

Identifiant ou modèle de la bibliothèque à ajouter

[target-path]

Chemin vers un Libraries.json Indiquez le fichier, le répertoire de l'application ou le répertoire de la bibliothèque où la référence sera créée ou remplacée. Si vous omettez cette option, la commande utilisera le répertoire courant par défaut.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation pour l'enregistrement dans la console, par exemple : trace, debug, information, warning, ou error Par défaut, rien n'est consigné dans la console (none).

-u, --allow-unqualified-access

Si cette option est activée true, la bibliothèque est alors accessible sans qualification d'espace de noms. La valeur recommandée pour le nouveau code est false Cela correspond à la négation de qualifiedOnly valeur dans CODESYS 3, qui par défaut à false pour des raisons historiques.

-c, --publish-symbols-in-container

Si cette option est activée true La bibliothèque référencée publiera alors ses symboles dans la bibliothèque conteneur référençante. Utilisez ce paramètre pour définir les symboles publiés lors de la création d'une bibliothèque conteneur.

-o, --optional

Si cette option est activée true Dans ce cas, aucune erreur de compilation ne se produira simplement parce que la bibliothèque est indisponible. (Toutefois, des erreurs de compilation peuvent survenir en raison de symboles manquants dans cette bibliothèque.)

--no-hash

S'applique aux références de chemin relatif qui pointent vers des fichiers (.zip ou .compiled-librarySupprime la génération des valeurs de hachage SHA384 dans le Libraries.lock.json fichier. Ceci est utile dans les pipelines de construction et les pipelines d'intégration continue de test lorsque le fichier référencé est généré plus tôt dans le pipeline et qu'un hachage variable est attendu.

-p, --include-prerelease

Si cette option est activée true Dans ce cas, les modèles de version correspondront toujours aux versions préliminaires comprises dans la plage autorisée. Sinon, le comportement par défaut s'applique : « Si une version possède une étiquette de préversion – par exemple 1.2.3-alpha.3 – alors il ne sera autorisé à satisfaire les ensembles de comparateurs que si au moins un comparateur avec le même [major, minor, patch ] Le tuple possède également une étiquette de prépublication.

--link-all-content

Réservé à des cas d'utilisation particuliers. Si cette option est activée true, alors la bibliothèque entière sera intégrée, et non seulement les parties référencées.

--default-resolution

Facultatif (autorisé pour les espaces réservés). Si cet indicateur est défini, il doit s'agir d'un identifiant ou d'un modèle de bibliothèque qui sera utilisé lors de la vérification de la bibliothèque.

-d, --dry-run

Optionnel. Si cette option est activée, aucune modification ne sera apportée aux fichiers. À la place, l'entrée qui serait écrite sera affichée dans la console.

Commande CLI : c4-cli library set-relative

Ajoute une nouvelle référence à un chemin relatif vers le Libraries.json fichier ou remplace une référence existante

Usage:

c4-cli library set-relative <namespace> <path> [target-path] [OPTIONS]
Exemple 26. Exemples
    c4-cli library set-relative ToolsNamespace C:/path/to/library.fbslib/ C:/path/to/Libraries.json


Arguments

Description

<namespace>

Espace de noms de la bibliothèque à modifier

<path>

Chemin d'accès au projet de bibliothèque (compressée) ou à la bibliothèque compilée à ajouter

[target-path]

Chemin vers un Libraries.json Indiquez le fichier, le répertoire de l'application ou le répertoire de la bibliothèque où la référence sera créée ou remplacée. Si vous omettez cette option, la commande utilisera le répertoire courant par défaut.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation pour l'enregistrement dans la console, par exemple : trace, debug, information, warning, ou error Par défaut, rien n'est consigné dans la console (none).

-u, --allow-unqualified-access

Si cette option est activée true, la bibliothèque est alors accessible sans qualification d'espace de noms. La valeur recommandée pour le nouveau code est false Cela correspond à la négation de qualifiedOnly valeur dans CODESYS 3, qui par défaut à false pour des raisons historiques.

-c, --publish-symbols-in-container

Si cette option est activée true La bibliothèque référencée publiera alors ses symboles dans la bibliothèque conteneur référençante. Utilisez ce paramètre pour définir les symboles publiés lors de la création d'une bibliothèque conteneur.

-o, --optional

Si cette option est activée true Dans ce cas, aucune erreur de compilation ne se produira simplement parce que la bibliothèque est indisponible. (Toutefois, des erreurs de compilation peuvent survenir en raison de symboles manquants dans cette bibliothèque.)

--no-hash

S'applique aux références de chemin relatif qui pointent vers des fichiers (.zip ou .compiled-librarySupprime la génération des valeurs de hachage SHA384 dans le Libraries.lock.json fichier. Ceci est utile dans les pipelines de construction et les pipelines d'intégration continue de test lorsque le fichier référencé est généré plus tôt dans le pipeline et qu'un hachage variable est attendu.

-p, --include-prerelease

Si cette option est activée true Dans ce cas, les modèles de version correspondront toujours aux versions préliminaires comprises dans la plage autorisée. Sinon, le comportement par défaut s'applique : « Si une version possède une étiquette de préversion – par exemple 1.2.3-alpha.3 – alors il ne sera autorisé à satisfaire les ensembles de comparateurs que si au moins un comparateur avec le même [major, minor, patch ] Le tuple possède également une étiquette de prépublication.

--link-all-content

Réservé à des cas d'utilisation particuliers. Si cette option est activée true, alors la bibliothèque entière sera intégrée, et non seulement les parties référencées.

--default-resolution

Facultatif (autorisé pour les espaces réservés). Si cet indicateur est défini, il doit s'agir d'un identifiant ou d'un modèle de bibliothèque qui sera utilisé lors de la vérification de la bibliothèque.

-d, --dry-run

Optionnel. Si cette option est activée, aucune modification ne sera apportée aux fichiers. À la place, l'entrée qui serait écrite sera affichée dans la console.

Commande CLI : c4-cli library set-placeholder

Ajoute une nouvelle référence d'espace réservé à la Libraries.json fichier ou remplace une référence existante

Usage:

c4-cli library set-placeholder <namespace> <placeholder> [target-path] [OPTIONS]
Exemple 27. Exemples
    c4-cli library set-placeholder ToolsNamespace some_placeholder C:/path/to/Libraries.json


Arguments

Description

<namespace>

Espace de noms de la bibliothèque à modifier

<placeholder>

Espace réservé pour la bibliothèque à ajouter

[target-path]

Chemin vers un Libraries.json Indiquez le fichier, le répertoire de l'application ou le répertoire de la bibliothèque où la référence sera créée ou remplacée. Si vous omettez cette option, la commande utilisera le répertoire courant par défaut.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation pour l'enregistrement dans la console, par exemple : trace, debug, information, warning, ou error Par défaut, rien n'est consigné dans la console (none).

-u, --allow-unqualified-access

Si cette option est activée true, la bibliothèque est alors accessible sans qualification d'espace de noms. La valeur recommandée pour le nouveau code est false Cela correspond à la négation de qualifiedOnly valeur dans CODESYS 3, qui par défaut à false pour des raisons historiques.

-c, --publish-symbols-in-container

Si cette option est activée true La bibliothèque référencée publiera alors ses symboles dans la bibliothèque conteneur référençante. Utilisez ce paramètre pour définir les symboles publiés lors de la création d'une bibliothèque conteneur.

-o, --optional

Si cette option est activée true Dans ce cas, aucune erreur de compilation ne se produira simplement parce que la bibliothèque est indisponible. (Toutefois, des erreurs de compilation peuvent survenir en raison de symboles manquants dans cette bibliothèque.)

--no-hash

S'applique aux références de chemin relatif qui pointent vers des fichiers (.zip ou .compiled-librarySupprime la génération des valeurs de hachage SHA384 dans le Libraries.lock.json fichier. Ceci est utile dans les pipelines de construction et les pipelines d'intégration continue de test lorsque le fichier référencé est généré plus tôt dans le pipeline et qu'un hachage variable est attendu.

-p, --include-prerelease

Si cette option est activée true Dans ce cas, les modèles de version correspondront toujours aux versions préliminaires comprises dans la plage autorisée. Sinon, le comportement par défaut s'applique : « Si une version possède une étiquette de préversion – par exemple 1.2.3-alpha.3 – alors il ne sera autorisé à satisfaire les ensembles de comparateurs que si au moins un comparateur avec le même [major, minor, patch ] Le tuple possède également une étiquette de prépublication.

--link-all-content

Réservé à des cas d'utilisation particuliers. Si cette option est activée true, alors la bibliothèque entière sera intégrée, et non seulement les parties référencées.

--default-resolution

Facultatif (autorisé pour les espaces réservés). Si cet indicateur est défini, il doit s'agir d'un identifiant ou d'un modèle de bibliothèque qui sera utilisé lors de la vérification de la bibliothèque.

-d, --dry-run

Optionnel. Si cette option est activée, aucune modification ne sera apportée aux fichiers. À la place, l'entrée qui serait écrite sera affichée dans la console.

Commande CLI : c4-cli library install

Résout tous les problèmes liés aux bibliothèques de l'application et restaure les bibliothèques manquantes dans le cache des bibliothèques.

Usage:

c4-cli library install [target-path] [OPTIONS]
Exemple 28. Exemples
    c4-cli library i    
    c4-cli library install
    c4-cli library install C:/path/to/application.iecapp


Arguments

Description

[target-path]

Chemin d'accès au répertoire d'une application spécifique dans le contexte de laquelle la commande doit être exécutée. Si cet indicateur n'est pas défini, la commande utilisera par défaut le répertoire courant. Les cibles valides sont un répertoire d'application, un répertoire de ... Libraries.json fichier, ou un Libraries.lock.json déposer.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation pour l'enregistrement dans la console, par exemple : trace, debug, information, warning, ou error Par défaut, rien n'est consigné dans la console (none).

-d, --dry-run

Optionnel. Si cette option est activée, la commande indiquera, comme d'habitude, les modifications qui auraient été apportées lors de son exécution. Cependant, le système de fichiers restera inchangé.

Commande CLI : c4-cli library install-placeholder

Ajoute une nouvelle référence à un espace réservé dans le Libraries.json modifie un fichier ou remplace une référence existante. Ensuite, résout toutes les bibliothèques de l'application et restaure les bibliothèques manquantes dans le cache de bibliothèques.

Usage:

c4-cli library install-placeholder <namespace> <placeholder> [target-path] [OPTIONS]
Exemple 29. Exemples
    c4-cli library install-placeholder SomeOtherNamespace some_placeholder C:/path/to/application.iecapp


Arguments

Description

<namespace>

Espace de noms d'une bibliothèque spécifique à installer. Si cet argument est fourni, vous devez également fournir un argument pour library.

<placeholder>

Espace réservé pour la bibliothèque à ajouter

[target-path]

Chemin d'accès au répertoire d'une application spécifique dans le contexte de laquelle la commande doit être exécutée. Si cet indicateur n'est pas défini, la commande utilisera par défaut le répertoire courant. Les cibles valides sont un répertoire d'application, un répertoire de ... Libraries.json fichier, ou un Libraries.lock.json déposer.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation pour l'enregistrement dans la console, par exemple : trace, debug, information, warning, ou error Par défaut, rien n'est consigné dans la console (none).

-d, --dry-run

Optionnel. Si cette option est activée, la commande indiquera, comme d'habitude, les modifications qui auraient été apportées lors de son exécution. Cependant, le système de fichiers restera inchangé.

Commande CLI : c4-cli library install-managed

Ajoute une nouvelle référence à une bibliothèque gérée à la Libraries.json Ce fichier remplace une référence existante. Ensuite, il résout toutes les bibliothèques de l'application et restaure les bibliothèques manquantes dans le cache de bibliothèques.

Usage:

c4-cli library install-managed <namespace> <library> [target-path] [OPTIONS]
Exemple 30. Exemples
    c4-cli library install-managed ToolsNamespace "AcmeTools, 1.2.3.4 (Acme Inc)" C:/path/to/application.iecapp


Arguments

Description

<namespace>

Espace de noms d'une bibliothèque spécifique à installer. Cet indicateur doit être spécifié lors de l'installation d'une seule bibliothèque.

<library>

Identifiant ou modèle de la bibliothèque à ajouter

[target-path]

Chemin d'accès au répertoire d'une application spécifique dans le contexte de laquelle la commande doit être exécutée. Si cet indicateur n'est pas défini, la commande utilisera par défaut le répertoire courant. Les cibles valides sont un répertoire d'application, un répertoire de ... Libraries.json fichier, ou un Libraries.lock.json déposer.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation pour l'enregistrement dans la console, par exemple : trace, debug, information, warning, ou error Par défaut, rien n'est consigné dans la console (none).

-d, --dry-run

Optionnel. Si cette option est activée, la commande indiquera, comme d'habitude, les modifications qui auraient été apportées lors de son exécution. Cependant, le système de fichiers restera inchangé.

Commande CLI : c4-cli library install-relative

Ajoute une nouvelle référence à un chemin relatif vers le Libraries.json modifie un fichier ou remplace une référence existante. Ensuite, résout toutes les bibliothèques de l'application et restaure les bibliothèques manquantes dans le cache de bibliothèques.

Usage:

c4-cli library install-relative <namespace> <path> [target-path] [OPTIONS]
Exemple 31. Exemples
    c4-cli library install-relative ToolsNamespace ../some/relative/library.fbslib C:/path/to/application.iecapp


Arguments

Description

<namespace>

Espace de noms d'une bibliothèque spécifique à installer. Si cet argument est fourni, vous devez également fournir un argument pour library.

<path>

Chemin d'accès au projet de bibliothèque (compressée) ou à la bibliothèque compilée à ajouter

[target-path]

Chemin d'accès au répertoire d'une application spécifique dans le contexte de laquelle la commande doit être exécutée. Si cet indicateur n'est pas défini, la commande utilisera par défaut le répertoire courant. Les cibles valides sont un répertoire d'application, un répertoire de ... Libraries.json fichier, ou un Libraries.lock.json déposer.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation pour l'enregistrement dans la console, par exemple : trace, debug, information, warning, ou error Par défaut, rien n'est consigné dans la console (none).

-d, --dry-run

Optionnel. Si cette option est activée, la commande indiquera, comme d'habitude, les modifications qui auraient été apportées lors de son exécution. Cependant, le système de fichiers restera inchangé.

Commande CLI : c4-cli library restore

Restaure toutes les bibliothèques manquantes d'une application dans le cache de bibliothèques

Usage:

c4-cli library restore [target-path] [library-id] [OPTIONS]
Exemple 32. Exemples
    c4-cli library restore
    c4-cli library restore "AcmeTools, 1.2.3.4 (Acme Inc)"


Arguments

Description

[target-path]

Chemin d'accès au répertoire d'une application spécifique dans le contexte de laquelle la commande doit être exécutée. Si cet indicateur n'est pas défini, la commande utilisera par défaut le répertoire courant. Les cibles valides sont un répertoire d'application, un répertoire de ... Libraries.json fichier, ou un Libraries.lock.json déposer.

[library-id]

Si elle est fournie, seule la bibliothèque spécifiée sera restaurée (à condition qu'elle n'existe pas déjà dans le cache).

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation pour l'enregistrement dans la console, par exemple : trace, debug, information, warning, ou error Par défaut, rien n'est consigné dans la console (none).

-d, --dry-run

Optionnel. Si cette option est activée, la commande indiquera, comme d'habitude, les modifications qui auraient été apportées lors de son exécution. Cependant, le système de fichiers restera inchangé.

Commande CLI : c4-cli library clean-install

Vérifie le Libraries.lock.json fichiers, supprime le cache de la bibliothèque et installe toutes les bibliothèques référencées par le Libraries.lock.json fichiers

Usage:

c4-cli library clean-install [target-path] [OPTIONS]
Exemple 33. Exemples
    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


Arguments

Description

[target-path]

Chemin d'accès au répertoire d'un projet de périphérique spécifique, dans le contexte duquel la commande doit être exécutée. Si aucune valeur n'est spécifiée, la commande utilisera le répertoire courant par défaut. Les cibles valides sont un répertoire de projet de périphérique, un répertoire d'application, un Libraries.json fichier, ou un Libraries.lock.json déposer.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation pour l'enregistrement dans la console, par exemple : trace, debug, information, warning, ou error Par défaut, rien n'est consigné dans la console (none).

-d, --dry-run

Optionnel. Si cette option est activée, la commande indiquera, comme d'habitude, les modifications qui auraient été apportées lors de son exécution. Cependant, le système de fichiers restera inchangé.

Commande CLI : c4-cli library uninstall

Désinstalle la bibliothèque associée à un espace de noms spécifié, en supprimant la bibliothèque elle-même et toutes les dépendances référencées exclusivement par cette bibliothèque.

Usage:

c4-cli library uninstall <namespace> [target-path] [OPTIONS]
Exemple 34. Exemples :
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


Arguments

Description

<namespace>

Espace de noms de la bibliothèque à désinstaller

[target-path]

Chemin vers un Libraries.json fichier ou un Libraries.lock.json Vous pouvez spécifier un fichier ou un répertoire d'application où exécuter la commande de désinstallation. Si vous omettez cette option, la commande s'exécutera dans le répertoire courant.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation pour l'enregistrement dans la console, par exemple : trace, debug, information, warning, ou error Par défaut, rien n'est consigné dans la console (none).

-d, --dry-run

Optionnel. Aucun fichier n'est modifié. Seuls les journaux de progression de la commande sont affichés dans la console.

Commande CLI : c4-cli library resolve

Résout les références de bibliothèque pour une application spécifiée et les écrit dans le Libraries.lock.json déposer

Usage:

c4-cli library resolve [target-path] [namespace] [OPTIONS]
Exemple 35. Exemples :
    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


Arguments

Description

[target-path]

Chemin d'accès au répertoire d'une application spécifique dans le contexte de laquelle la commande doit être exécutée. Si aucune valeur n'est spécifiée, la commande utilisera le répertoire courant par défaut. Les cibles valides sont un répertoire d'application, un répertoire de projet de bibliothèque, un Libraries.json fichier, ou un Libraries.lock.json déposer.

[namespace]

Si cet argument est fourni, seul l'espace de noms spécifié sera résolu et seule la bibliothèque résolue sera mise à jour dans le fichier de verrouillage.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation à n'importe quel niveau valide. Si cet indicateur n'est pas spécifié, la journalisation sera désactivée.

-d, --dry-run

Optionnel. Si cette option est activée, la commande indiquera, comme d'habitude, les modifications qui auraient été apportées lors de son exécution. Cependant, le système de fichiers restera inchangé.

-a, --all

Lorsque l'indicateur est activé, le courant Libraries.lock.json Le fichier sera supprimé et un tout nouveau sera créé.

Commande CLI : c4-cli library remove

Supprime la référence à la bibliothèque identifiée par l'espace de noms de la Libraries.json déposer

Usage:

c4-cli library remove <namespace> [target-path] [OPTIONS]
Exemple 36. Exemples :
c4-cli library remove ToolsNamespace C:/path/to/Libraries.json 


Arguments

Description

<namespace>

Espace de noms de la bibliothèque à supprimer

[target-path]

Chemin vers un Libraries.json Indiquez le fichier, le répertoire de l'application ou le répertoire de la bibliothèque à partir duquel la référence sera supprimée. Si vous omettez cette option, la commande utilisera le répertoire courant par défaut.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation à n'importe quel niveau valide. Si cet indicateur n'est pas spécifié, la journalisation sera désactivée.

Commande CLI : c4-cli library prune

Supprime les références indirectes inutilisées aux bibliothèques de la Libraries.lock.json déposer

Usage:

c4-cli library prune [target-path] [OPTIONS]
Exemple 37. Exemples :
c4-cli library prune C:/path/to/Libraries.lock.json


Arguments

Description

[target-path]

Chemin d'accès à la cible de la commande. Si ce chemin est omis, la commande utilisera par défaut le répertoire courant. Les cibles valides sont un répertoire d'application, un répertoire de destination ... Libraries.json fichier, ou un Libraries.lock.json déposer.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation à n'importe quel niveau valide. Si cet indicateur n'est pas spécifié, la journalisation sera désactivée.

-d, --dry-run

Optionnel. Si cette option est activée, la commande indiquera, comme d'habitude, les modifications qui auraient été apportées lors de son exécution. Cependant, le système de fichiers restera inchangé.

Commande CLI : c4-cli library outdated

Vérifie les dépôts pour déterminer si des bibliothèques installées (de manière générale ou spécifique) sont obsolètes.

Usage:

c4-cli library outdated [target-path] [library-id] [OPTIONS]
Exemple 38. Exemples :
    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


Arguments

Description

[target-path]

Chemin d'accès à la cible de la commande. Si ce chemin est omis, la commande utilisera par défaut le répertoire courant. Les cibles valides sont un répertoire d'application, un répertoire de destination ... Libraries.json fichier, ou un Libraries.lock.json déposer.

[library-id]

Identifiant de la bibliothèque pour laquelle la vérification des versions plus récentes doit être effectuée.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation à n'importe quel niveau valide. Si cet indicateur n'est pas spécifié, la journalisation sera désactivée.

-a, --all

Lorsque cette option est activée, les références indirectes obsolètes seront également signalées.

-p, --include-prerelease

Lorsque cette option est activée, les bibliothèques en version préliminaire seront également prises en compte.

Commande CLI : c4-cli library list

Liste toutes les références d'une application définie.

Usage:

 c4-cli library list [target-path] [OPTIONS]
Exemple 39. Exemples :
    c4-cli library list
    c4-cli library list C:/path/to/application.iecapp/
    c4-cli library list --all


Arguments

Description

[target-path]

Chemin vers le Libraries.lock.json fichier, pour lequel les références doivent être listées, ou le répertoire de l'application qui contient Libraries.lock.json fichier. Si ce paramètre est omis, la commande utilisera par défaut le répertoire courant.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation pour l'enregistrement dans la console, par exemple : trace, debug, information, warning, ou error Par défaut, rien n'est consigné dans la console (none).

-a, --all

Lorsque cette option est activée, toutes les références indirectes seront également listées.

Commande CLI : c4-cli library explain

Affiche la chaîne de dépendances qui fait qu'une bibliothèque spécifiée est référencée.

Usage:

c4-cli library explain <library> [target-path] [OPTIONS]
Exemple 40. Exemples :
    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


Arguments

Description

<library>

Bibliothèque pour laquelle la chaîne de dépendances doit être affichée. Ceci peut être spécifié par l'identifiant de la bibliothèque ou l'espace de noms.

[target-path]

Chemin vers le Libraries.lock.json fichier où la bibliothèque respective est référencée, ou à un Libraries.json le fichier à côté du Libraries.lock.json fichier, ou le répertoire de l'application qui contient un Libraries.lock.json fichier. Si ce paramètre est omis, la commande utilisera par défaut le répertoire courant.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation pour l'enregistrement dans la console, par exemple : trace, debug, information, warning, ou error Par défaut, rien n'est consigné dans la console (none).

-p, --show-paths

Lorsque cette option est activée, les chemins d'accès aux références affichées seront également affichés.

Commande CLI : c4-cli library pack

Crée une archive de bibliothèque source à partir de la bibliothèque spécifiée. CODESYS 4 Dossier du projet de bibliothèque. Il doit s'agir d'une bibliothèque valide.

Usage:

    c4-cli library pack [target-path] [zip-path] [OPTIONS]
Exemple 41. Exemples :
    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/


Arguments

Description

[target-path]

Facultatif

Chemin d'accès au dossier du projet de bibliothèque à empaqueter. Si ce chemin est omis, la commande utilisera par défaut le répertoire courant. [zip-path] est défini, alors utilisez . Ici, à titre d'espace réservé pour le répertoire actuel.

[zip-path]

Répertoire où sera enregistrée l'archive de la bibliothèque compressée. Si ce répertoire est omis, l'archive sera créée dans le même répertoire que la bibliothèque.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation pour l'enregistrement dans la console, par exemple : trace, debug, information, warning, ou error Par défaut, rien n'est consigné dans la console (none).

Commande CLI : c4-cli library save-compiled

Enregistre une bibliothèque spécifique en tant que bibliothèque compilée

Usage:

    c4-cli library save-compiled <library-path> <destination-path> [OPTIONS]
Exemple 42. Exemples :
    c4-cli library save-compiled C:/path/to/library.fbslib/ C:/path/to/library.compiled-library-v3


Arguments

Description

<library-path>

Chemin d'accès à la bibliothèque à compiler. Les cibles valides sont le répertoire du projet de bibliothèque, un Libraries.json fichier, ou un Libraries.lock.json fichier. Utiliser . pour le répertoire courant.

<destination-path>

Chemin d'accès où la bibliothèque compilée sera enregistrée. S'il s'agit d'un répertoire, la bibliothèque compilée sera enregistrée dans un fichier nommé {LibraryName}.compiled-library-v3 à l'intérieur du répertoire.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation pour l'enregistrement dans la console, par exemple : trace, debug, information, warning, ou error Par défaut, rien n'est consigné dans la console (none).

-d, --dry-run

Optionnel. Si cette option est activée, la commande indiquera, comme d'habitude, les modifications qui auraient été apportées lors de son exécution. Cependant, le système de fichiers restera inchangé.

--overwrite

Écrase le fichier de destination s'il existe déjà.

--compiler-version

Utilise une version de compilateur prédéfinie

--set-version

Remplace la version de la bibliothèque. Si cet indicateur est défini, utilisez cette valeur à la place de la version semver dans le ProjectInfo.json fichier de la bibliothèque.

--assert-version

Vérifie la version dans le ProjectInfo.json Le fichier est ouvert et le processus est interrompu s'il ne correspond pas à la version spécifiée.

--compression-level

Niveau de compression de l'archive ZIP

--set-released-flag

Si cet indicateur est défini, l'indicateur « Publié » sera remplacé par la valeur spécifiée dans la bibliothèque compilée.

Si cet indicateur est activé, le champ des étiquettes de préversion devra également être vide. Dans ce cas, la génération de la bibliothèque échouera si l'un des éléments suivants… --set-prerelease-labels l'option est définie avec une chaîne non vide, ou la SemVer version dans le domaine ProjectInfo.json Le fichier spécifie les étiquettes de préversion qui n'ont pas été explicitement remplacées par une chaîne vide via le --set-prerelease-labels option.

--set-prerelease-labels

Remplace les étiquettes de préversion. Si cet indicateur est défini, cette valeur sera utilisée à la place des étiquettes de préversion semver. ProjectInfo.json fichier de la bibliothèque. Si la valeur est définie sur --, alors une bibliothèque sera créée sans étiquette de préversion, même si une étiquette est spécifiée dans le ProjectInfo.json déposer.

Une étiquette de pré-lancement non vide entre en conflit avec --set-released-flag; donc, --set-prerelease-labels ne peut pas être utilisé avec une étiquette non vide lorsque le --set-released-flag l'indicateur est défini sur vrai, ou le released L'indicateur est défini dans les informations du projet. Cette valeur exclut le premier - qui sépare l'étiquette de version et l'étiquette de préversion dans la notation semver.

--set-buildinfo-labels

Remplace les étiquettes d'informations de build. Si cet indicateur est défini, cette valeur sera utilisée à la place de l'étiquette d'informations de build de version semver. ProjectInfo.json fichier de la bibliothèque. Si la valeur est définie sur --, alors une bibliothèque sans étiquette d'informations de compilation sera créée, même si une étiquette est spécifiée dans le ProjectInfo.json fichier. Cette valeur exclut le premier + qui sépare l'étiquette de version ou l'étiquette de préversion de la partie informations de compilation dans la notation semver.

--assert-prerelease-labels

Vérifie les étiquettes de pré-publication des semver version dans le domaine ProjectInfo.json vérifie le fichier de la bibliothèque et interrompt le processus s'il ne correspond pas aux étiquettes spécifiées. Peut être utilisé pour des vérifications de cohérence dans le pipeline. Lorsque la valeur est définie sur --, cela permettra de s'assurer que le ProjectInfo.json Le fichier ne spécifie aucune étiquette de préversion.

--assert-buildinfo-labels

Vérifie les étiquettes d'informations de build du champ de version semver dans le ProjectInfo.json vérifie le fichier de la bibliothèque et interrompt le processus s'il ne correspond pas aux étiquettes spécifiées. Peut être utilisé pour des vérifications de cohérence dans le pipeline. Lorsque la valeur est définie sur --, cela permettra de s'assurer que le ProjectInfo.json Le fichier ne spécifie aucune étiquette d'information de construction. Cette valeur exclut le premier élément. + qui sépare l'étiquette de version ou l'étiquette de préversion de la partie informations de compilation dans la notation semver.

--include-libdoc

Chemin d'accès à l'archive principale de documentation compilée créée par la chaîne d'outils libdoc, généralement nommée soit doc.lmd ou __lmd__.aux[iliary] Compilez les fichiers du même dossier qui respectent la convention d'appellation. __lmd__*.aux[iliary] seront également inclus, où * correspond au code de langue/pays ISO.

Commande CLI : c4-cli library verify

Vérifie si les résolutions de la bibliothèque dans Libraries.lock.json sont toujours valides et correspondent toujours aux Libraries.json Vérifie que toutes les bibliothèques sont accessibles dans le cache de bibliothèques et qu'il n'existe aucune référence dupliquée, aucun paquetage mis à jour ni aucun paquetage orphelin.

Usage:

c4-cli library verify [target-path] [OPTIONS]
Exemple 43. Exemples :
    c4-cli library verify C:/path/to/application.iecapp/


Arguments

Description

[target-path]

Chemin d'accès à la cible de la commande. Si ce chemin est omis, la commande utilisera par défaut le répertoire courant. Les cibles valides sont un répertoire d'application, un répertoire de destination ... Libraries.json fichier, ou un Libraries.lock.json déposer.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation pour l'enregistrement dans la console, par exemple : trace, debug, information, warning, ou error Par défaut, rien n'est consigné dans la console (none).

Commande CLI : c4-cli library check

Vérifie le projet de bibliothèque et signale les erreurs et avertissements détectés.

Usage:

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

Arguments

Description

[library-path]

Chemin d'accès au projet de bibliothèque à vérifier. Si ce chemin est omis, la commande utilisera le répertoire courant par défaut.

Options

Description

-h, --help

Affiche l'aide relative à la commande

-v, --verbose

Permet la journalisation sur la console à l'adresse information niveau; Forme abrégée de --log-level=information

--log-level

Définit le niveau de journalisation pour l'enregistrement dans la console, par exemple : trace, debug, information, warning, ou error Par défaut, rien n'est consigné dans la console (none).

-d, --dry-run

Optionnel. Si cette option est activée, la commande indiquera, comme d'habitude, les modifications qui auraient été apportées lors de son exécution. Cependant, le système de fichiers restera inchangé.

--pointer-size

Taille du pointeur supposée (en bits) ; peut être 32 ou 64 (valeur par défaut) 32 )

--compiler-defines

Liste de définitions du compilateur, séparées par des virgules, à paramétrer