Comando CLI: `c4-cli library`

Modifica i riferimenti della libreria

Utilizzo:

  c4-cli library [OPTIONS] <COMMAND>

Esempio 24. Esempi

    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

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando

Comando	Descrizione
`set-managed <namespace> <library>`	Aggiunge un nuovo riferimento alla libreria gestita `Libraries.json` file o sostituisce un riferimento esistente
`set-relative <namespace> <path>`	Aggiunge un nuovo riferimento a un percorso relativo al `Libraries.json` file o sostituisce un riferimento esistente
`set-placeholder <namespace> <placeholder>`	Aggiunge un nuovo riferimento segnaposto al `Libraries.json` file o sostituisce un riferimento esistente
`install`	Risolve tutte le librerie dell'applicazione e ripristina le librerie mancanti nella cache delle librerie.
`install-placeholder <namespace> <placeholder>`	Aggiunge un nuovo riferimento a un segnaposto nel `Libraries.json` Il file viene salvato o sostituito con un riferimento esistente. Quindi risolve tutte le librerie dell'applicazione e ripristina le librerie mancanti nella cache delle librerie.
`install-managed <namespace> <library>`	Aggiunge un nuovo riferimento alla libreria gestita `Libraries.json` Il file viene salvato o sostituito con un riferimento esistente. Quindi risolve tutte le librerie dell'applicazione e ripristina le librerie mancanti nella cache delle librerie.
`install-relative <namespace> <path>`	Aggiunge un nuovo riferimento a un percorso relativo al `Libraries.json` Il file viene salvato o sostituito con un riferimento esistente. Quindi risolve tutte le librerie dell'applicazione e ripristina le librerie mancanti nella cache delle librerie.
`restore`	Ripristina tutte le librerie mancanti di un'applicazione nella cache delle librerie
`clean-install`	Verifica il `Libraries.lock.json` file, rimuove la cache della libreria e installa tutte le librerie a cui fa riferimento il `Libraries.lock.json` file
`library uninstall <namespace> [target-path]`	Disinstalla la libreria associata a uno spazio dei nomi specificato. Rimuove la libreria stessa e tutte le dipendenze a cui fa riferimento esclusivamente tale libreria.
`resolve`	Risolve i riferimenti della libreria per un'applicazione specificata e li scrive nel `Libraries.lock.json` file
`remove <namespace> [target-path]`	Rimuove il riferimento alla libreria identificato dallo spazio dei nomi `Libraries.json` file
`prune`	Rimuove i riferimenti indiretti inutilizzati alle librerie da `Libraries.lock.json` file
`outdated`	Verifica i repository per determinare se le librerie installate (in generale o in modo specifico) sono attualmente obsolete.
`list`	Elenca tutti i riferimenti di un'applicazione specificata
`explain <library>`	Stampa la catena di dipendenze che causano il riferimento a una libreria specificata.
`pack`	Crea un archivio della libreria sorgente dal file specificato CODESYS 4 cartella del progetto della libreria. Deve essere una libreria valida.
`save-compiled <library-path> <destination-path>`	Salva una libreria specificata come libreria compilata
`verify`	Verifica se le risoluzioni della libreria in `Libraries.lock.json` sono ancora validi e corrispondono ancora `Libraries.json` Verifica che tutte le librerie siano accessibili nella cache delle librerie e che non esistano riferimenti duplicati, pacchetti aggiornati o file orfani.
`check`	Verifica il progetto della libreria e segnala eventuali errori e avvisi rilevati.

Comando CLI: `c4-cli library set-managed`

Aggiunge un nuovo riferimento alla libreria gestita Libraries.json crea un file o sostituisce un riferimento esistente.

Utilizzo:

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

Esempio 25. Esempi

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

