Installation et configuration de l'extension Blockchain App Builder pour Visual Studio Code

L'extension Blockchain App Builder pour Visual Studio Code peut être téléchargée via la console Oracle Blockchain Platform.

Les plates-formes suivantes sont prises en charge :
  • macOS
  • Oracle Linux 8.0 ou 9.0
  • Microsoft Windows 10 ou 11

Prérequis

Avant d'installer Blockchain App Builder sur votre système local, vous devez installer les prérequis.

Remarques :

Blockchain App Builder est coordonné avec Oracle Blockchain Platform et ses compilateurs. Si vous utilisez une version des prérequis autre que celles mentionnées dans la section suivante, le déploiement de votre code chaîne sur un réseau Oracle Blockchain Platform distant peut échouer.

Lorsque vous installez Blockchain App Builder, une vérification des prérequis est exécutée en premier. Si la vérification des prérequis échoue, le processus d'installation est arrêté.

Prérequis

  • Bureau Rancher (testé avec la version 1.4.1). Blockchain App Builder peut également fonctionner avec Docker, mais il a été testé et vérifié avec Rancher Desktop. Si vous prévoyez d'utiliser Rancher Desktop, désinstallez complètement Docker avant d'installer Rancher Desktop. Après avoir installé Rancher Desktop, assurez-vous que l'exécution de conteneur est définie sur dockerd (moby). Pour vérifier l'exécution de conteneur dans Rancher Desktop 1.4.1, cliquez sur Paramètres Kubernetes > Exécution de conteneur.
  • Dernière version de Node.js version 18 (testée avec les versions 18.15.0 et 18.16.0) et npm v8.x ou 9.x (testée avec les versions 9.5.0 et 9.5.1)

    Vérifiez la version de Node.js en exécutant la commande suivante : node --version

    Vérifiez la version npm en exécutant la commande suivante : npm --version

    Si vous utilisez un gestionnaire tel que nvm ou nodenv pour installer Node.js et npm, définissez la version par défaut/globale, puis redémarrez Visual Studio Code afin que la version soit détectée par la page Prérequis.

    N'utilisez pas les versions de Node.js antérieures ou postérieures à la version 18.

  • Go v1.23.2 ou version ultérieure, mais pas Go v1.24 ou version ultérieure. Après avoir installé Blockchain App Builder, reportez-vous à Configuration supplémentaire pour les projets de code chaîne Go.

    Vérifiez la version Go en exécutant la commande suivante : go version

  • Si vous prévoyez d'utiliser la fonctionnalité de synchronisation de Blockchain App Builder, installez Git et configurez votre nom d'utilisateur et votre adresse électronique comme indiqué dans les commandes suivantes. Indiquez votre nom utilisateur et votre adresse électronique à la place de <your_name> et <email>. 
    git config --global user.name "<your_name>" 

    git config --global user.email "<email>"
  • Visual Studio Code version 1.66.0 ou ultérieure

    Vérifiez la version de Visual Studio Code en exécutant la commande suivante : code --version

Installer Node.js et npm à l'aide de nvm

L'utilisation de nvm pour installer Node.js et npm vous permet d'exécuter plus de commandes sans sudo.
  1. Entrez la commande suivante pour installer nvm :
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
  2. Ajoutez le fragment de code suivant au fichier applicable : ~/.bash_profile, ~/.profile, ~/.bashrc ou ~/.zshrc.
    export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion
  3. Déconnectez-vous, puis reconnectez-vous à votre système d'exploitation.
  4. Saisissez la commande suivante pour vérifier l'installation de nvm :
    nvm version
  5. Entrez la commande suivante pour installer Node.js et npm :
    nvm install 18.16.0
  6. Entrez la commande suivante pour définir Node.js 18.16.0 comme valeur par défaut dans nvm :
    nvm alias default 18.16.0
    La sortie de la commande est le texte suivant :
    default -> 18.16.0 (-> v18.16.0)

