Installer le Compilateur Solidity

Versionnage

Les versions de Solidity suivent un versionnage sémantique et en plus des versions stables, des versions de développement nightly sont également disponibles. Les versions nightly ne sont pas garanties de fonctionner et malgré tous les efforts, elles peuvent contenir des changements non documentés et/ou cassés. Nous vous recommandons d’utiliser la dernière version. Les installateurs de paquets ci-dessous utilisent la dernière version.

Remix

Nous recommandons Remix pour les petits contrats et pour l’apprentissage rapide de Solidity.

Accédez à Remix en ligne, vous n’avez rien à installer. Si vous voulez l’utiliser sans connexion à Internet, allez à https://github.com/ethereum/remix-live/tree/gh-pages et téléchargez le fichier .zip tel qu’expliqué sur cette page.

D’autres options sur cette page détaillent l’installation du compilateur Solidity en ligne de commande sur votre ordinateur. Choisissez un compilateur de ligne de commande si vous travaillez sur un contrat plus important ou si vous avez besoin de plus d’options de compilation.

npm / Node.js

Utilisez npm” pour un moyen pratique et portable d’installer `solcjs”, un compilateur Solidity. Le programme `solcjs a moins de fonctionnalités que le compilateur décrit plus bas sur cette page. La documentation du Using the Commandline Compiler suppose que vous utilisez le compilateur complet, solc. L’utilisation de solcjs est documentée dans son propre dépot.

Note : Le projet solc-js est dérivé du projet C++ solc en utilisant Emscripten, ce qui signifie que les deux utilisent le même code source du compilateur. `solc-js” peut être utilisé directement dans les projets JavaScript (comme Remix). Veuillez vous référer au dépôt solc-js pour les instructions.

npm install -g solc

Note

L’exécutable en ligne de commande est nommé `solcjs”.