Argomentazioni	Descrizione
`<namespace>`	Namespace della libreria da modificare
`<library>`	ID della biblioteca o modello della biblioteca da aggiungere
`[target-path]`	Percorso verso un `Libraries.json` file, directory dell'applicazione o directory di libreria in cui verrà creato o sostituito il riferimento. Se omesso, il comando utilizzerà per impostazione predefinita la directory corrente.

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log per la registrazione sulla console, ad esempio `trace`, `debug`, `information`, `warning`, O `error`. Per impostazione predefinita, nulla viene registrato nella console (`none`).
`-u, --allow-unqualified-access`	Se questo è impostato su `true`, quindi è possibile accedere alla libreria senza qualificazione dello spazio dei nomi. Il valore consigliato per il nuovo codice è `false`. Ciò corrisponde alla negazione della `qualifiedOnly` valore in CODESYS 3, che di default è `false` per ragioni storiche.
`-c, --publish-symbols-in-container`	Se questo è impostato su `true` In tal caso, la libreria di riferimento pubblicherà i propri simboli nella libreria contenitore di riferimento. Utilizzare questa impostazione per definire i simboli pubblicati durante la creazione di una libreria contenitore.
`-o, --optional`	Se questo è impostato su `true` In tal caso, non si verificheranno errori di compilazione semplicemente perché la libreria non è disponibile. (Tuttavia, potrebbero verificarsi errori di compilazione a causa di simboli mancanti da questa libreria.)
`--no-hash`	Si applica ai riferimenti di percorso relativi che puntano a file (`.zip` O `.compiled-library`). Sopprime la generazione di valori hash SHA384 nel `Libraries.lock.json` file. Questo è utile nelle pipeline di build e nelle pipeline di test CI quando il file di riferimento viene generato in precedenza nella pipeline e si prevede un hash variabile.
`-p, --include-prerelease`	Se questo è impostato su `true`, quindi i modelli di versione corrisponderanno sempre alle versioni di pre-release entro l'intervallo consentito. Altrimenti, si applica il comportamento predefinito: "Se una versione ha un tag di pre-release, ad esempio `1.2.3-alpha.3` – quindi sarà consentito soddisfare solo i set di comparatori se almeno un comparatore con lo stesso [`major, minor, patch` ] La tupla ha anche un tag di pre-rilascio."
`--link-all-content`	Solo per casi d'uso speciali. Se è impostato su `true` In tal caso, l'intera libreria verrà integrata, non solo le parti a cui si fa riferimento.
`--default-resolution`	Facoltativo (consentito per i segnaposto). Quando il flag è impostato, deve essere un ID di libreria o un modello che verrà utilizzato durante il controllo della libreria.
`-d, --dry-run`	Opzionale. Quando il flag è impostato, non verranno apportate modifiche ai file. Invece, la voce che verrebbe scritta verrà stampata sulla console.

Comando CLI: `c4-cli library set-relative`

Aggiunge un nuovo riferimento a un percorso relativo al Libraries.json file o sostituisce un riferimento esistente

Utilizzo:

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

Esempio 26. Esempi

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

Argomentazioni	Descrizione
`<namespace>`	Namespace della libreria da modificare
`<path>`	Percorso del progetto della libreria (compressa) o della libreria compilata da aggiungere
`[target-path]`	Percorso verso un `Libraries.json` file, directory dell'applicazione o directory di libreria in cui verrà creato o sostituito il riferimento. Se omesso, il comando utilizzerà per impostazione predefinita la directory corrente.

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log per la registrazione sulla console, ad esempio `trace`, `debug`, `information`, `warning`, O `error`. Per impostazione predefinita, nulla viene registrato nella console (`none`).
`-u, --allow-unqualified-access`	Se questo è impostato su `true`, quindi è possibile accedere alla libreria senza qualificazione dello spazio dei nomi. Il valore consigliato per il nuovo codice è `false`. Ciò corrisponde alla negazione della `qualifiedOnly` valore in CODESYS 3, che di default è `false` per ragioni storiche.
`-c, --publish-symbols-in-container`	Se questo è impostato su `true` In tal caso, la libreria di riferimento pubblicherà i propri simboli nella libreria contenitore di riferimento. Utilizzare questa impostazione per definire i simboli pubblicati durante la creazione di una libreria contenitore.
`-o, --optional`	Se questo è impostato su `true` In tal caso, non si verificheranno errori di compilazione semplicemente perché la libreria non è disponibile. (Tuttavia, potrebbero verificarsi errori di compilazione a causa di simboli mancanti da questa libreria.)
`--no-hash`	Si applica ai riferimenti di percorso relativi che puntano a file (`.zip` O `.compiled-library`). Sopprime la generazione di valori hash SHA384 nel `Libraries.lock.json` file. Questo è utile nelle pipeline di build e nelle pipeline di test CI quando il file di riferimento viene generato in precedenza nella pipeline e si prevede un hash variabile.
`-p, --include-prerelease`	Se questo è impostato su `true`, quindi i modelli di versione corrisponderanno sempre alle versioni di pre-release entro l'intervallo consentito. Altrimenti, si applica il comportamento predefinito: "Se una versione ha un tag di pre-release, ad esempio `1.2.3-alpha.3` – quindi sarà consentito soddisfare solo i set di comparatori se almeno un comparatore con lo stesso [`major, minor, patch` ] La tupla ha anche un tag di pre-rilascio."
`--link-all-content`	Solo per casi d'uso speciali. Se è impostato su `true` In tal caso, l'intera libreria verrà integrata, non solo le parti a cui si fa riferimento.
`--default-resolution`	Facoltativo (consentito per i segnaposto). Quando il flag è impostato, deve essere un ID di libreria o un modello che verrà utilizzato durante il controllo della libreria.
`-d, --dry-run`	Opzionale. Quando il flag è impostato, non verranno apportate modifiche ai file. Invece, la voce che verrebbe scritta verrà stampata sulla console.