Prérequis

  • Docker version 18.09.0 ou ultérieure
  • Docker Compose version 1.23.0 ou ultérieure
  • Dernière version de Node.js version 18 (testée avec les versions 18.15.0 et 18.16.0) et npm v8.x ou v9.x (testée avec les versions 9.5.0 et 9.5.1)

    Vérifiez la version de Node.js en exécutant la commande suivante : node --version

    Vérifiez la version npm en exécutant la commande suivante : npm --version

    Si vous utilisez un gestionnaire tel que nvm ou nodenv pour installer Node.js et npm, définissez la version par défaut/globale, puis redémarrez Visual Studio Code afin que la version soit détectée par la page Prérequis.

    N'utilisez pas les versions de Node.js antérieures ou postérieures à la version 18.

  • Go v1.23.2 ou version ultérieure, mais pas Go v1.24 ou version ultérieure. Après avoir installé Blockchain App Builder, reportez-vous à Configuration supplémentaire pour les projets de code chaîne Go.

    Vérifiez la version Go en exécutant la commande suivante : go version

  • Si vous prévoyez d'utiliser la fonctionnalité de synchronisation de Blockchain App Builder, installez Git et configurez votre nom d'utilisateur et votre adresse électronique comme indiqué dans les commandes suivantes. Indiquez votre nom utilisateur et votre adresse électronique à la place de <your_name> et <email>. 
    git config --global user.name "<your_name>" 

    git config --global user.email "<email>"
  • Visual Studio Code version 1.66.0 ou ultérieure

    Vérifiez la version de Visual Studio Code en exécutant la commande suivante : code --version

Installer Node.js et npm à l'aide de nvm

L'utilisation de nvm pour installer Node.js et npm vous permet d'exécuter plus de commandes sans sudo.
  1. Entrez la commande suivante pour installer nvm :
    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.35.3/install.sh | bash
  2. Ajoutez le fragment de code suivant au fichier applicable : ~/.bash_profile, ~/.profile, ~/.bashrc ou ~/.zshrc.
    export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # This loads nvm
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion
  3. Déconnectez-vous, puis reconnectez-vous à votre système d'exploitation.
  4. Saisissez la commande suivante pour vérifier l'installation de nvm :
    nvm version
  5. Entrez la commande suivante pour installer Node.js et npm :
    nvm install 18.16.0
  6. Entrez la commande suivante pour définir Node.js 18.16.0 comme valeur par défaut dans nvm :
    nvm alias default 18.16.0
    La sortie de la commande est le texte suivant :
    default -> 18.16.0 (-> v18.16.0)

Prérequis

  • Bureau Rancher (testé avec la version 1.4.1). Blockchain App Builder peut également fonctionner avec Docker, mais il a été testé et vérifié avec Rancher Desktop.
  • Dernière version de Node.js version 18 (testée avec les versions 18.15.0 et 18.16.0). N'utilisez pas les versions de Node.js antérieures ou postérieures à la version 18.
  • npm v8.x ou v9.x (testé avec les versions 9.5.0 et 9.5.1)
  • Go v1.23.2 ou version ultérieure, mais pas Go v1.24 ou version ultérieure. Après avoir installé Blockchain App Builder, reportez-vous à Configuration supplémentaire pour les projets de code chaîne Go.
  • Si vous souhaitez utiliser la fonctionnalité de synchronisation de Blockchain App Builder, installez Git et configurez votre nom d'utilisateur et votre adresse électronique comme indiqué dans les commandes suivantes. Indiquez votre nom utilisateur et votre adresse électronique à la place de <your_name> et <email>. 
    git config --global user.name "<your_name>" 

    git config --global user.email "<email>"

Installer le bureau Rancher

Pour installer le bureau Rancher sur Microsoft Windows, procédez comme suit :
  1. Si Docker est installé sur votre ordinateur local, désinstallez-le complètement.
  2. Téléchargez et installez Rancher Desktop.
  3. Une fois l'assistant d'installation terminé, avant d'ouvrir le bureau Rancher, exécutez les commandes suivantes :
    wsl --install
