Desarrollando Electron

Estas guías están pensadas para gente que trabaja en el proyecto Electron. For guides on Electron app development, see /docs/README.md.

Índice

• Problemas
• Pull Requests
• Documentación guía de estilos
• Estructura del directorio de código fuente
• Estilo de código
• Usar Clang-Tidy en el código de C++
• Instrucciones de Compilación
  • macOS
  • Windows
  • Linux
• Desarrollo de Chromium
• Desarrollo de V8
• Pruebas
• Depuración
• Parches

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.

If you would prefer to build Electron manually, see the build instructions.

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. The source code directory structure gives a good overview of the purpose of each directory.

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
   • Si crees que has encontrado un nuevo error en Electron, deberías reportarlo creando una nueva incidencia en el rastreador de incidencias de electron/electron.
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.

See issues for more information.

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/.

See pull requests for more information.

If you want to add a new API module to Electron, you'll want to look in creating 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. The process for adding or altering one of these patches to Electron's source tree via a pull request can be found in patches.

Depuración

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

For an overview of information related to debugging Electron itself (and not an app built with Electron), see debugging.