Comando CLI: `c4-cli library set-placeholder`

Aggiunge un nuovo riferimento segnaposto al Libraries.json file o sostituisce un riferimento esistente

Utilizzo:

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

Esempio 27. Esempi

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

Argomentazioni	Descrizione
`<namespace>`	Namespace della libreria da modificare
`<placeholder>`	Segnaposto per la libreria da aggiungere
`[target-path]`	Percorso verso un `Libraries.json` file, directory dell'applicazione o directory di libreria in cui verrà creato o sostituito il riferimento. Se omesso, il comando utilizzerà per impostazione predefinita la directory corrente.

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log per la registrazione sulla console, ad esempio `trace`, `debug`, `information`, `warning`, O `error`. Per impostazione predefinita, nulla viene registrato nella console (`none`).
`-u, --allow-unqualified-access`	Se questo è impostato su `true`, quindi è possibile accedere alla libreria senza qualificazione dello spazio dei nomi. Il valore consigliato per il nuovo codice è `false`. Ciò corrisponde alla negazione della `qualifiedOnly` valore in CODESYS 3, che di default è `false` per ragioni storiche.
`-c, --publish-symbols-in-container`	Se questo è impostato su `true` In tal caso, la libreria di riferimento pubblicherà i propri simboli nella libreria contenitore di riferimento. Utilizzare questa impostazione per definire i simboli pubblicati durante la creazione di una libreria contenitore.
`-o, --optional`	Se questo è impostato su `true` In tal caso, non si verificheranno errori di compilazione semplicemente perché la libreria non è disponibile. (Tuttavia, potrebbero verificarsi errori di compilazione a causa di simboli mancanti da questa libreria.)
`--no-hash`	Si applica ai riferimenti di percorso relativi che puntano a file (`.zip` O `.compiled-library`). Sopprime la generazione di valori hash SHA384 nel `Libraries.lock.json` file. Questo è utile nelle pipeline di build e nelle pipeline di test CI quando il file di riferimento viene generato in precedenza nella pipeline e si prevede un hash variabile.
`-p, --include-prerelease`	Se questo è impostato su `true`, quindi i modelli di versione corrisponderanno sempre alle versioni di pre-release entro l'intervallo consentito. Altrimenti, si applica il comportamento predefinito: "Se una versione ha un tag di pre-release, ad esempio `1.2.3-alpha.3` – quindi sarà consentito soddisfare solo i set di comparatori se almeno un comparatore con lo stesso [`major, minor, patch` ] La tupla ha anche un tag di pre-rilascio."
`--link-all-content`	Solo per casi d'uso speciali. Se è impostato su `true` In tal caso, l'intera libreria verrà integrata, non solo le parti a cui si fa riferimento.
`--default-resolution`	Facoltativo (consentito per i segnaposto). Quando il flag è impostato, deve essere un ID di libreria o un modello che verrà utilizzato durante il controllo della libreria.
`-d, --dry-run`	Opzionale. Quando il flag è impostato, non verranno apportate modifiche ai file. Invece, la voce che verrebbe scritta verrà stampata sulla console.

Comando CLI: `c4-cli library install`

Risolve tutte le librerie dell'applicazione e ripristina le librerie mancanti nella cache delle librerie.

Utilizzo:

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

Esempio 28. Esempi

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

Argomentazioni	Descrizione
`[target-path]`	Percorso alla directory di una specifica applicazione, nel cui contesto deve essere eseguito il comando. Se il flag non è impostato, il comando utilizzerà per impostazione predefinita la directory corrente. I target validi sono una directory dell'applicazione, una `Libraries.json` file o un `Libraries.lock.json` file.

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log per la registrazione sulla console, ad esempio `trace`, `debug`, `information`, `warning`, O `error`. Per impostazione predefinita, nulla viene registrato nella console (`none`).
`-d, --dry-run`	Opzionale. Quando il flag è impostato, il comando segnalerà nel modo consueto quali modifiche sarebbero state apportate durante l'esecuzione. Tuttavia, il file system non verrà modificato.

Comando CLI: `c4-cli library install-placeholder`

