💻Martes - Preparación de entorno de trabajo e Introducción a Azle

Este día aprenderás:

  • Preparación de ambiente en Mac, Windows y Ubuntu

  • Uso del CLI de ICP (DFX)

  • Empezar un proyecto con el CLI de Azle

  • Hacer consultas a un API Rest con Postman

Monta tu ambiente de desarrollo

Ten un ambiente local con el cual correr y desplegar tus canister replicando la blockchain de Internet Computer en tu ordenador

Instalación en Windows

  • Activar Subsistema de Windows para Linux

  • Si es necesario activar la virtualización en la BIOS

  • Abrir PowerShell y correr los siguientes comandos

wsl --install
wsl --install -d Ubuntu
wsl --update
Ubuntu

Este último comando te colocará en la terminal de Ubuntu, para continuar lee el manual de Instalación en Ubuntu

Instalación en Ubuntu

# Actualización de lista de paquetes
sudo apt update
# Instalación de wget
sudo apt install wget
# Instalación de NVM
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# Ejecutar scripts en .bashrc para no tener que reiniciar la terminal
source ~/.bashrc
# Instalación de Podman
sudo apt -y install podman

Una ves ejecutado estos comandos puedes probar que todo funciona correctamente corriendo los siguientes comandos:

nvm --version
podman --version

Ahora puedes continuar siguientos las instrucciones de Instalación en MacOS/Ubuntu

Instalación en MacOS

# Instalación de Rosetta (Sólo necesario en procesadores Apple Silicon)
softwareupdate --install-rosetta
# Instalación del XCode Command Line Tools
xcode-select --install
# Instalación de Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
# Registrar Homebrew para tener disponible el comando brew
"export PATH=/opt/homebrew/bin:$PATH" >> ~/.bashrc
# Ejecutar scripts en .bashrc para no tener que reiniciar la terminal
source ~/.bashrc
# Instalación de NVM
brew install nvm
# Instalación de Podman
brew install podman
# Inicializar Podman
podman machine init --disk-size 20

Puedes probar la correcta instalación corriendo los siguientes comandos

nvm --version
podman --version

Ahora puedes continuar con las indicaciones de Instalación en MacOS/Ubuntu

Instalación en MacOS / Ubuntu

Ahora que ya realizaste la instalación previa de MacOS o Ubuntu, puedes continuar instalando los paquetes faltantes (NodeJS y DFX)

# Instalación NodeJS versión 20.x.x
nvm install 20
# Cambiar a la versión de NodeJS recién instalada
nvm use 20
# Instalación DFX
sh -ci "$(curl -fsSL https://internetcomputer.org/install.sh)"

Para verificar la correcta instalación puedes correr los siguientes comandos

node --version
dfx --version

También puedes ver un tutorial de instalación directo de la documentación oficial de Azle

DFX la CLI de Dfinity

Dfx es una herramienta de linea de comandos (CLI) que utilizaras para desplegar e interactura con la blockchain de Internet Computer deberás instalarla de acuerdo a la información en el Azle book en la sección de arriba. La versión de dfx que necesitarás es la 0.15

Qué es Azle?

Azle es un kit de desarrollo de Canisters (CDK) de TypeScript para Internet Computer (IC). Proporciona un conjunto de bibliotecas y herramientas que facilitan la construcción e implementación de canisters en IC. Azle permite a los desarrolladores web llevar sus habilidades de TypeScript/JavaScript y construir aplicaciones descentralizadas.

Es importante señalar que Azle se encuentra actualmente en una etapa de desarrollo beta. Esto significa que, si bien ofrece un marco sólido y valioso para el desarrollo, está en continua evolución y puede sufrir cambios significativos.

¿Porqué utilizar Azle?

Dentro del ecosistema de Internet Computer Protocol encontramos varias opciones para el desarrollo de Canisters llamadas CDK's (Canister Development Kit). Estos permiten exponer la interfaz pública de un Canister, administrar la memoria, llamar a otros Canister e interactuar con la API del sistema.

Azle nos permitirá construir canister utilizando el lenguaje de programación JavaScript dando acceso a todas las API de Internet Computer y con ellas construir cosas increibles.

A demás dentro de sus características más recientes y más destacables, es que es el único lenguaje en ICP que actualmente soporte desarrollar API Rest como se hace en Web2.

Primeros pasos

Actividades

  1. Configurar ambiente en equipo personal

  2. Crear una nueva developer identity y publicar en el canal de #azle-bootcamp la evidencia (screenshot)

  3. Inicializar un proyecto con el CLI de Azle

Recursos

Last updated