Saltar al contenido principal

Desarrollando Electron

Estas guías están pensadas para gente que trabaja en el proyecto Electron. Para guías sobre el desarrollo de aplicaciones Electron, visita /docs/README.md.

Índice​

Empezar​

Para contribuir a Electron, lo primero que querrás hacer es obtener el código.

build-tools de Electron automatiza gran parte de la configuración para compilar Electron desde la fuente con diferentes configuraciones y objetivos de construcción.

Si prefiere construir Electron manualmente, vea las instrucciones de compilación.

Una vez que hayas comprobado y construido el código, tal vez quieras echar un vistazo alrededor del árbol de origen para obtener una mejor idea de qué es responsable cada directorio. La estructura del directorio del código de la fuente da un buen resumen del propósito de cada directorio.

Apertura de incidencias en Electron​

Para cualquier problema, hay tres maneras fundamentales en la que cualquier individuo puede contribuir:

  1. Registrando el problema para la discusión
  2. Ayudando a probar el problema
    • Puede hacerlo proporcionando detalles de asistencia (un caso de prueba reproducible que demuestre un error) o proporcionando sugerencias para abordar el problema.
  3. Ayudando a resolver el problema
    • Esto se puede hacer demostrando que el problema no es un error o está arreglado; pero más a menudo, abriendo un pull request que cambia la fuente en electron/electron de una manera concreta y revisable.

Vea problemas para más información.

Haciendo un Pull Request a Electron​

La mayoría de las pull requests abiertas contra el repositorio electron/electron incluyen cambios en el código C/C++ en la carpeta shell/, el código de TypeScript en la carpeta lib/, la documentación en docs/, o las pruebas en la carpeta spec/.

Vea pull requests para más información.

Si desea añadir un nuevo módulo API a Electron, querrá buscar en crear API.

Gobernanza​

Electron tiene un sistema de gobernanza completamente desarrollado que supervisa la actividad en Electron y cuyos grupos de trabajo son responsables de áreas como los API, versiones, y actualizaciones a las dependencias de Electron, incluyendo Chromium y Node.js. Dependiendo de la frecuencia y hasta qué punto desea contribuir, puede considerar unirse a un grupo de trabajo.

Los detalles sobre cada grupo y sus responsabilidades se pueden encontrar en el repositorio de gobernanza.

Parches en Electron​

Electron está construido sobre dos grandes proyectos principales: Chromium y Node.js. Cada uno de estos proyectos tienen también varias de sus propias dependencias. Hacemos todo lo posible para utilizar estas dependencias exactamente como están, pero a veces no podemos lograr nuestros objetivos sin parchear esas dependencias en upstream para que se ajusten a nuestros casos de uso.

Como tal, mantenemos una colección de parches como parte de nuestro árbol de fuentes. El proceso para añadir o alterar uno de estos parches al árbol fuente de Electron a través de una pull request se puede encontrar en parches.

Depuración​

Hay muchos enfoques diferentes para depurar problemas y errores en Electron, muchos de los cuales son específicos de la plataforma.

Para una visión general de la información relacionada con la depuración de Electron en sí mismo (y no una aplicación construida con Electron), vea depuración.