Aggiunge un nuovo riferimento a un segnaposto nel Libraries.json Il file viene salvato o sostituito con un riferimento esistente. Quindi risolve tutte le librerie dell'applicazione e ripristina le librerie mancanti nella cache delle librerie.

Utilizzo:

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

Esempio 29. Esempi

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

Argomentazioni	Descrizione
`<namespace>`	Namespace di una singola libreria specifica da installare. Se questo argomento viene fornito, è necessario fornire anche un argomento per `library`.
`<placeholder>`	Segnaposto per la libreria da aggiungere
`[target-path]`	Percorso alla directory di una specifica applicazione, nel cui contesto deve essere eseguito il comando. Se il flag non è impostato, il comando utilizzerà per impostazione predefinita la directory corrente. I target validi sono una directory dell'applicazione, una `Libraries.json` file o un `Libraries.lock.json` file.

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log per la registrazione sulla console, ad esempio `trace`, `debug`, `information`, `warning`, O `error`. Per impostazione predefinita, nulla viene registrato nella console (`none`).
`-d, --dry-run`	Opzionale. Quando il flag è impostato, il comando segnalerà nel modo consueto quali modifiche sarebbero state apportate durante l'esecuzione. Tuttavia, il file system non verrà modificato.

Comando CLI: `c4-cli library install-managed`

Aggiunge un nuovo riferimento alla libreria gestita Libraries.json Salva o sostituisce un riferimento esistente. Quindi risolve tutte le librerie dell'applicazione e ripristina le librerie mancanti nella cache delle librerie.

Utilizzo:

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

Esempio 30. Esempi

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

Argomentazioni	Descrizione
`<namespace>`	Namespace di una singola libreria specifica da installare. Il flag deve essere specificato durante l'installazione di una singola libreria specifica.
`<library>`	ID della biblioteca o modello della biblioteca da aggiungere
`[target-path]`	Percorso alla directory di una specifica applicazione, nel cui contesto deve essere eseguito il comando. Se il flag non è impostato, il comando utilizzerà per impostazione predefinita la directory corrente. I target validi sono una directory dell'applicazione, una `Libraries.json` file o un `Libraries.lock.json` file.

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log per la registrazione sulla console, ad esempio `trace`, `debug`, `information`, `warning`, O `error`. Per impostazione predefinita, nulla viene registrato nella console (`none`).
`-d, --dry-run`	Opzionale. Quando il flag è impostato, il comando segnalerà nel modo consueto quali modifiche sarebbero state apportate durante l'esecuzione. Tuttavia, il file system non verrà modificato.

Comando CLI: `c4-cli library install-relative`

Aggiunge un nuovo riferimento a un percorso relativo al Libraries.json Il file viene salvato o sostituito con un riferimento esistente. Quindi risolve tutte le librerie dell'applicazione e ripristina le librerie mancanti nella cache delle librerie.

Utilizzo:

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

Esempio 31. Esempi

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

Argomentazioni	Descrizione
`<namespace>`	Namespace di una singola libreria specifica da installare. Se questo argomento viene fornito, è necessario fornire anche un argomento per `library`.
`<path>`	Percorso del progetto della libreria (compressa) o della libreria compilata da aggiungere
`[target-path]`	Percorso alla directory di una specifica applicazione, nel cui contesto deve essere eseguito il comando. Se il flag non è impostato, il comando utilizzerà per impostazione predefinita la directory corrente. I target validi sono una directory dell'applicazione, una `Libraries.json` file o un `Libraries.lock.json` file.

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log per la registrazione sulla console, ad esempio `trace`, `debug`, `information`, `warning`, O `error`. Per impostazione predefinita, nulla viene registrato nella console (`none`).
`-d, --dry-run`	Opzionale. Quando il flag è impostato, il comando segnalerà nel modo consueto quali modifiche sarebbero state apportate durante l'esecuzione. Tuttavia, il file system non verrà modificato.

Comando CLI: `c4-cli library restore`

Ripristina tutte le librerie mancanti di un'applicazione nella cache delle librerie

Utilizzo:

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

Esempio 32. Esempi

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

Argomentazioni	Descrizione
`[target-path]`	Percorso alla directory di una specifica applicazione, nel cui contesto deve essere eseguito il comando. Se il flag non è impostato, il comando utilizzerà per impostazione predefinita la directory corrente. I target validi sono una directory dell'applicazione, una `Libraries.json` file o un `Libraries.lock.json` file.
`[library-id]`	Se specificata, verrà ripristinata solo la libreria indicata (a condizione che non sia già presente nella cache).

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log per la registrazione sulla console, ad esempio `trace`, `debug`, `information`, `warning`, O `error`. Per impostazione predefinita, nulla viene registrato nella console (`none`).
`-d, --dry-run`	Opzionale. Quando il flag è impostato, il comando segnalerà nel modo consueto quali modifiche sarebbero state apportate durante l'esecuzione. Tuttavia, il file system non verrà modificato.