wsl --set-default-version 2
wsl --setdefault rancher-desktop
  4. Ouvrez le bureau Rancher pour terminer le processus de configuration.
  5. Après avoir installé Rancher Desktop, assurez-vous que l'exécution de conteneur est définie sur dockerd (moby). Pour vérifier l'exécution de conteneur dans Rancher Desktop 1.4.1, cliquez sur Paramètres Kubernetes > Exécution de conteneur.

Installation de l'extension Blockchain App Builder

  1. Téléchargez l'extension à partir de l'onglet Outils de développement du panneau Générateur d'applications Blockchain de la console Oracle Blockchain Platform. Dans le panneau Générateur d'applications Blockchain, sous la section Télécharger, sélectionnez Extension de code Visual Studio.
  2. Dans Visual Studio Code, ouvrez le panneau Extensions, puis, dans le menu Actions supplémentaires, sélectionnez Installer à partir de VSIX.
  3. Localisez le fichier oracle-ochain-extension-x.x.x.vsix téléchargé, puis cliquez sur Installer. (Ajoutez le nom du fichier .vsix à la version que vous installez.)
  4. Redémarrez Visual Studio Code pour terminer l'installation de l'extension.
  5. Pour utiliser les fonctions de validation du fichier de spécification, qui valident automatiquement le fichier de spécification lors de la saisie, installez l'extension YAML à partir de Red Hat. Ouvrez le panneau Extensions, recherchez YAML, installez l'extension de prise en charge des langues YAML, puis redémarrez Visual Studio Code.

Après l'installation, vous pouvez utiliser l'icône Oracle Blockchain App Builder sur le côté gauche de Visual Studio Code pour ouvrir le panneau Blockchain App Builder.

De plus, l'interface de ligne de commande (CLI) de Blockchain App Builder est automatiquement installée dans le cadre de l'extension de Visual Studio Code si vous ne l'avez pas déjà installée séparément. Les commandes de la CLI peuvent être exécutées à partir de n'importe quelle application de terminal, y compris la fenêtre de la console Visual Studio Code. Blockchain App Builder est installé globalement. Vous pouvez donc exécuter les commandes de la CLI à partir de n'importe quel emplacement du système de fichiers.

Configuration supplémentaire pour les projets Go Chaincode

Pour développer un projet Go, vous devez définir la variable d'environnement GOPATH. Cela permet à Go de localiser votre espace de travail et d'exécuter votre code.

Avant de définir la variable d'environnement GOPATH, assurez-vous qu'un dossier go/ existe dans votre répertoire $HOME. Sinon, entrez la commande suivante pour créer un répertoire go/ dans le répertoire de base :
mkdir $HOME/go
Définissez la variable d'environnement GOPATH en ajoutant les variables suivantes au fichier applicable : ~/.bash_profile, ~/.profile, ~/.bashrc ou ~/.zshrc.
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
Après avoir modifié le fichier, exécutez la commande suivante pour que vos modifications prennent effet immédiatement :
source ~/.bash_profile

Vous pouvez également appliquer la modification à l'échelle du système en ajoutant les variables précédentes au fichier /etc/bashrc.

Avant de définir la variable d'environnement GOPATH, assurez-vous qu'un dossier go/ existe dans votre répertoire $HOME. Sinon, entrez la commande suivante pour créer un répertoire go/ dans le répertoire de base :
mkdir $HOME/go
Définissez la variable d'environnement GOPATH en ajoutant les variables suivantes au fichier applicable : ~/.bash_profile, ~/.profile, ~/.bashrc ou ~/.zshrc.
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
Après avoir modifié le fichier, exécutez la commande suivante pour que vos modifications prennent effet immédiatement :
source ~/.bash_profile

Vous pouvez également appliquer la modification à l'échelle du système en ajoutant les variables précédentes au fichier /etc/bashrc.

Créez un répertoire go/ dans le répertoire de base : C:\Users\<username>\go.