Spark.IO-CLI

De MCHobby - Wiki
Aller à : navigation, rechercher

MCHobby investit du temps et de l'argent dans la réalisation de traduction et/ou documentation. C'est un travail long et fastidieux réalisé dans l'esprit Open-Source... donc gratuit et librement accessible.
SI vous aimez nos traductions et documentations ALORS aidez nous à en produire plus en achetant vos produits chez MCHobby.

Qu'est ce que Spark CLI?

CLI est l'acronyme de Command Line Interface signifiant littéralement "interface en ligne de commande" (wikipedia). Une console en mode texte permettant d'interpréter des commandes, commandes qui vous permettrons de programmer et d'interagir avec vos Spark Core (et le Spark Cloud).

Le Spark CLI est un outil vraiment puissant. Le CLI utilise node.js et fonctionne avec aisance sous Windows, Mac OS X et Linux. Spark CLI est également open source (GitHub, Spark.IO), vous pouvez donc l'inspecter sous le capot et le modifier et même partager vos changements avec Spark (via un "pull requests") si vous le désirez!

Installation du CLI

Installation standard

Pour commencer, assurez vous d'avoir installé node.js.

ATTENTION: si vous disposez d'Ubuntu ou Linux Mint (17), voyez la section "installation avancée" pour installer la dernière version de node.js!

Ensuite, ouvrez un terminal (une ligne de commande) et installer le CLI en tapant:

# Comment installer spark-cli
$ npm install -g spark-cli

Tester l'installation

Pour finir, testez simplement l'installation de Spark CLI en invoquant la commande spark depuis un terminal

$ spark

vous devriez voir un résultat similaire à ceci:

Welcome to the Spark Command line utility!
https://github.com/spark/spark-cli

Usage: spark <command_name> <arguments> 
Common Commands:

    setup, list, call, get, core, identify, flash, subscribe
    compile, monitor, login, logout, help

Less Common Commands:
    cloud, config, function, keys, serial, udp, variable
    webhook

For more information Run: spark help <command_name>

Installation avancée

Pour utiliser les fonctionnalités de flash et cle (key) locales vous aurez besoin d'installer dfu-util et openssl. Ces outils sont librement accessible en Open-Source et disposent de programme d'installation/binaires pour la plupart des plateformes.

Voici quelques tutoriels disponibles sur la communauté reprennant quelques installation complètes:

Mise-à-jour le CLI

Pour faire une mise-à-jour de Spark-CLI, il faut exécuter la commande suivante:

# Comment mettre-à-jour votre Spark-Cli
$ npm update -g spark-cli

Avancé: exécuter le CLI depuis les sources

Vous pouvez obtenir une copie des sources du CLI pour jouer avec...

# Comment prendre les sources pour le CLI
$ git clone git@github.com:spark/spark-cli.git
$ cd spark-cli/js
$ node app.js help

Se Logger

Comme pour toute opération sur le Spark Cloud, il est nécessaire de disposer d'un compte Spark Cloud.

Ce compte est également utiliser avec l'utilitaire CLI. Vous devez donc vous logger à l'aide de la commande spark cloud login, cette opération doit être réalisée une fois.

$ spark cloud login

Cette opération vous demandera l'adresse email utilisé pour le compte Spark Cloud (et le mot de passe bien entendu).

Si vous disposez déjà d'un compte, ce dernier sera utilisé (ainsi que l'ACCESS_TOKEN qui y est associé).


Source: Spark CLI (command line interface) créé par Spark.IO.

Traduction réalisée et augmentée par Meurisse D pour MCHobby.be - Translated and upsized by Meurisse D. for MCHobby.be

Traduit avec l'autorisation de Spark.IO - Translated with the permission from Spark.IO - Spark.IO

Toute référence, mention ou extrait de cette traduction doit être explicitement accompagné du texte suivant : «  Traduction par MCHobby (www.MCHobby.be) - Vente de kit et composants » avec un lien vers la source (donc cette page) et ce quelque soit le média utilisé.

L'utilisation commercial de la traduction (texte) et/ou réalisation, même partielle, pourrait être soumis à redevance. Dans tous les cas de figures, vous devez également obtenir l'accord du(des) détenteur initial des droits. Celui de MC Hobby s'arrêtant au travail de traduction proprement dit.