Comando CLI: `c4-cli library clean-install`

Verifica il Libraries.lock.json file, rimuove la cache della libreria e installa tutte le librerie a cui fa riferimento il Libraries.lock.json file

Utilizzo:

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

Esempio 33. Esempi

    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

Argomentazioni	Descrizione
`[target-path]`	Percorso alla directory di uno specifico progetto di dispositivo, nel cui contesto deve essere eseguito il comando. Se non viene specificato alcun valore, il comando utilizzerà per impostazione predefinita la directory corrente. I target validi sono una directory di progetto di dispositivo, una directory di applicazione, una directory di applicazione. `Libraries.json` file o un `Libraries.lock.json` file.

Argomentazioni

Descrizione

[target-path]

Percorso alla directory di uno specifico progetto di dispositivo, nel cui contesto deve essere eseguito il comando. Se non viene specificato alcun valore, il comando utilizzerà per impostazione predefinita la directory corrente. I target validi sono una directory di progetto di dispositivo, una directory di applicazione, una directory di applicazione. Libraries.json file o un Libraries.lock.json file.

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log per la registrazione sulla console, ad esempio `trace`, `debug`, `information`, `warning`, O `error`. Per impostazione predefinita, nulla viene registrato nella console (`none`).
`-d, --dry-run`	Opzionale. Quando il flag è impostato, il comando segnalerà nel modo consueto quali modifiche sarebbero state apportate durante l'esecuzione. Tuttavia, il file system non verrà modificato.

Comando CLI: `c4-cli library uninstall`

Disinstalla la libreria associata a uno spazio dei nomi specificato, rimuovendo la libreria stessa e tutte le dipendenze a cui fa riferimento esclusivamente tale libreria.

Utilizzo:

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

Esempio 34. Esempi:

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

Argomentazioni	Descrizione
`<namespace>`	Namespace della libreria da disinstallare
`[target-path]`	Percorso verso un `Libraries.json` file o un `Libraries.lock.json` file o in una directory dell'applicazione in cui deve essere eseguito il comando di disinstallazione. Se questo parametro viene omesso, il comando utilizzerà per impostazione predefinita la directory corrente.

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log per la registrazione sulla console, ad esempio `trace`, `debug`, `information`, `warning`, O `error`. Per impostazione predefinita, nulla viene registrato nella console (`none`).
`-d, --dry-run`	Opzionale. Non vengono apportate modifiche ai file. Solo i log di avanzamento del comando vengono visualizzati nella console.

Comando CLI: `c4-cli library resolve`

Risolve i riferimenti della libreria per un'applicazione specificata e li scrive nel Libraries.lock.json file

Utilizzo:

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

Esempio 35. Esempi:

    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

Argomentazioni	Descrizione
`[target-path]`	Percorso della directory di un'applicazione specifica, nel cui contesto deve essere eseguito il comando. Se non viene specificato alcun valore, il comando utilizzerà per impostazione predefinita la directory corrente. I target validi sono una directory dell'applicazione, una directory di progetto di libreria, una `Libraries.json` file o un `Libraries.lock.json` file.
`[namespace]`	Se questo argomento viene fornito, verrà risolto solo lo spazio dei nomi specificato e solo la libreria risolta verrà aggiornata nel file di blocco.

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log su qualsiasi livello valido. Se il flag non è specificato, la registrazione verrà disabilitata.
`-d, --dry-run`	Opzionale. Quando il flag è impostato, il comando segnalerà nel modo consueto quali modifiche sarebbero state apportate durante l'esecuzione. Tuttavia, il file system non verrà modificato.
`-a, --all`	Quando la bandiera è impostata, la corrente `Libraries.lock.json` Il file verrà eliminato e ne verrà scritto uno completamente nuovo.

Comando CLI: `c4-cli library remove`

Rimuove il riferimento alla libreria identificato dallo spazio dei nomi Libraries.json file

Utilizzo:

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

Esempio 36. Esempi:

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

Argomentazioni	Descrizione
`<namespace>`	Namespace della libreria da rimuovere
`[target-path]`	Percorso verso un `Libraries.json` file, directory dell'applicazione o directory di libreria da cui verrà rimosso il riferimento. Se omesso, il comando utilizzerà per impostazione predefinita la directory corrente.

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log su qualsiasi livello valido. Se il flag non è specificato, la registrazione verrà disabilitata.

