Guía de Instalación WPILib

Esta guía está destinada a equipos que usan Java y C ++. Los equipos que usan LabVIEW pueden saltarse a: Instalación LabVIEW para FRC (únicamente LabVIEW). Además, el siguiente tutorial muestra Windows 10, pero los pasos son idénticos para todos los sistemas operativos. Se mostrarán notas que diferencian los sistemas operativos.

Prerrequisitos

Puede descargar la última versión lanzada del instalador de GitHub. Asegúrese de descargar el binario correcto para su sistema operativo y arquitectura.

Nota

Los usuarios de Windows 7 deben de tener un sistema actualizado con esta actualización instalada.

Importante

La versión mínima de macOS compatible es Mojave (10.14.x).

Extrayendo el Instalador

Cuando descarga el instalador de WPILib, este está distribuido como un archivo de imagen de disco .iso para Windows, .tar.gz para Linux, y distribuido como DMG para MacOS.

Los usuarios de Windows 10 pueden dar clic derecho en la imagen de disco de descarga y seleccionar Mount para abrirlo. Después abra WPILibInstaller.exe.

The menu after right clicking on an .iso file to choose "Mount".

Nota

Otros programas instalados pueden asociarse con archivos iso y es posible que la opción: mount no aparezca. Si ese software no ofrece la opción de montar o extraer el archivo iso, siga las instrucciones en la pestaña «Windows 7».

Corriendo el Instalador

Al abrir el instalador, se le presentará la siguiente pantalla. Presione Start.

Start of Installer

La siguiente pantalla implica la descarga de VS Code. Desafortunadamente, debido a razones de licencia, VS Code no se puede incluir con el instalador.

Overview of VS Code download options
  • Descargue VS Code para Instalación Única

    • Esto descarga VS Code solo para la plataforma actual, que es también la descarga más pequeña.

  • Salte instalación de VS Code

    • Omitir la instalación de VS Code. Útil para instalaciones o configuraciones avanzadas. Generalmente no es recomendado.

  • Usar Instalador Descargado Fuera de Linea

    • Al seleccionar esta opción, aparecerá un mensaje que le permitirá seleccionar un archivo zip preexistente de VS Code que ha sido descargado previamente por el instalador. Esta opción no le permite seleccionar una copia ya instalada de VS Code en su máquina.

  • Descargar VS Code para Instalación Fuera de Linea

    • Esta opción descarga y guarda una copia de VS Code para todas las plataformas, que es útil para compartir la copia del instalador.

Continúe y seleccione Download VS Code for Single Install. Esto comenzará el proceso de descarga y puede demorar un poco dependiendo de la conectividad a Internet (~60MB). Una vez realizada la descarga, seleccione Next. Debería aparecer una pantalla similar a la siguiente.

An overview of the installer options

Esto muestra una lista de opciones incluidas con la instalación de WPILib. Se recomienda dejar seleccionadas las opciones predeterminadas.

Notará dos botones, Install for this User y Install for all Users. Install for this User solo se instala en la cuenta de usuario actual, y no requiere privilegios de administrador. Sin embargo, Install for all Users instala las herramientas para todas las cuentas del sistema y requerirá acceso de administrador. Install for all Users no es una opción para macOS y Linux.

Seleccione la opción que sea adecuada para usted y se le presentará la siguiente pantalla de instalación.

Installer progress bar

Una vez completada la instalación, se le presentará la pantalla finalizada.

Installer finished screen.

Importante

WPILib instala una versión separada de VS Code que en una instalación ya existente. Cada año tiene su propia copia de las herramientas anexadas con el año. Ej: WPILib VS Code 2021. Por favor, ejecute el WPILib VS Code y no una copia instalada en el sistema.

¡Felicitaciones, el entorno de desarrollo y las herramientas de WPILib ya están instalados en su computadora! Presione Finalizar para salir del instalador.

Post-Instalación

Algunos sistemas operativos requieren acciones finales para completar la instalación.

Después de la instalación, el instalador abre la carpeta WPILib VS Code. Arrastre la aplicación VS Code al dock. Expulsar la imagen de WPILibInstaller del escritorio.

Nota

La instalación de las herramientas del escritorio y el reinicio creará una carpeta en el escritorio llamada YYYY WPILib Tools, donde YYYY es el año actual. Los accesos directos a herramientas de escritorio no están disponibles en Linux y MacOS.

¿Qué se instaló?

El instalador sin conexión instala los siguientes componentes:

  • Visual Studio Code - El IDE compatible para 2019 y el desarrollo de código de robot posterior. El instalador fuera de línea configura una copia separada de VS Code para el desarrollo de WPILib, incluso si ya tiene VS Code en su máquina. Esto se hace porque algunas de las configuraciones que hacen que la configuración de WPILib funcione pueden romper los flujos de trabajo existentes si usa VS Code para otros proyectos.

  • C++ Compiler - Las cadenas de herramientas para construir código de C++ para la roboRIO

  • Gradle - La versión específica de Gradle usada para construir/desplegar código de robot C++ o Java

  • Java JDK/JRE - Una versión específica de Java JDK/JRE que se utiliza para crear código de robot Java y para ejecutar cualquiera de las herramientas basadas en Java (Dashboards, etc.). Esto existe al lado de cualquier instalación de JDK existente y no sobrescribe la variable JAVA_HOME

  • WPILib Tools - SmartDashboard, Shuffleboard, RobotBuilder, Outline Viewer, Pathweaver, Glass

  • WPILib Dependencies - OpenCV, etc.

  • VS Code Extensions - Las extensiones de WPILib para desarrollo de código de robot en VS Code

Desinstalando

WPILib está diseñado para poderse instalar en diferentes carpetas durante diferentes años, así que no es necesario desinstalar una versión previa antes de instalar WPILib de este año. No obstante, las siguientes instrucciones pueden usarse para desinstalar WPILib si es que se desea.

  1. Elimine la carpeta correcta de wpilib (2019: c:\Users\Public\frc2019, 2020 y después: c:\Users\Public\wpilib\YYYY donde YYYY es el año en que se desinstala)

  2. Elimine los iconos del escritorio en C:\Users\Public\Public Desktop

  3. Elimine las variables de entorno de ruta de acceso.

    1. En el menú de inicio, escriba entorno y seleccione «Editar las variables de entorno del sistema»

    2. Haga clic en el botón de variables de entorno (1).

    3. En las variables de usuario, seleccione la ruta (2) y luego haga clic en editar (3).

    4. Seleccione la ruta con de roborio\bin (4) y haga clic en eliminar (5).

    5. Seleccione la ruta con frccode y haga clic en eliminar (5).

    6. Repita los pasos de 3-6 veces en el panel variable de sistemas.

The "System Properties", "Environment Variables", and "Edit Environment Variables" screens.

Solución de problemas

En caso de que el instalador falle, abra un problema en el repositorio del instalador. Un enlace está disponible aquí <https://github.com/wpilibsuite/wpilibinstaller-avalonia> __. El instalador debe dar un mensaje sobre la causa del error, por favor inclúyalo en la descripción de su problema.