Les options de la ligne de commande de `solcjs” ne sont pas compatibles avec `solc” et les outils (tels que `geth”) attendant le comportement de `solc” ne fonctionneront pas avec `solcjs”.

Docker

Nous fournissons des images dockers à jour pour le compilateur. Le dépot stable contient les versions publiées tandis que le dépôt nightly contient des changements potentiellement instables dans la branche develop.

docker run ethereum/solc:stable --version

Actuellement, l’image du docker ne contient que l’exécutable du compilateur, donc vous devez faire un peu plus de travail pour lier le code source et répertoires de sortie.

Paquets binaires

Les binaires de Solidity sont disponibles à solidity/releases.

Nous avons également des PPAs for Ubuntu, vous pouvez obtenir la dernière version via la commande:

sudo add-apt-repository ppa:ethereum/ethereum
sudo apt-get update
sudo apt-get install solc

La version nigthly peut s’installer avec la commande:

sudo add-apt-repository ppa:ethereum/ethereum
sudo add-apt-repository ppa:ethereum/ethereum-dev
sudo apt-get update
sudo apt-get install solc

Nous publions également un package snap, installable dans toutes les distributionss linux supportées. Pour installer la dernière evrsion stable de solc:

sudo snap install solc

Si vous voulez aider aux tests en utilisant la dernière version de développement, avec les changements l;es plus récents, merci d’utiliser:

sudo snap install solc --edge

Arch Linux a aussi des paquets, bien que limités à la dernière version de développement:

pacman -S solidity

Nous distribuons également le compilateur Solidity via homebrew dans une version compilée à partir des sources. Les « bottles » pré-compilées ne sont pas encore supportées pour l’instant.

brew update
brew upgrade
brew tap ethereum/ethereum
brew install solidity

Si vous avec besoin d’une version spécifique, vous pouvez exécuter la formule homebrew correspondante disponible sur GitHub.

Regarder commits de solidity.rb sur Github.

Suivez l’historique des liens jusqu’à avoir un lien de ficher brut (« raw ») d’un commit spécifique de solidity.rb.

Installez-le via brew:

brew unlink solidity
# Install 0.4.8
brew install https://raw.githubusercontent.com/ethereum/homebrew-ethereum/77cce03da9f289e5a3ffe579840d3c5dc0a62717/solidity.rb

Gentoo Linux dispose aussi d” un paquet Solidity installable via emerge:

emerge dev-lang/solidity

Compilation à partir des sources

Prérequis - Linux

Vous aurez besoin des dépendances suivantes pour les compilations de Solidity sous Linux:

Software Notes
Git pour Linux Outils en ligne de commande pour r’ecup’erer des fichiers sur github

Prérequis - macOS

Pour macOS, assurez-vous d’avoir installer la dernière version de Xcode. Ceci contient le compilateur C++ Clang, l’IDE Xcode et d’autres outils de développement Apple qui sont nécessaires pour construire des applications C++ sous OS X. Si vous installez Xcode pour la première fois, ou si vous venez d’installer une nouvelle version, vous devrez accepter la licence avant de pouvoir compiler en ligne de commande:

sudo xcodebuild -license accept

Nos versions pour OS X exigent que vous installiez Homebrew <http://brew.sh>`_http://brew.sh pour l’installation des dépendances externes. Voici comment `désinstaller Homebrew, si vous voulez recommencer à zéro.

Prérequis - Windows

Vous aurez besoin des dépendances suivants pour la compilation de solidity sous Windows:

Software Notes
Git pour Linux Outils en ligne de commande pour r’ecup’erer des fichiers sur github
CMake Générateur de fichiers d’installation multi-plateformes
Visual Studio 2017 Build Tools Compilateur C++
Visual Studio 2017 (Optional) Environment de développement et compilateur C++.

Si vous avez déjà eu un IDE et que vous n’avez besoin que du compilateur et des bibliothèques, vous pouvez installer Visual Studio 2017 Build Tools.

Visual Studio 2017 fournit à la fois l’IDE et le compilateur et les bibliothèques nécessaires. Donc si vous n’avez pas d’IDE et que vous préférez développer en Solidity, Visual Studio 2017 peut être un choix pour tout installer facilement.

Voici la liste des composants à installer dans Visual Studio 2017 Build Tools ou Visual Studio 2017 :

  • Visual Studio C+++ fonctionnalités de base
  • VC+++ 2017 v141 toolset (x86,x64)
  • Windows Universal CRT SDK
  • Windows 8.1 SDK
  • Support C+++/CLI

Clonez le dépot

Pour cloner le code source, exécutez la commande suivante:

git clone --recursive https://github.com/ethereum/solidity.git
cd solidity

Si vous voulez aider à développer Solidity, vous devriez forker Solidity et ajouter votre fork comme un second remote (dépot distant):

git remote add personal git@github.com:[username]/solidity.git

Solidity a des submodules Git. Vérifiez qu’ils sont proprement chargés:

git submodule update --init --recursive

Dépendances externes

Nous avons un script d’aide qui installe toutes les dépendances externes requises sur macOS, Windows et de nombreuses distributions Linux.

./scripts/install_deps.sh

Ou, sous Windows:

scripts\install_deps.bat

Compilation en ligne de commande

Soyez sûrs d’installer les dépendances externes avant de compiler.

Le projet Solidity utilise CMake pour la configuration de compilation. Vous voulez peut-être installer ccache pour accélérer des compilations successives. CMake l’utilisera automatiquement. Compiler Solidity est similaire sur Linux, macOS et autres systèmes Unix:

mkdir build
cd build
cmake .. && make

ou encore plus simplement:

#note: les binaires de solc et les tests seront installés dans usr/local/bin
./scripts/build.sh

Et pour Windows:

mkdir build
cd build
cmake -G "Visual Studio 15 2017 Win64" ..

Ce dernier ensemble d’instructions devrait aboutir à la création de solidity.sln dans ce répertoire de compilation. Double-cliquer sur ce fichier devrait faire démarrer Visual Studio. Nous suggérons de construire la configuration RelWithDebugInfo, mais toutes les autres fonctionnent.

Alternativement, vous pouvez compiler pour Windows en ligne de commande, comme ça :

cmake --build . --config RelWithDebInfo

Options de CMake

La liste des options de Cmake est disponible via la commande: cmake .. -LH.

Solveurs SMT

Solidity peut être compilé avec les solveurs SMT et le fera par défaut s’ils sont trouvés dans le système. Chaque solveur peut être désactivé par une option cmake.

Remarque : Dans certains cas, cela peut également être une solution de contournement potentielle en cas d’échec de compilation.

Dans le dossier de compilation, vous pouvez les désactiver, car ils sont activés par défaut :

# désactive seulement Z3 SMT Solver.
cmake .. -DUSE_Z3=OFF

# désactive seulement CVC4 SMT Solver.
cmake .. -DUSE_CVC4=OFF

# désactive Z3 et CVC4
cmake .. -DUSE_CVC4=OFF -DUSE_Z3=OFF

La string de version en détail

La string de version de Solidity contient 4 parties:

  • le numéro de version
  • la balise de pre-version, généralement définie sur develop.YYYY.MM.DD ou nightly.YYYY.MM.DD.
  • commit au format commit.GITHASH.
  • plate-forme, qui a un nombre arbitraire d’éléments, contenant des détails sur la plate-forme et le compilateur

S’il y a des modifications locales, le commit sera suffixé avec .mod.

Ces parties sont combinées comme l’exige Semver, où la balise de pré-version Solidity est identique à la pré-version de Semver. et le commit Solidity et la plate-forme Solidity combinés constituent les métadonnées de la construction Semver.

Un exemple de version : `0.4.8+commit.60cc1668.Emscripten.clang.

Un exemple de pré-version : 0.4.9-nightly.2017.1.17+commit.6ecb4aaa3.Emscripten.clang

Informations importantes concernant le versionnage

Après la sortie d’une version, la version de correctif est incrémentée, parce que nous supposons que seulement les changements de niveau patch suivent. Lorsque les modifications sont fusionnées, la version doit être supprimée en fonction des éléments suivants et la gravité du changement. Enfin, une version est toujours basée sur la nigthly actuelle, mais sans le spécificateur prerelease.

Exemple :

  1. la version 0.4.0 est faite
  2. nightly build a une version de 0.4.1 à partir de maintenant
  3. des modifications incessantes sont introduites - pas de changement de version
  4. un changement de rupture est introduit - la version est augmentée à 0.5.0
  5. la version 0.5.0 est faite

Ce comportement fonctionne bien avec le version pragma.