Comando CLI: `c4-cli library prune`

Rimuove i riferimenti indiretti inutilizzati alle librerie da Libraries.lock.json file

Utilizzo:

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

Esempio 37. Esempi:

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

Argomentazioni	Descrizione
`[target-path]`	Percorso della destinazione del comando. Se omesso, il comando utilizzerà per impostazione predefinita la directory corrente. Le destinazioni valide sono una directory dell'applicazione, `Libraries.json` file o un `Libraries.lock.json` file.

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log su qualsiasi livello valido. Se il flag non è specificato, la registrazione verrà disabilitata.
`-d, --dry-run`	Opzionale. Quando il flag è impostato, il comando segnalerà nel modo consueto quali modifiche sarebbero state apportate durante l'esecuzione. Tuttavia, il file system non verrà modificato.

Comando CLI: `c4-cli library outdated`

Verifica i repository per determinare se le librerie installate (in generale o in modo specifico) sono obsolete.

Utilizzo:

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

Esempio 38. Esempi:

    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

Argomentazioni	Descrizione
`[target-path]`	Percorso della destinazione del comando. Se omesso, il comando utilizzerà per impostazione predefinita la directory corrente. Le destinazioni valide sono una directory dell'applicazione, `Libraries.json` file o un `Libraries.lock.json` file.
`[library-id]`	ID della libreria per la quale deve essere eseguito il controllo delle versioni più recenti

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log su qualsiasi livello valido. Se il flag non è specificato, la registrazione verrà disabilitata.
`-a, --all`	Quando il flag è impostato, verranno segnalati anche i riferimenti indiretti obsoleti.
`-p, --include-prerelease`	Quando il flag è impostato, verranno prese in considerazione anche le librerie di pre-release.

Comando CLI: `c4-cli library list`

Elenca tutti i riferimenti di un'applicazione definita

Utilizzo:

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

Esempio 39. Esempi:

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

Argomentazioni	Descrizione
`[target-path]`	Percorso verso il `Libraries.lock.json` file, per il quale devono essere elencati i riferimenti, oppure la directory dell'applicazione che contiene `Libraries.lock.json` file. Se questo parametro viene omesso, il comando utilizzerà per impostazione predefinita la directory corrente.

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log per la registrazione sulla console, ad esempio `trace`, `debug`, `information`, `warning`, O `error`. Per impostazione predefinita, nulla viene registrato nella console (`none`).
`-a, --all`	Quando il flag è impostato, verranno elencati anche tutti i riferimenti indiretti.

Comando CLI: `c4-cli library explain`

Stampa la catena di dipendenze che causano il riferimento a una libreria specificata.

Utilizzo:

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

Esempio 40. Esempi:

    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

Argomentazioni	Descrizione
`<library>`	Libreria per la quale deve essere stampata la catena di dipendenze. Può essere specificata come ID della libreria o namespace.
`[target-path]`	Percorso verso il `Libraries.lock.json` file in cui viene fatto riferimento alla rispettiva libreria, oppure a un `Libraries.json` file accanto al `Libraries.lock.json` file o la directory dell'applicazione che include un `Libraries.lock.json` file. Se questo parametro viene omesso, il comando utilizzerà per impostazione predefinita la directory corrente.

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log per la registrazione sulla console, ad esempio `trace`, `debug`, `information`, `warning`, O `error`. Per impostazione predefinita, nulla viene registrato nella console (`none`).
`-p, --show-paths`	Quando il flag è impostato, verranno visualizzati anche i percorsi dei riferimenti mostrati.

Comando CLI: `c4-cli library pack`

Crea un archivio della libreria sorgente dal file specificato CODESYS 4 cartella del progetto della libreria. Deve essere una libreria valida.

Utilizzo:

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

Esempio 41. Esempi:

    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/

Argomentazioni	Descrizione
`[target-path]`	Opzionale Percorso della cartella del progetto della libreria da impacchettare. Se omesso, il comando utilizzerà per impostazione predefinita la directory corrente. Se solo `[zip-path]` è impostato, quindi usa `.` qui come segnaposto per la directory corrente.
`[zip-path]`	Directory in cui verrà salvato l'archivio compresso della libreria. Se omessa, l'archivio verrà creato nella stessa directory della libreria.

Argomentazioni

Descrizione

[target-path]

Opzionale

Percorso della cartella del progetto della libreria da impacchettare. Se omesso, il comando utilizzerà per impostazione predefinita la directory corrente. Se solo [zip-path] è impostato, quindi usa . qui come segnaposto per la directory corrente.

