View a markdown version of this page

Istruzioni per il file manifest di FreeRTOS - FreeRTOS

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Istruzioni per il file manifest di FreeRTOS

È necessario un file manifest per AWS IoT Device Tester identificare le versioni e le librerie utilizzate. Aiuta i clienti a delineare le versioni, le dipendenze delle librerie e i metadati.

Il file deve soddisfare i seguenti requisiti:

  • Il deve essere denominato manifest.yml.

  • Deve trovarsi nella cartella base della libreria o del pacchetto.

  • Deve essere in formato YAML e seguire le specifiche YAML 1.2.

I parametri possono essere in qualsiasi ordine, ma ti consigliamo di inserirli nell'ordine elencato di seguito per una leggibilità ottimale. Aggiungi commenti al file per aiutare i clienti a utilizzare il tuo pacchetto.

Percorso del file

Si trova nella radice di un pacchetto o di una libreria. Esiste un solo file manifest per pacchetto. Le dipendenze introdotte possono avere i propri file manifest.

Parameters
nome

Il nome del pacchetto. Tutti gli spazi devono essere sostituiti con un carattere di sottolineatura (_). Ad esempio, My project name - 2020 dovrebbe essere cambiato in. My_project_name_-_2020

  • tipo: string

  • obbligatorio: vero

  • Lunghezza minima: 1

  • Lunghezza massima: 40

version

La versione del pacchetto. La versione può essere una versione di rilascio o un tag di versione.

  • tipo: string

  • obbligatorio: vero

  • Lunghezza minima: 1

  • Lunghezza massima: 30

description

La descrizione leggibile dall'uomo del pacchetto. La descrizione deve descrivere chiaramente cos'è il pacchetto e cosa fornisce.

  • tipo: string

  • obbligatorio: vero

  • Lunghezza minima: 30

  • Lunghezza massima: 255

dependencies

Un elenco di tutte le dipendenze di primo livello necessarie a un utente per creare correttamente questo pacchetto e che possono essere recuperate da un host di codice sorgente Git, Subversion o Mercurial. Non includere dipendenze che non sono disponibili tramite Git, SVG o hg. Non includete le dipendenze utilizzate per i test, la generazione di documentazione o lo sviluppo. Per promuovere una buona esperienza, ti consigliamo di evitare di elencare dipendenze chiuse o private.

  • tipo: array

  • richiesto: falso

  • Lunghezza minima: 0

dipendenze [] .name

Il nome del pacchetto di una dipendenza. Deve corrispondere al nome del pacchetto trovato nel parametro della name dipendenza.

  • tipo: string

  • obbligatorio: true

  • Lunghezza minima: 1

  • Lunghezza massima: 40

dipendenze [] .version

La versione di una dipendenza. La versione può essere una versione di rilascio o un tag di versione. Se nel pacchetto stesso sono incluse delle dipendenze, la versione deve corrispondere al file manifesto che si trova nella dipendenza.

  • tipo: string

  • obbligatorio: vero

  • Lunghezza minima: 1

  • Lunghezza massima: 30

dipendenze [] .repository

Descrive la posizione del codice sorgente della dipendenza.

  • tipo: dizionario

  • richiesto: vero

dipendenze [] .repository.type

Il tipo di repository.

  • tipo: string

  • obbligatorio: vero

  • enum: [git, svn, hg]

dipendenze [] .repository.url

L'URL della posizione del repository. Deve essere un URL completo con un prefisso di protocollo (ad esempio, https://github.com/ACCOUNT_NAME/REPO_NAME).

  • tipo: string

  • obbligatorio: vero

dipendenze [] .repository.path

Il percorso relativo dall'area di lavoro del progetto per la dipendenza.

  • tipo: string

  • obbligatorio: vero

dipendenze [] .repository.branch

Il ramo della dipendenza utilizzato. Se il pacchetto utilizza il ramo di rilascio delle librerie, non includete questo parametro per mantenere la lunghezza del manifest al minimo.

  • tipo: string

  • obbligatorio: false

license

L'identificatore di licenza SPDX della libreria. Per l'elenco completo, consulta https://spdx.org/licenses/. Dovrebbe corrispondere al LICENSE file incluso nella radice del repository, se esiste.

  • tipo: string

  • obbligatorio: vero