Instructions gratuites pour les fichiers RTOS manifestes - Gratuit RTOS

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Instructions gratuites pour les fichiers RTOS manifestes

Un fichier manifeste est requis pour AWS IoT Device Tester pour identifier les versions et les bibliothèques utilisées. Il aide les clients à définir les versions, les dépendances des bibliothèques et les métadonnées.

Le fichier doit répondre aux exigences suivantes :

  • Le fichier doit être nommé manifest.yml.

  • Il doit se trouver dans le dossier de base de la bibliothèque ou du package.

  • Il doit être au YAML format et respecter les spécifications YAML 1.2.

Les paramètres peuvent être dans n'importe quel ordre, mais nous vous recommandons de les placer dans l'ordre indiqué ci-dessous pour une lisibilité optimale. Ajoutez des commentaires au fichier pour aider les clients à utiliser votre package.

Chemin d'accès du fichier

Situé à la racine d'un package ou d'une bibliothèque. Il n'existe qu'un seul fichier manifeste par package. Les dépendances introduites peuvent avoir leurs propres fichiers manifestes.

Paramètres
nom

Le nom du package. Tous les espaces doivent être remplacés par un trait de soulignement (_). Par exemple, My project name - 2020 doit être remplacé parMy_project_name_-_2020.

  • type : chaîne

  • obligatoire : vrai

  • minLength: 1

  • maxLength: 40

version

Version du package. La version peut être une version de lancement ou une balise de version.

  • type : chaîne

  • obligatoire : vrai

  • minLength: 1

  • maxLength: 30

description

Description lisible par l'homme du package. La description doit clairement décrire ce qu'est le package et ce qu'il fournit.

  • type : chaîne

  • obligatoire : vrai

  • minLength: 30

  • maxLength: 255

dependencies

Liste de toutes les dépendances de premier niveau requises pour qu'un utilisateur puisse créer correctement ce package et qui peuvent être récupérées par un hôte de code source Git, Subversion ou Mercurial. N'incluez pas les dépendances qui ne sont pas disponibles via Git ou hg. SVG N'incluez pas les dépendances utilisées pour les tests, la génération de documentation ou le développement. Pour garantir une bonne expérience, nous vous recommandons d'éviter de répertorier les dépendances fermées ou privées.

  • type : tableau

  • obligatoire : faux

  • minLength: 0

dépendances [] .name

Le nom du package d'une dépendance. Il doit correspondre au nom du package indiqué dans le name paramètre de la dépendance.

  • type : chaîne

  • obligatoire : vrai

  • minLength: 1

  • maxLength: 40

dépendances [] .version

Version d'une dépendance. La version peut être une version de lancement ou une balise de version. Si des dépendances sont incluses dans le package lui-même, la version doit correspondre au fichier manifeste qui se trouve dans la dépendance.

  • type : chaîne

  • obligatoire : vrai

  • minLength: 1

  • maxLength: 30

dépendances [] .repository

Décrit l'emplacement du code source de dépendance.

  • type : dictionnaire

  • obligatoire : vrai

dépendances [] .repository.type

Type de référentiel.

  • type : chaîne

  • obligatoire : vrai

  • énumération : [git, svn, hg]

dépendances [] .repository.url

URLL'emplacement du référentiel. Il doit s'agir d'un fichier complet URL avec un préfixe de protocole (par exemple,/ https://github.comACCOUNT_NAME/REPO_NAME).

  • type : chaîne

  • obligatoire : vrai

dépendances [] .repository.path

Le chemin relatif de la dépendance depuis l'espace de travail du projet.

  • type : chaîne

  • obligatoire : vrai

dépendances [] .repository.branch

Branche de la dépendance utilisée. Si le package utilise la branche release des bibliothèques, n'incluez pas ce paramètre pour réduire au minimum la longueur du manifeste.

  • type : chaîne

  • obligatoire : faux

licence

Identifiant de SPDX licence de la bibliothèque. Pour la liste complète, consultez https://spdx.org/licenses/. Il doit correspondre au LICENSE fichier inclus dans la racine du dépôt s'il existe.

  • type : chaîne

  • obligatoire : vrai