[zip-path]

Directory in cui verrà salvato l'archivio compresso della libreria. Se omessa, l'archivio verrà creato nella stessa directory della libreria.

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log per la registrazione sulla console, ad esempio `trace`, `debug`, `information`, `warning`, O `error`. Per impostazione predefinita, nulla viene registrato nella console (`none`).

Comando CLI: `c4-cli library save-compiled`

Salva una libreria specifica come libreria compilata

Utilizzo:

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

Esempio 42. Esempi:

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

Argomentazioni	Descrizione
`<library-path>`	Percorso della libreria da compilare. I target validi sono la directory del progetto della libreria, un `Libraries.json` file o un `Libraries.lock.json` file. Utilizzare `.` per la directory corrente.
`<destination-path>`	Percorso in cui verrà memorizzata la libreria compilata. Se si tratta di una directory, la libreria compilata verrà salvata in un file denominato `{LibraryName}.compiled-library-v3` all'interno della directory.

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log per la registrazione sulla console, ad esempio `trace`, `debug`, `information`, `warning`, O `error`. Per impostazione predefinita, nulla viene registrato nella console (`none`).
`-d, --dry-run`	Opzionale. Quando il flag è impostato, il comando segnalerà nel modo consueto quali modifiche sarebbero state apportate durante l'esecuzione. Tuttavia, il file system non verrà modificato.
`--overwrite`	Sovrascrive il file di destinazione se esiste già.
`--compiler-version`	Utilizza una versione predefinita del compilatore
`--set-version`	Sovrascrive la versione della libreria. Se questo flag è impostato, allora usa questo valore invece della versione semver in `ProjectInfo.json` file della libreria.
`--assert-version`	Controlla la versione nel `ProjectInfo.json` Il file viene analizzato e il processo viene interrotto se non corrisponde alla versione specificata.
`--compression-level`	Livello di compressione per l'archivio ZIP
`--set-released-flag`	Se questo flag è impostato, il flag 'Released' verrà sovrascritto con il valore specificato nella libreria compilata. Se questo flag è impostato, verrà imposto anche un campo etichette prerelease vuoto. In questo caso, la generazione della libreria fallirà se uno dei due `--set-prerelease-labels` l'opzione è impostata con una stringa non vuota, oppure `SemVer version` campo nel `ProjectInfo.json` il file specifica le etichette di pre-rilascio che non sono state esplicitamente sovrascritte con una stringa vuota tramite il `--set-prerelease-labels` opzione.
`--set-prerelease-labels`	Sovrascrive le etichette di pre-rilascio. Se questo flag è impostato, questo valore verrà utilizzato al posto delle etichette di pre-rilascio semver nel `ProjectInfo.json` file della libreria. Se il valore è impostato su `--`, quindi verrà creata una libreria senza un'etichetta di prerelease, anche se un'etichetta è specificata nel `ProjectInfo.json` file. Un'etichetta di pre-rilascio non vuota è in conflitto con `--set-released-flag`; Perciò, `--set-prerelease-labels` non può essere utilizzato con un'etichetta non vuota quando `--set-released-flag` il flag è impostato su true, oppure `released` Il flag è impostato nelle informazioni del progetto. Questo valore esclude il leader `-` che separa l'etichetta della versione e l'etichetta della pre-release nella notazione semver.
`--set-buildinfo-labels`	Sovrascrive le etichette delle informazioni di build. Se questo flag è impostato, questo valore verrà utilizzato al posto dell'etichetta delle informazioni di build della versione semver nel `ProjectInfo.json` file della libreria. Se il valore è impostato su `--`, quindi verrà creata una libreria senza un'etichetta di informazioni di build, anche se un'etichetta è specificata nel `ProjectInfo.json` file. Questo valore esclude il primo `+` che separa l'etichetta della versione o l'etichetta di pre-release dalla parte relativa alle informazioni di build nella notazione semver.
`--assert-prerelease-labels`	Controlla le etichette di pre-rilascio del `semver version` campo nel `ProjectInfo.json` file della libreria e interrompe il processo se non corrisponde alle etichette specificate. Può essere utilizzato per controlli di validità nella pipeline. Quando il valore è impostato su `--`, questo garantirà che il `ProjectInfo.json` Il file non specifica alcuna etichetta di pre-rilascio.
`--assert-buildinfo-labels`	Controlla le etichette delle informazioni di build del campo della versione semver nel `ProjectInfo.json` file della libreria e interrompe il processo se non corrisponde alle etichette specificate. Può essere utilizzato per controlli di validità nella pipeline. Quando il valore è impostato su `--`, questo garantirà che il `ProjectInfo.json` Il file non specifica alcuna etichetta di informazioni sulla build. Questo valore esclude l'iniziale `+` che separa l'etichetta della versione o l'etichetta di pre-release dalla parte relativa alle informazioni di build nella notazione semver.
`--include-libdoc`	Percorso dell'archivio principale della documentazione compilata creato dalla toolchain libdoc, solitamente denominato `doc.lmd` O `__lmd__.aux[iliary]` Compilare i file nella stessa cartella che rispettano la convenzione di denominazione `__lmd__.aux[iliary]` saranno inclusi anche i casi in cui `` corrisponde al codice lingua/paese ISO.

Comando CLI: `c4-cli library verify`

Verifica se le risoluzioni della libreria in Libraries.lock.json sono ancora validi e corrispondono ancora Libraries.json Verifica che tutte le librerie siano accessibili nella cache delle librerie e che non esistano riferimenti duplicati, pacchetti aggiornati o file orfani.

Utilizzo:

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

Esempio 43. Esempi:

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

Argomentazioni	Descrizione
`[target-path]`	Percorso della destinazione del comando. Se omesso, il comando utilizzerà per impostazione predefinita la directory corrente. Le destinazioni valide sono una directory dell'applicazione, `Libraries.json` file o un `Libraries.lock.json` file.

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log per la registrazione sulla console, ad esempio `trace`, `debug`, `information`, `warning`, O `error`. Per impostazione predefinita, nulla viene registrato nella console (`none`).

Comando CLI: `c4-cli library check`

Verifica il progetto della libreria e segnala eventuali errori e avvisi rilevati.

Utilizzo:

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

Argomentazioni	Descrizione
`[library-path]`	Percorso del progetto della libreria da controllare. Se omesso, il comando utilizzerà per impostazione predefinita la directory corrente.

Opzioni	Descrizione
`-h, --help`	Visualizza la guida per il comando
`-v, --verbose`	Consente l'accesso alla console all' `information` livello; Forma abbreviata di `--log-level=information`
`--log-level`	Imposta il livello di log per la registrazione sulla console, ad esempio `trace`, `debug`, `information`, `warning`, O `error`. Per impostazione predefinita, nulla viene registrato nella console (`none`).
`-d, --dry-run`	Opzionale. Quando il flag è impostato, il comando segnalerà nel modo consueto quali modifiche sarebbero state apportate durante l'esecuzione. Tuttavia, il file system non verrà modificato.
`--pointer-size`	Dimensione del puntatore presunta (in bit); può essere `32` O `64` (valore predefinito) `32` )
`--compiler-defines`	Elenco di definizioni del compilatore separate da virgole da impostare

In questa sezione:

Comando CLI: c4-cli library

Comando CLI: c4-cli library set-managed

Comando CLI: c4-cli library set-relative

Comando CLI: c4-cli library set-placeholder

Comando CLI: c4-cli library install

Comando CLI: c4-cli library install-placeholder

Comando CLI: c4-cli library install-managed

Comando CLI: c4-cli library install-relative

Comando CLI: c4-cli library restore

Comando CLI: c4-cli library clean-install

Comando CLI: c4-cli library uninstall

Comando CLI: c4-cli library resolve

Comando CLI: c4-cli library remove

Comando CLI: c4-cli library prune

Comando CLI: c4-cli library outdated

Comando CLI: c4-cli library list

Comando CLI: c4-cli library explain

Comando CLI: c4-cli library pack

Comando CLI: c4-cli library save-compiled

Comando CLI: c4-cli library verify

Comando CLI: c4-cli library check

Risultati della ricerca

Comando CLI: `c4-cli library`

Comando CLI: `c4-cli library set-managed`

Comando CLI: `c4-cli library set-relative`

Comando CLI: `c4-cli library set-placeholder`

Comando CLI: `c4-cli library install`

Comando CLI: `c4-cli library install-placeholder`

Comando CLI: `c4-cli library install-managed`

Comando CLI: `c4-cli library install-relative`

Comando CLI: `c4-cli library restore`

Comando CLI: `c4-cli library clean-install`

Comando CLI: `c4-cli library uninstall`

Comando CLI: `c4-cli library resolve`

Comando CLI: `c4-cli library remove`

Comando CLI: `c4-cli library prune`

Comando CLI: `c4-cli library outdated`

Comando CLI: `c4-cli library list`

Comando CLI: `c4-cli library explain`

Comando CLI: `c4-cli library pack`

Comando CLI: `c4-cli library save-compiled`

Comando CLI: `c4-cli library verify`

Comando CLI: `c4-cli library check`