mirror of
https://github.com/beekeeper-studio/beekeeper-studio.git
synced 2026-03-13 10:12:54 +08:00
docs: update ES and PT-BR README translations to match main README
- Add language switcher links at the top of both files - Update structure to match current main README - Update NodeJS version requirement from 12/14 to 20 - Add missing sections: UX approach, OpenSSL troubleshooting, Electron upgrade notes - Update database support tables with all current databases - Remove outdated content (auto-update warning, Slack links) - Add new features: import/export, backup/restore, view as JSON Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
268
README-es.md
268
README-es.md
@@ -1,189 +1,237 @@
|
||||
# Beekeeper Studio (Community Edition)
|
||||
🌐 [EN](README.md) | [PT-BR](README.pt-br.md)
|
||||
|
||||
Beekeeper Studio es un editor de SQL multi-plataforma y un cliente de gestión de bases de datos, disponible para Linux, Mac y Windows. La edición Community de Beekeeper Studio está bajo licencia GPL (Licencia Pública General), por lo tanto es libre (free) y gratis (free).
|
||||
# Beekeeper Studio
|
||||
|
||||
👉 [Descarga Beekeeper Studio](https://beekeeperstudio.io/get)
|
||||
Beekeeper Studio es un editor de SQL multiplataforma y gestor de bases de datos disponible para Linux, Mac y Windows.
|
||||
|
||||
👉 [Únete a la comunidad de Slack](https://launchpass.com/beekeeperstud-lvg5276)
|
||||
[Descarga Beekeeper Studio](https://beekeeperstudio.io/get-community)
|
||||
|
||||
👉 Te ha gustado Beekeeper Studio? [Déjanos un testimonio!](https://testimonial.to/beekeeper-studio)
|
||||
Publicamos binarios para MacOS, Windows y Linux.
|
||||
|
||||

|
||||
|
||||
## Las ediciones de Beekeeper Studio
|
||||
|
||||
1. **Beekeeper Studio edición Community** - El repositorio en el que estás. Esta es la versión de código abierto de Beekeeper Studio. Es un cliente de gestión de bases de datos completo, totalmente gratis y de código abierto (software libre).
|
||||
|
||||
2. **Beekeeper Studio edición Ultimate** - La versión comercial de Beekeeper Studio, con características adicionales y una licencia comercial apta para empresas. Adquirir la edición Ultimate de Beekeeper Studio es la mejor forma de apoyar a Beekeeper Studio.
|
||||
|
||||
👉 [Compara ediciones de Beekeeper Studio](https://beekeeperstudio.io/get)
|
||||
[](https://beekeeperstudio.io/get)
|
||||
|
||||
|
||||
## Características de Beekeeper Studio
|
||||
Beekeeper Studio es gratis para descargar y ofrece muchas funciones de forma gratuita, sin necesidad de registro, inscripción ni tarjeta de crédito. La aplicación ofrece algunas funciones premium por un precio de licencia razonable. [Más información aquí](https://beekeeperstudio.io/pricing)
|
||||
|
||||
Lo mejor de todo: Es fluido 🌊 y rápido 🏎 , y te lo pasarás bien usándolo 🥰
|
||||
|
||||
- Multi-plataforma, de verdad: Windows, MacOS y Linux
|
||||
- Editor de consultas de SQL con función de autocompletado y resaltado de sintaxis.
|
||||
- Interfaz con pestañas para poder trabajar en más de una cosa a la vez
|
||||
- Filtra y organiza los datos de las tablas para encontrar exactamente lo que quieres
|
||||
- Atajos de teclado sensatos y fáciles de entender
|
||||
- Guarda consultas para reabrirlas más tarde
|
||||
- Historial de consultas, para que puedas localizar esa consulta que finalmente funcionó hace tres días
|
||||
- Modo oscuro por defecto
|
||||
La mayor parte del código en este repositorio es de código abierto bajo la licencia GPLv3. Las funciones de pago también están en este repositorio bajo una licencia comercial con código fuente disponible.
|
||||
|
||||
Una de nuestras frustraciones con otros editores de SQL y software de gestión de bases de datos de código libre era que añadían muchísimas características y herramientas, hasta que la interfaz de usuario terminaba abarrotada e imposible de usar. Así que buscamos software de código libre para SQL que fuera bonito y potente, y a la vez fácil de usar. Como no lo encontramos, decidimos crear Beekeeper Studio!
|
||||
¡Las contribuciones de la comunidad son bienvenidas!
|
||||
|
||||
Beekeeper Studio se puede conectar con las siguientes bases de datos:
|
||||
|
||||
## Bases de datos compatibles
|
||||
|
||||
<!-- Don't edit this, it gets built automatically from docs/includes/supported_databases.md -->
|
||||
<!-- SUPPORT_BEGIN -->
|
||||
|
||||
| Database | Support | Community | Paid Editions | Beekeeper Links |
|
||||
| Base de datos | Soporte | Community | Ediciones de Pago | Enlaces de Beekeeper |
|
||||
| :------------------------------------------------------- | :--------------------------- | :-------: | :------: | -----------------------------------------: |
|
||||
| [PostgreSQL](https://postgresql.org) | ⭐ Full Support | ✅ | ✅ | [Features](https://beekeeperstudio.io/db/postgres-client) |
|
||||
| [MySQL](https://www.mysql.com/) | ⭐ Full Support | ✅ | ✅ | [Features](https://beekeeperstudio.io/db/mysql-client)|
|
||||
| [SQLite](https://sqlite.org) | ⭐ Full Support | ✅ | ✅ | [Features](https://beekeeperstudio.io/db/sqlite-client), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/sqlite) |
|
||||
| [SQL Server](https://www.microsoft.com/en-us/sql-server) | ⭐ Full Support | ✅ | ✅ | [Features](https://beekeeperstudio.io/db/sql-server-client) |
|
||||
| [Amazon Redshift](https://aws.amazon.com/redshift/) | ⭐ Full Support | ✅ | ✅ | [Features](https://beekeeperstudio.io/db/redshift-client) |
|
||||
| [CockroachDB](https://www.cockroachlabs.com/) | ⭐ Full Support | ✅ | ✅ | [Features](https://beekeeperstudio.io/db/cockroachdb-client)|
|
||||
| [MariaDB](https://mariadb.org/) | ⭐ Full Support | ✅ | ✅ | [Features](https://beekeeperstudio.io/db/mariadb-client) |
|
||||
| [TiDB](https://pingcap.com/products/tidb/) | ⭐ Full Support | ✅ | ✅ | [Features](https://beekeeperstudio.io/db/tidb-client) |
|
||||
| [Google BigQuery](https://cloud.google.com/bigquery) | ⭐ Full Support | ✅ | ✅ | [Features](https://beekeeperstudio.io/db/google-big-query-client), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/bigquery) |
|
||||
| [Redis](https://redis.io/) | ⭐ Full Support | ✅ | ✅ | [Features](https://www.beekeeperstudio.io/db/redis-client/) |
|
||||
| [Oracle Database](https://www.oracle.com/database/) | ⭐ Full Support | | ✅ | [Features](https://beekeeperstudio.io/db/oracle-client), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/oracle) |
|
||||
| [Cassandra](http://cassandra.apache.org/) | ⭐ Full Support | | ✅ | [Features](https://beekeeperstudio.io/db/cassandra-client) |
|
||||
| [Firebird](https://firebirdsql.org/) | ⭐ Full Support | | ✅ | [Features](https://beekeeperstudio.io/db/firebird-client), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/firebird) |
|
||||
| [LibSQL](https://libsql.org/) | ⭐ Full Support | | ✅ | [Features](https://beekeeperstudio.io/db/libsql-client) |
|
||||
| [ClickHouse](https://clickhouse.tech/) | ⭐ Full Support | | ✅ | [Features](https://www.beekeeperstudio.io/db/clickhouse-client/), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/clickhouse) |
|
||||
| [DuckDB](https://duckdb.org/) | ⭐ Full Support | | ✅ | [Features](https://www.beekeeperstudio.io/db/duckdb-client/), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/duckdb) |
|
||||
| [SQL Anywhere](https://www.sap.com/products/technology-platform/sql-anywhere.html) | ⭐ Full Support | | ✅ | [Features](https://www.beekeeperstudio.io/db/sql-anywhere-client/) |
|
||||
| [MongoDB](https://www.mongodb.com/) | ⭐ Full Support | | ✅ | [Features](https://www.beekeeperstudio.io/db/mongodb-client/), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/mongodb) |
|
||||
| [Trino](https://trino.io/) / [Presto](https://prestodb.io/) | ⭐ Full Support | | ✅ | [Features](https://www.beekeeperstudio.io/db/trino-client/), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/trino/) |
|
||||
| [Snowflake](https://www.snowflake.com/) | ⏳ Coming Soon | | ✅ | -- |
|
||||
| [DynamoDB](https://aws.amazon.com/dynamodb/) | 🗓️ Planned | | ✅ | -- |
|
||||
| [PostgreSQL](https://postgresql.org) | ⭐ Soporte completo | ✅ | ✅ | [Características](https://beekeeperstudio.io/db/postgres-client) |
|
||||
| [MySQL](https://www.mysql.com/) | ⭐ Soporte completo | ✅ | ✅ | [Características](https://beekeeperstudio.io/db/mysql-client)|
|
||||
| [SQLite](https://sqlite.org) | ⭐ Soporte completo | ✅ | ✅ | [Características](https://beekeeperstudio.io/db/sqlite-client), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/sqlite) |
|
||||
| [SQL Server](https://www.microsoft.com/en-us/sql-server) | ⭐ Soporte completo | ✅ | ✅ | [Características](https://beekeeperstudio.io/db/sql-server-client) |
|
||||
| [Amazon Redshift](https://aws.amazon.com/redshift/) | ⭐ Soporte completo | ✅ | ✅ | [Características](https://beekeeperstudio.io/db/redshift-client) |
|
||||
| [CockroachDB](https://www.cockroachlabs.com/) | ⭐ Soporte completo | ✅ | ✅ | [Características](https://beekeeperstudio.io/db/cockroachdb-client)|
|
||||
| [MariaDB](https://mariadb.org/) | ⭐ Soporte completo | ✅ | ✅ | [Características](https://beekeeperstudio.io/db/mariadb-client) |
|
||||
| [TiDB](https://pingcap.com/products/tidb/) | ⭐ Soporte completo | ✅ | ✅ | [Características](https://beekeeperstudio.io/db/tidb-client) |
|
||||
| [Google BigQuery](https://cloud.google.com/bigquery) | ⭐ Soporte completo | ✅ | ✅ | [Características](https://beekeeperstudio.io/db/google-big-query-client), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/bigquery) |
|
||||
| [Redis](https://redis.io/) | ⭐ Soporte completo | ✅ | ✅ | [Características](https://www.beekeeperstudio.io/db/redis-client/) |
|
||||
| [Oracle Database](https://www.oracle.com/database/) | ⭐ Soporte completo | | ✅ | [Características](https://beekeeperstudio.io/db/oracle-client), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/oracle) |
|
||||
| [Cassandra](http://cassandra.apache.org/) | ⭐ Soporte completo | | ✅ | [Características](https://beekeeperstudio.io/db/cassandra-client) |
|
||||
| [Firebird](https://firebirdsql.org/) | ⭐ Soporte completo | | ✅ | [Características](https://beekeeperstudio.io/db/firebird-client), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/firebird) |
|
||||
| [LibSQL](https://libsql.org/) | ⭐ Soporte completo | | ✅ | [Características](https://beekeeperstudio.io/db/libsql-client) |
|
||||
| [ClickHouse](https://clickhouse.tech/) | ⭐ Soporte completo | | ✅ | [Características](https://www.beekeeperstudio.io/db/clickhouse-client/), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/clickhouse) |
|
||||
| [DuckDB](https://duckdb.org/) | ⭐ Soporte completo | | ✅ | [Características](https://www.beekeeperstudio.io/db/duckdb-client/), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/duckdb) |
|
||||
| [SQL Anywhere](https://www.sap.com/products/technology-platform/sql-anywhere.html) | ⭐ Soporte completo | | ✅ | [Características](https://www.beekeeperstudio.io/db/sql-anywhere-client/) |
|
||||
| [MongoDB](https://www.mongodb.com/) | ⭐ Soporte completo | | ✅ | [Características](https://www.beekeeperstudio.io/db/mongodb-client/), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/mongodb) |
|
||||
| [Trino](https://trino.io/) / [Presto](https://prestodb.io/) | ⭐ Soporte completo | | ✅ | [Características](https://www.beekeeperstudio.io/db/trino-client/), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/trino/) |
|
||||
| [Snowflake](https://www.snowflake.com/) | ⏳ Próximamente | | ✅ | -- |
|
||||
| [DynamoDB](https://aws.amazon.com/dynamodb/) | 🗓️ Planificado | | ✅ | -- |
|
||||
|
||||
|
||||
|
||||
|
||||
<!-- SUPPORT_END -->
|
||||
|
||||
## Ediciones de Beekeeper Studio
|
||||
|
||||
## Apoya a Beekeeper Studio
|
||||
Beekeeper Studio es una única descarga con actualizaciones dentro de la aplicación para funciones premium.
|
||||
|
||||
Adoro trabajar en Beekeeper Studio, y me encantaría poder seguir ampliándolo y mejorándolo para siempre. Para hacer eso, necesito tu ayuda.
|
||||
Nos encantaría hacer Beekeeper Studio totalmente gratis para todos, pero crear buen software es un trabajo difícil y costoso. Creemos que nuestras ediciones de pago tienen un precio justo, esperamos que tú también lo pienses.
|
||||
|
||||
La mejor forma de apoyar a Beekeeper Studio es comprando la [edición Ultimate](https://beekeeperstudio.io/get). Cada compra apoya mi trabajo en Beekeeper Studio de forma directa.
|
||||
👉 [Compara las ediciones de Beekeeper Studio](https://beekeeperstudio.io/pricing)
|
||||
|
||||
Si no puedes permitirte la licencia, por favor considera [convertirte en patrocinador del proyecto](https://github.com/sponsors/beekeeper-studio).
|
||||
## Características de Beekeeper Studio
|
||||
|
||||
Gracias por tu apoyo constante!
|
||||
Lo mejor: Es fluido 🍫, rápido 🏎, y realmente disfrutarás usándolo 🥰
|
||||
|
||||
- Verdaderamente multiplataforma: Windows, MacOS y Linux
|
||||
- Editor de consultas SQL con autocompletado y resaltado de sintaxis
|
||||
- Interfaz con pestañas para que puedas hacer varias tareas a la vez
|
||||
- Ordena y filtra los datos de las tablas para encontrar exactamente lo que necesitas
|
||||
- Atajos de teclado sensatos
|
||||
- Guarda consultas para más tarde
|
||||
- Historial de ejecución de consultas, para que puedas encontrar esa consulta que funcionó hace 3 días
|
||||
- Excelente tema oscuro
|
||||
- Importar/exportar
|
||||
- Copia de seguridad/restauración
|
||||
- Ver datos como JSON
|
||||
- Y mucho más
|
||||
|
||||
## Nuestro enfoque de UX
|
||||
|
||||
Una de nuestras frustraciones con otros editores de SQL y gestores de bases de datos de código abierto es que adoptan un enfoque de "echar todo" con las funciones, añadiendo tantas que la interfaz se vuelve desordenada y difícil de navegar. Queríamos un entorno SQL de código abierto con buen aspecto, potente pero también fácil de usar. No pudimos encontrar uno, ¡así que creamos Beekeeper Studio!
|
||||
|
||||
Generalmente nuestra estrella guía es construir software que "se sienta bien" al usarlo. Eso significa que como mínimo valoramos que Beekeeper sea rápido, directo de usar y moderno. Si una nueva función compromete esta visión, la eliminamos.
|
||||
|
||||
|
||||
## Apoyar a Beekeeper Studio
|
||||
|
||||
Nos encanta trabajar en Beekeeper Studio, y nos encantaría seguir haciéndolo crecer y mejorándolo para siempre. Para eso necesitamos tu ayuda.
|
||||
|
||||
La mejor manera de apoyar a Beekeeper Studio es comprar una [licencia](https://beekeeperstudio.io/pricing) de pago. Cada compra apoya directamente nuestro trabajo en Beekeeper Studio.
|
||||
|
||||
Si estás en una empresa y usas Beekeeper Studio para tu trabajo, probablemente deberías pedirle a tu jefe que te [compre una licencia](https://beekeeperstudio.io/pricing).
|
||||
|
||||
Si no puedes permitirte una licencia, por favor usa la versión gratuita, ¡para eso hacemos una versión gratuita!
|
||||
|
||||
¡Gracias por tu apoyo continuo!
|
||||
|
||||
|
||||
## Documentación
|
||||
|
||||
Visita [docs.beekeeperstudio.io](https://docs.beekeeperstudio.io) para consultar guías del usuario, preguntas frecuentes, soluciones a posibles problemas y mucho más.
|
||||
Visita [docs.beekeeperstudio.io](https://docs.beekeeperstudio.io) para guías de usuario, preguntas frecuentes, consejos de resolución de problemas y más.
|
||||
|
||||
## Licencia
|
||||
|
||||
La edición Community de Beekeeper (el código de este repositorio) está bajo la licencia GPLv3.
|
||||
Beekeeper Studio Community Edition (el código en este repositorio) está licenciado bajo la licencia GPLv3.
|
||||
|
||||
La edición Ultimate de Beekeeper Studio contiene características adicionales y está bajo la licencia [EULA (acuerdo de licencia de usuario final)](https://beekeeperstudio.io/legal/commercial-eula/).
|
||||
Beekeeper Studio Ultimate Edition contiene funciones adicionales y está licenciado bajo un [acuerdo de licencia de usuario final comercial (EULA)](https://beekeeperstudio.io/legal/commercial-eula/).
|
||||
|
||||
Las marcas registradas de Beekeeper Studio (logos, palabras y marcas) no son de código abierto. Visita el [reglamento de nuestra marca registrada](https://beekeeperstudio.io/legal/trademark/) para más información.
|
||||
Las marcas registradas de Beekeeper Studio (marcas de palabras y logotipos) no son de código abierto. Consulta nuestras [directrices de marcas](https://beekeeperstudio.io/legal/trademark/) para más información.
|
||||
|
||||
## Reglamento de marca registrada
|
||||
## Directrices de Marcas
|
||||
|
||||
Las marcas registradas pueden complicarse en los proyectos de código abierto, así que adaptamos un conjunto de pautas básicas para el uso de nuestras marcas registradas, pautas que son comunes en muchos proyectos de código abierto.
|
||||
Las marcas registradas pueden ser complicadas con proyectos de código abierto, por lo que hemos adoptado un conjunto de directrices estándar para el uso de nuestras marcas que son comunes en muchos proyectos de código abierto.
|
||||
|
||||
Si solamente estás usado la app de Beekeeper Studio sin intención de bifurcar o distribuir el código, estas pautas probablemente no se aplican en tu caso.
|
||||
Si solo estás usando la aplicación Beekeeper Studio, y no estás bifurcando o distribuyendo código de Beekeeper Studio de ninguna manera, estas probablemente no se aplican a ti.
|
||||
|
||||
👉 [Pautas de marca registrada de Beekeeper Studio](https://beekeeperstudio.io/legal/trademark/)
|
||||
👉 [Directrices de Marcas de Beekeeper Studio](https://beekeeperstudio.io/legal/trademark/)
|
||||
|
||||
## Contribuir a Beekeeper Studio
|
||||
|
||||
Nos encanta *cualquier* participación de la comunidad. ¡Incluso si te estás quejando porque no te gusta algo de la aplicación!
|
||||
|
||||
|
||||
## Colabora con Beekeeper Studio
|
||||
### Acuerdos del Colaborador
|
||||
|
||||
Nos encanta la colaboración comunitaria de *cualquier tipo*. Incluso si te estás quejando de que no te gusta algún aspecto de la aplicación!
|
||||
- Construir una comunidad inclusiva y acogedora es importante para nosotros, así que por favor sigue nuestro [código de conducta](code_of_conduct.md) mientras participas en el proyecto.
|
||||
|
||||
### Acuerdos del colaborador
|
||||
- Al contribuir al proyecto aceptas los términos de nuestras [directrices de contribución](CONTRIBUTING.md).
|
||||
|
||||
- Para nosotros es muy importante construir una comunidad inclusiva y acogedora, así que por favor, sigue nuestro [código de conducta](code_of_conduct.md) cuando participes en el proyecto.
|
||||
### Contribuir sin programar
|
||||
|
||||
- Al contribuir al proyecto, aceptas los términos y condiciones de nuestras [normas del colaborador](CONTRIBUTING.md).
|
||||
Te tenemos cubierto, lee nuestra [guía para contribuir en 10 minutos sin programar](https://github.com/beekeeper-studio/beekeeper-studio/issues/287).
|
||||
|
||||
### Colabora sin programar
|
||||
### Compilar y Ejecutar Beekeeper Studio Localmente
|
||||
|
||||
No pasa nada si no sabes programar, lo tenemos todo controlado! Lee nuestra [guía para contribuir en diez minutos sin programar nada](https://github.com/beekeeper-studio/beekeeper-studio/issues/287).
|
||||
|
||||
### Compila y ejecuta Beekeper Studio en tu sistema local
|
||||
|
||||
Quieres escribir un poco de código y mejorar Beekeeper Studio? Configurar tu equipo es muy fácil ya sea Mac, Linux o Windows.
|
||||
¿Quieres escribir algo de código y mejorar Beekeeper Studio? Configurar es fácil en Mac, Linux o Windows.
|
||||
|
||||
```bash
|
||||
# Primero de todo: Instala NodeJS 12 or 14, NPM, and Yarn
|
||||
# Primero: Instala NodeJS 20, NPM y Yarn
|
||||
# ...
|
||||
|
||||
# 1. Bifurca el repositorio de Beekeeper Studio (haz clic en el icono de la bifurcación en la parte superior derecha de esta misma pantalla)
|
||||
# 2. Verifica tu bifurcación:
|
||||
# 1. Haz un fork del repositorio de Beekeeper Studio (haz clic en el botón fork en la parte superior derecha de esta pantalla)
|
||||
# 2. Clona tu fork:
|
||||
git clone git@github.com:<tu-usuario>/beekeeper-studio.git beekeeper-studio
|
||||
cd beekeeper-studio/
|
||||
yarn install # instala las dependencias
|
||||
|
||||
# Ahora ya puedes abrir la aplicación:
|
||||
yarn run electron:serve ## abrirá la aplicación
|
||||
|
||||
# Ahora puedes iniciar la aplicación:
|
||||
yarn run electron:serve ## la aplicación se iniciará
|
||||
```
|
||||
|
||||
### Dónde hacer los cambios?
|
||||
**Si obtienes `error:03000086:digital envelope routines::initialization error`, necesitarás actualizar openssl.**
|
||||
|
||||
Este repositorio es un monorepositorio: hay varias partes del repositorio que contienen código, pero solamente hay un par de puntos de partida importantes.
|
||||
- En Ubuntu/Debian:
|
||||
```
|
||||
sudo apt-get update
|
||||
sudo apt-get upgrade openssl
|
||||
```
|
||||
|
||||
Todo el código de la aplicación se encuentra en `apps/studio`, y también hay un poco de código compartido (compartido con otras aplicaciones) en `shared/src`.
|
||||
- En CentOS/RHEL:
|
||||
```
|
||||
sudo yum update openssl
|
||||
```
|
||||
|
||||
Los dos puntos de partida importantes de Beekeeper Studio son:
|
||||
- `background.js` - este es el código "electron-side" que controla aspectos nativos como por ejemplo las ventanas de la aplicación.
|
||||
- `main.js` - este es el punto de partida de la aplicación de Vue.js. Para encontrar la pantalla que necesites, sigue el historial de vínculos (breadcrumbs) de los componentes de Vue desde `App.vue`.
|
||||
- En macOS (usando Homebrew):
|
||||
```
|
||||
brew update
|
||||
brew upgrade openssl
|
||||
```
|
||||
|
||||
**Generalmente hay dos 'pantallas':**
|
||||
- ConnectionInterface - conectarse a una base de datos
|
||||
### ¿Dónde hacer cambios?
|
||||
|
||||
Este repositorio es ahora un monorepo, tenemos varios lugares con código, pero solo un par de puntos de entrada importantes.
|
||||
|
||||
Todo el código de la aplicación está en `apps/studio`, algo de código compartido está en `shared/src`. Esto se comparte con otras aplicaciones.
|
||||
|
||||
Beekeeper Studio tiene dos puntos de entrada:
|
||||
- `background.js` - este es el código del lado de Electron que controla cosas nativas como mostrar ventanas.
|
||||
- `main.js` - este es el punto de entrada para la aplicación Vue.js. Puedes seguir las migas de pan de los componentes Vue desde `App.vue` para encontrar la pantalla que necesitas.
|
||||
|
||||
**Generalmente tenemos dos 'pantallas':**
|
||||
- ConnectionInterface - conectarse a una BD
|
||||
- CoreInterface - interactuar con una base de datos
|
||||
|
||||
### Cómo enviar cambios
|
||||
### ¿Cómo enviar un cambio?
|
||||
|
||||
|
||||
- Carga tus cambios a tu repositorio y abre una solicitud de incorporación de cambios (pull request) desde nuestra página de GitHub (esta misma página)
|
||||
- Sube tus cambios a tu repositorio y abre un Pull Request desde nuestra página de GitHub (esta página)
|
||||
- ¡Asegúrate de escribir algunas notas sobre lo que hace tu cambio! Un gif siempre es bienvenido para cambios visuales.
|
||||
|
||||
- Asegúrate de anotar qué estás cambiando! Si has hecho cambios visuales, un gif nunca está de más.
|
||||
## Notas para mantenedores (los lectores casuales pueden ignorar esto)
|
||||
|
||||
## Notas para los mantenedores (los lectores ocasionales pueden ignorar esta parte)
|
||||
### Consideraciones al Actualizar Electron
|
||||
|
||||
Esto siempre es un dolor total y romperá la compilación 9 de cada 10 veces.
|
||||
|
||||
Algunas cosas que debes considerar al actualizar Electron:
|
||||
|
||||
1. ¿Usa una versión diferente de node? Por ejemplo, Electron-18 usa node 14, 22 usa node 16. Así que todos necesitan actualizar
|
||||
2. ¿Necesita actualizarse node-abi para poder entender la versión de Electron? Esto se usa en la compilación para obtener paquetes precompilados. Necesitas actualizar esto en root/package.json#resolutions
|
||||
3. ¿Se deprecaron o eliminaron algunas APIs? Asegúrate de que todas las funciones que interactúan con las APIs de Electron aún funcionen, cosas como - seleccionar un archivo, maximizar una ventana, ejecutar una consulta, etc.
|
||||
|
||||
|
||||
### Proceso de lanzamiento de versiones
|
||||
### Proceso de Lanzamiento
|
||||
|
||||
1. Cambia el número de la versión en package.json
|
||||
2. Sustituye `build/release-notes.md` por las notas de la última versión. Sigue el formato preestablecido.
|
||||
- ejecuta `git log <last-tag>..HEAD --oneline | grep 'Merge pull'` para encontrar solicitudes de incorporación de cambios combinadas
|
||||
2. Confirma
|
||||
3. Carga a la rama principal (master)
|
||||
4. Crea una etiqueta `git tag v<versión>`. Tiene que empezar con 'v'
|
||||
5. `git push origin <nombre-de-la-etiqueta>`
|
||||
- Ahora espera a que se complete la acción de construir/publicar en GitHub
|
||||
6. Carga la nueva versión
|
||||
- Ve a la nueva versión 'borrador' en la pestaña de lanzamientos de GitHub, edita las notas y publícala.
|
||||
- Entra a snapcraft.io, y arrastra la versión publicada al canal 'stable' para cada arquitectura.
|
||||
1. Aumenta el número de versión en package.json
|
||||
2. Reemplaza `build/release-notes.md` con las últimas notas de lanzamiento. Sigue el formato que está ahí.
|
||||
- ejecuta `git log <last-tag>..HEAD --oneline | grep 'Merge pull'` para encontrar PRs fusionados
|
||||
2. Commit
|
||||
3. Push a master
|
||||
4. Crea una etiqueta `git tag v<version>`. Debe empezar con 'v'
|
||||
5. `git push origin <tagname>`
|
||||
- Ahora espera a que se complete la acción de build/publish en Github
|
||||
6. Publica el nuevo lanzamiento
|
||||
- Ve al nuevo lanzamiento 'borrador' en la pestaña de releases de GitHub, edita las notas, publica
|
||||
- Inicia sesión en snapcraft.io, arrastra el lanzamiento subido al canal 'stable' para cada arquitectura.
|
||||
|
||||
Esta acción actualizará la documentación automáticamente.
|
||||
Esto también debería publicar la documentación más reciente
|
||||
|
||||
Después del lanzamiento:
|
||||
1. Copia las notas de versión en una entrada de blog y publícala en la web
|
||||
2. Haz un tweet con el enlace
|
||||
3. Compártelo en LinkedIn
|
||||
4. Mándalo a la lista de correo de SendInBlue
|
||||
Post Lanzamiento:
|
||||
1. Copia las notas de lanzamiento a un post de blog, publica en el sitio web
|
||||
2. Tweet del enlace
|
||||
3. Comparte en LinkedIn
|
||||
4. Envía a la lista de correo en SendInBlue
|
||||
|
||||
|
||||
## Agradecimientos
|
||||
## Un Gran Agradecimiento
|
||||
|
||||
Beekeeper Studio no existiría sin [Sqlectron-core](https://github.com/sqlectron/sqlectron-core), las librerías de bases de datos principales del [proyecto Sqlectron](https://github.com/sqlectron/sqlectron-gui). Beekeeper Studio comenzó siendo una bifurcación de ese repositorio. Muchísimas gracias a @maxcnunes y el resto de la comunidad de Sqlectron.
|
||||
Beekeeper Studio no existiría sin [Sqlectron-core](https://github.com/sqlectron/sqlectron-core), las bibliotecas de base de datos principales del [proyecto Sqlectron](https://github.com/sqlectron/sqlectron-gui). Beekeeper Studio comenzó como un fork experimental de ese repositorio. Un gran agradecimiento a @maxcnunes y al resto de la comunidad de Sqlectron.
|
||||
|
||||
La licencia original de sqlectron-core se incluye a continuación:
|
||||
La licencia original de sqlectron-core se incluye aquí:
|
||||
|
||||
```
|
||||
Copyright (c) 2015 The SQLECTRON Team
|
||||
|
||||
294
README.pt-br.md
294
README.pt-br.md
@@ -1,153 +1,257 @@
|
||||
**Atenção usuários MacOS, Windows e Linux através de AppImage**
|
||||
🌐 [EN](README.md) | [ES](README-es.md)
|
||||
|
||||
- A funcionalidade de atualização automática estava quebrada nas versões anteriores a 1.7.5. Por favor, faça atualização de forma manual a partir da seção de [release](https://github.com/beekeeper-studio/beekeeper-studio/releases).
|
||||
# Beekeeper Studio
|
||||
|
||||
Beekeeper Studio é um editor SQL multiplataforma e gerenciador de banco de dados disponível para Linux, Mac e Windows.
|
||||
|
||||
[Baixar Beekeeper Studio](https://beekeeperstudio.io/get-community)
|
||||
|
||||
Publicamos binários para MacOS, Windows e Linux.
|
||||
|
||||
[](https://beekeeperstudio.io/get)
|
||||
|
||||
|
||||

|
||||
Beekeeper Studio é gratuito para baixar e oferece muitos recursos gratuitamente, sem necessidade de cadastro, registro ou cartão de crédito. O aplicativo oferece alguns recursos premium por um preço de licença razoável. [Saiba mais aqui](https://beekeeperstudio.io/pricing)
|
||||
|
||||
Beekeeper Studio é um editor e gerenciador SQL de banco de dados multiplataforma, disponível para Linux, MacOS e Windows.
|
||||
|
||||
Beekeeper Studio usa a licença GPLv3, portanto é livre e grátis.
|
||||
A maior parte do código neste repositório é open source sob a licença GPLv3. Recursos pagos também estão neste repositório sob uma licença comercial com código-fonte disponível.
|
||||
|
||||
Baixe agora [do nosso site](https://beekeeperstudio.io).
|
||||
Contribuições da comunidade são bem-vindas!
|
||||
|
||||
Curtiu o Beekeeper Studio e quer contribuir, mas não com código? [Temos algumas ideias pra você!](https://github.com/beekeeper-studio/beekeeper-studio/issues/287)
|
||||
|
||||
## Suporte a Bancos de Dados
|
||||
## Bancos de Dados Suportados
|
||||
|
||||
<!-- Don't edit this, it gets built automatically from docs/includes/supported_databases.md -->
|
||||
<!-- SUPPORT_BEGIN -->
|
||||
|
||||
| Database | Support | Community | Paid Editions | Beekeeper Links |
|
||||
| Banco de Dados | Suporte | Community | Edições Pagas | Links do Beekeeper |
|
||||
| :------------------------------------------------------- | :--------------------------- | :-------: | :------: | -----------------------------------------: |
|
||||
| [PostgreSQL](https://postgresql.org) | ⭐ Full Support | ✅ | ✅ | [Features](https://beekeeperstudio.io/db/postgres-client) |
|
||||
| [MySQL](https://www.mysql.com/) | ⭐ Full Support | ✅ | ✅ | [Features](https://beekeeperstudio.io/db/mysql-client)|
|
||||
| [SQLite](https://sqlite.org) | ⭐ Full Support | ✅ | ✅ | [Features](https://beekeeperstudio.io/db/sqlite-client), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/sqlite) |
|
||||
| [SQL Server](https://www.microsoft.com/en-us/sql-server) | ⭐ Full Support | ✅ | ✅ | [Features](https://beekeeperstudio.io/db/sql-server-client) |
|
||||
| [Amazon Redshift](https://aws.amazon.com/redshift/) | ⭐ Full Support | ✅ | ✅ | [Features](https://beekeeperstudio.io/db/redshift-client) |
|
||||
| [CockroachDB](https://www.cockroachlabs.com/) | ⭐ Full Support | ✅ | ✅ | [Features](https://beekeeperstudio.io/db/cockroachdb-client)|
|
||||
| [MariaDB](https://mariadb.org/) | ⭐ Full Support | ✅ | ✅ | [Features](https://beekeeperstudio.io/db/mariadb-client) |
|
||||
| [TiDB](https://pingcap.com/products/tidb/) | ⭐ Full Support | ✅ | ✅ | [Features](https://beekeeperstudio.io/db/tidb-client) |
|
||||
| [Google BigQuery](https://cloud.google.com/bigquery) | ⭐ Full Support | ✅ | ✅ | [Features](https://beekeeperstudio.io/db/google-big-query-client), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/bigquery) |
|
||||
| [Redis](https://redis.io/) | ⭐ Full Support | ✅ | ✅ | [Features](https://www.beekeeperstudio.io/db/redis-client/) |
|
||||
| [Oracle Database](https://www.oracle.com/database/) | ⭐ Full Support | | ✅ | [Features](https://beekeeperstudio.io/db/oracle-client), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/oracle) |
|
||||
| [Cassandra](http://cassandra.apache.org/) | ⭐ Full Support | | ✅ | [Features](https://beekeeperstudio.io/db/cassandra-client) |
|
||||
| [Firebird](https://firebirdsql.org/) | ⭐ Full Support | | ✅ | [Features](https://beekeeperstudio.io/db/firebird-client), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/firebird) |
|
||||
| [LibSQL](https://libsql.org/) | ⭐ Full Support | | ✅ | [Features](https://beekeeperstudio.io/db/libsql-client) |
|
||||
| [ClickHouse](https://clickhouse.tech/) | ⭐ Full Support | | ✅ | [Features](https://www.beekeeperstudio.io/db/clickhouse-client/), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/clickhouse) |
|
||||
| [DuckDB](https://duckdb.org/) | ⭐ Full Support | | ✅ | [Features](https://www.beekeeperstudio.io/db/duckdb-client/), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/duckdb) |
|
||||
| [SQL Anywhere](https://www.sap.com/products/technology-platform/sql-anywhere.html) | ⭐ Full Support | | ✅ | [Features](https://www.beekeeperstudio.io/db/sql-anywhere-client/) |
|
||||
| [MongoDB](https://www.mongodb.com/) | ⭐ Full Support | | ✅ | [Features](https://www.beekeeperstudio.io/db/mongodb-client/), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/mongodb) |
|
||||
| [Trino](https://trino.io/) / [Presto](https://prestodb.io/) | ⭐ Full Support | | ✅ | [Features](https://www.beekeeperstudio.io/db/trino-client/), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/trino/) |
|
||||
| [Snowflake](https://www.snowflake.com/) | ⏳ Coming Soon | | ✅ | -- |
|
||||
| [DynamoDB](https://aws.amazon.com/dynamodb/) | 🗓️ Planned | | ✅ | -- |
|
||||
| [PostgreSQL](https://postgresql.org) | ⭐ Suporte Completo | ✅ | ✅ | [Recursos](https://beekeeperstudio.io/db/postgres-client) |
|
||||
| [MySQL](https://www.mysql.com/) | ⭐ Suporte Completo | ✅ | ✅ | [Recursos](https://beekeeperstudio.io/db/mysql-client)|
|
||||
| [SQLite](https://sqlite.org) | ⭐ Suporte Completo | ✅ | ✅ | [Recursos](https://beekeeperstudio.io/db/sqlite-client), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/sqlite) |
|
||||
| [SQL Server](https://www.microsoft.com/en-us/sql-server) | ⭐ Suporte Completo | ✅ | ✅ | [Recursos](https://beekeeperstudio.io/db/sql-server-client) |
|
||||
| [Amazon Redshift](https://aws.amazon.com/redshift/) | ⭐ Suporte Completo | ✅ | ✅ | [Recursos](https://beekeeperstudio.io/db/redshift-client) |
|
||||
| [CockroachDB](https://www.cockroachlabs.com/) | ⭐ Suporte Completo | ✅ | ✅ | [Recursos](https://beekeeperstudio.io/db/cockroachdb-client)|
|
||||
| [MariaDB](https://mariadb.org/) | ⭐ Suporte Completo | ✅ | ✅ | [Recursos](https://beekeeperstudio.io/db/mariadb-client) |
|
||||
| [TiDB](https://pingcap.com/products/tidb/) | ⭐ Suporte Completo | ✅ | ✅ | [Recursos](https://beekeeperstudio.io/db/tidb-client) |
|
||||
| [Google BigQuery](https://cloud.google.com/bigquery) | ⭐ Suporte Completo | ✅ | ✅ | [Recursos](https://beekeeperstudio.io/db/google-big-query-client), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/bigquery) |
|
||||
| [Redis](https://redis.io/) | ⭐ Suporte Completo | ✅ | ✅ | [Recursos](https://www.beekeeperstudio.io/db/redis-client/) |
|
||||
| [Oracle Database](https://www.oracle.com/database/) | ⭐ Suporte Completo | | ✅ | [Recursos](https://beekeeperstudio.io/db/oracle-client), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/oracle) |
|
||||
| [Cassandra](http://cassandra.apache.org/) | ⭐ Suporte Completo | | ✅ | [Recursos](https://beekeeperstudio.io/db/cassandra-client) |
|
||||
| [Firebird](https://firebirdsql.org/) | ⭐ Suporte Completo | | ✅ | [Recursos](https://beekeeperstudio.io/db/firebird-client), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/firebird) |
|
||||
| [LibSQL](https://libsql.org/) | ⭐ Suporte Completo | | ✅ | [Recursos](https://beekeeperstudio.io/db/libsql-client) |
|
||||
| [ClickHouse](https://clickhouse.tech/) | ⭐ Suporte Completo | | ✅ | [Recursos](https://www.beekeeperstudio.io/db/clickhouse-client/), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/clickhouse) |
|
||||
| [DuckDB](https://duckdb.org/) | ⭐ Suporte Completo | | ✅ | [Recursos](https://www.beekeeperstudio.io/db/duckdb-client/), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/duckdb) |
|
||||
| [SQL Anywhere](https://www.sap.com/products/technology-platform/sql-anywhere.html) | ⭐ Suporte Completo | | ✅ | [Recursos](https://www.beekeeperstudio.io/db/sql-anywhere-client/) |
|
||||
| [MongoDB](https://www.mongodb.com/) | ⭐ Suporte Completo | | ✅ | [Recursos](https://www.beekeeperstudio.io/db/mongodb-client/), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/mongodb) |
|
||||
| [Trino](https://trino.io/) / [Presto](https://prestodb.io/) | ⭐ Suporte Completo | | ✅ | [Recursos](https://www.beekeeperstudio.io/db/trino-client/), [Docs](https://docs.beekeeperstudio.io/user_guide/connecting/trino/) |
|
||||
| [Snowflake](https://www.snowflake.com/) | ⏳ Em Breve | | ✅ | -- |
|
||||
| [DynamoDB](https://aws.amazon.com/dynamodb/) | 🗓️ Planejado | | ✅ | -- |
|
||||
|
||||
|
||||
|
||||
|
||||
<!-- SUPPORT_END -->
|
||||
|
||||
## Edições do Beekeeper Studio
|
||||
|
||||
# Funcionalidades
|
||||
Beekeeper Studio é um único download com upgrades dentro do aplicativo para recursos premium.
|
||||
|
||||
Principais funcionalidades: é leve 🍫, rápido 🏎 e você realmente vai gostar de usa-lo 🥰
|
||||
Adoraríamos tornar o Beekeeper Studio totalmente gratuito para todos, mas construir bom software é um trabalho difícil e caro. Acreditamos que nossas edições pagas têm preços justos, esperamos que você também ache.
|
||||
|
||||
- Editor de queries SQL com autocomplemento e realce de sintaxe.
|
||||
- Interface com abas, então você pode fazer multitarefas.
|
||||
- Ordenação e filtros dos dados na tabela, para facilitar encontrar o que você precisa.
|
||||
- Atalhos sensíveis no teclado.
|
||||
- Opção de salvar as consultas.
|
||||
- Histórico de consultas executadas, permitindo saber as consultas que você executou anteiormente.
|
||||
- Tema escuro como padrão.
|
||||
👉 [Compare as Edições do Beekeeper Studio](https://beekeeperstudio.io/pricing)
|
||||
|
||||
Uma de nossas frustrações com outros editores e gerenciadores SQL de código aberto é que eles usam uma abordagem de "pia na cozinha" para suas funcionalidades, adicionando tantas funcionalidades que tornam a interface desordenada e difícil de navegar. Nós queremos um visual legal, uma ferramenta SQL de código aberto que seja poderosa, mas fácil de usar. Não encontramos uma que atendesse esses requisitos, então resolvemos criar uma.
|
||||
## Recursos do Beekeeper Studio
|
||||
|
||||
Beekeeper Studio suporta conexão com os seguintes bancos de dados:
|
||||
Principal recurso: É suave 🍫, rápido 🏎, e você vai realmente gostar de usar 🥰
|
||||
|
||||
- PostgreSQL
|
||||
- SQLite
|
||||
- MySQL
|
||||
- MariaDB
|
||||
- TiDB
|
||||
- SQL Server
|
||||
- Amazon Redshift
|
||||
- CockroachDB
|
||||
- Oracle Database
|
||||
- Google BigQuery
|
||||
- Apache Cassandra
|
||||
- Verdadeiramente multiplataforma: Windows, MacOS e Linux
|
||||
- Editor de consultas SQL com autocomplete e destaque de sintaxe
|
||||
- Interface com abas, para você poder fazer multitarefas
|
||||
- Ordenar e filtrar dados da tabela para encontrar exatamente o que você precisa
|
||||
- Atalhos de teclado sensatos
|
||||
- Salvar consultas para depois
|
||||
- Histórico de execução de consultas, para você encontrar aquela consulta que funcionou 3 dias atrás
|
||||
- Excelente tema escuro
|
||||
- Importar/exportar
|
||||
- Backup/restauração
|
||||
- Visualizar dados como JSON
|
||||
- E muito mais
|
||||
|
||||
## Instalação
|
||||
## Nossa Abordagem de UX
|
||||
|
||||
Uma de nossas frustrações com outros editores SQL e gerenciadores de banco de dados open source é que eles adotam uma abordagem de "colocar tudo" nos recursos, adicionando tantos recursos que a interface fica bagunçada e difícil de navegar. Queríamos um workbench SQL open source bonito, poderoso, mas também fácil de usar. Não conseguimos encontrar um, então criamos o Beekeeper Studio!
|
||||
|
||||
Geralmente nossa estrela guia é construir software que "sinta bem" de usar. Isso significa que no mínimo valorizamos que o Beekeeper seja rápido, direto de usar e moderno. Se um novo recurso compromete essa visão, nós o eliminamos.
|
||||
|
||||
|
||||
## Apoiando o Beekeeper Studio
|
||||
|
||||
Adoramos trabalhar no Beekeeper Studio, e adoraríamos continuar crescendo e melhorando-o para sempre. Para fazer isso, precisamos da sua ajuda.
|
||||
|
||||
A melhor forma de apoiar o Beekeeper Studio é comprar uma [licença](https://beekeeperstudio.io/pricing) paga. Cada compra apoia diretamente nosso trabalho no Beekeeper Studio.
|
||||
|
||||
Se você está em uma empresa e usa o Beekeeper Studio para o seu trabalho, provavelmente deveria pedir ao seu chefe para [comprar uma licença](https://beekeeperstudio.io/pricing).
|
||||
|
||||
Se você não pode pagar uma licença, por favor use a versão gratuita, é por isso que fazemos uma versão gratuita!
|
||||
|
||||
Obrigado pelo seu apoio contínuo!
|
||||
|
||||
Baixe a última release na nossa [página de releases](https://github.com/beekeeper-studio/beekeeper-studio/releases), ou do nosso [site](https://beekeeperstudio.io).
|
||||
|
||||
## Documentação
|
||||
|
||||
Acesse o site [docs.beekeeperstudio.io](https://docs.beekeeperstudio.io) para acessar o guia de usuário, FAQs, dicas de soluções de problemas, e mais.
|
||||
Confira [docs.beekeeperstudio.io](https://docs.beekeeperstudio.io) para guias do usuário, FAQs, dicas de solução de problemas e mais.
|
||||
|
||||
## Contribuindo com Beekeeper Studio
|
||||
## Licença
|
||||
|
||||
Nós amamos _qualquer_ engajamento da comunidade, mesmo que seja uma crítica de algo que você não goste na aplicação.
|
||||
Beekeeper Studio Community Edition (o código neste repositório) é licenciado sob a licença GPLv3.
|
||||
|
||||
Construir uma comunidade inclusiva e acolhedora é importante pra gente, então por favor, siga o nosso código de conduta ao se envolver no projeto.
|
||||
Beekeeper Studio Ultimate Edition contém recursos extras e é licenciado sob um [acordo de licença de usuário final comercial (EULA)](https://beekeeperstudio.io/legal/commercial-eula/).
|
||||
|
||||
### Contribuições sem código
|
||||
As marcas registradas do Beekeeper Studio (marcas de palavras e logos) não são open source. Veja nossas [diretrizes de marca registrada](https://beekeeperstudio.io/legal/trademark/) para mais informações.
|
||||
|
||||
Nós queremos a sua contribuição, leia nosso [guia de contribuição de 10 minutos sem códificação](https://github.com/beekeeper-studio/beekeeper-studio/issues/287).
|
||||
## Diretrizes de Marca Registrada
|
||||
|
||||
### Inicializando o Beekeeper Studio na versão de Desenvolvimento
|
||||
Marcas registradas podem ser complicadas com projetos open source, então adaptamos um conjunto de diretrizes padrão para usar nossas marcas que são comuns em muitos projetos open source.
|
||||
|
||||
Quer melhorar o Beekeeper Studio codificando ou melhorando a documentação? Execute o projeto de forma fácil no Mac, Linux ou Windows.
|
||||
Se você está apenas usando o aplicativo Beekeeper Studio, e não está fazendo fork ou distribuindo código do Beekeeper Studio de nenhuma forma, estas provavelmente não se aplicam a você.
|
||||
|
||||
👉 [Diretrizes de Marca Registrada do Beekeeper Studio](https://beekeeperstudio.io/legal/trademark/)
|
||||
|
||||
## Contribuindo com o Beekeeper Studio
|
||||
|
||||
Adoramos *qualquer* engajamento da comunidade. Mesmo se você está reclamando porque não gosta de algo no aplicativo!
|
||||
|
||||
|
||||
### Acordos do Contribuidor
|
||||
|
||||
- Construir uma comunidade inclusiva e acolhedora é importante para nós, então por favor siga nosso [código de conduta](code_of_conduct.md) enquanto você se envolve com o projeto.
|
||||
|
||||
- Ao contribuir com o projeto você concorda com os termos das nossas [diretrizes de contribuição](CONTRIBUTING.md).
|
||||
|
||||
### Contribuir sem código
|
||||
|
||||
Temos você coberto, leia nosso [guia para contribuir em 10 minutos sem código](https://github.com/beekeeper-studio/beekeeper-studio/issues/287).
|
||||
|
||||
### Compilando e Executando o Beekeeper Studio Localmente
|
||||
|
||||
Quer escrever código e melhorar o Beekeeper Studio? Configurar é fácil no Mac, Linux ou Windows.
|
||||
|
||||
```bash
|
||||
# Primeiro: Instale NodeJS 12+ ou 14, NPM e Yarn
|
||||
# Primeiro: Instale NodeJS 20, NPM e Yarn
|
||||
# ...
|
||||
|
||||
# 1. Crie um fork do repositório do Beekeeper Studio (clique no botão de fork no topo a direita dessa tela)
|
||||
# 2. Checkout o seu fork:
|
||||
git clone git@github.com:<your-username>/beekeeper-studio.git beekeeper-studio
|
||||
# 1. Faça um Fork do Repositório do Beekeeper Studio (clique no botão fork no topo direito desta tela)
|
||||
# 2. Faça checkout do seu fork:
|
||||
git clone git@github.com:<seu-usuario>/beekeeper-studio.git beekeeper-studio
|
||||
cd beekeeper-studio/
|
||||
yarn install # instala dependencias
|
||||
yarn install # instala dependências
|
||||
|
||||
# Se estiver usando NodeJS 16.17+:
|
||||
export NODE_OPTIONS=--openssl-legacy-provider
|
||||
|
||||
# Agora você pode iniciar a aplicação:
|
||||
yarn run electron:serve ## a aplicação será iniciada
|
||||
# Agora você pode iniciar o aplicativo:
|
||||
yarn run electron:serve ## o aplicativo será iniciado
|
||||
```
|
||||
|
||||
### Onde fazer modificações?
|
||||
**Se você receber `error:03000086:digital envelope routines::initialization error`, você precisará atualizar o openssl.**
|
||||
|
||||
- No Ubuntu/Debian:
|
||||
```
|
||||
sudo apt-get update
|
||||
sudo apt-get upgrade openssl
|
||||
```
|
||||
|
||||
- No CentOS/RHEL:
|
||||
```
|
||||
sudo yum update openssl
|
||||
```
|
||||
|
||||
- No macOS (usando Homebrew):
|
||||
```
|
||||
brew update
|
||||
brew upgrade openssl
|
||||
```
|
||||
|
||||
### Onde fazer mudanças?
|
||||
|
||||
Este repositório agora é um monorepo, temos vários lugares com código, mas apenas alguns pontos de entrada importantes.
|
||||
|
||||
Todo o código do aplicativo está em `apps/studio`, algum código compartilhado está em `shared/src`. Isso é compartilhado com outros aplicativos.
|
||||
|
||||
Beekeeper Studio tem dois pontos de entrada:
|
||||
- `background.js` - este é o código do lado do Electron que controla coisas nativas como mostrar janelas.
|
||||
- `main.js` - este é o ponto de entrada para o aplicativo Vue.js. Você pode seguir as migalhas de pão dos componentes Vue a partir de `App.vue` para encontrar a tela que você precisa.
|
||||
|
||||
- `background.js`: essa é a parte electron, código que controla as partes nativas como mostrar as janelas.
|
||||
- `main.js`: esse é o ponto de entrada para a aplicação Vue.js. Você pode seguir os _breadcrumbs_ dos componentes a partir de `App.vue` para encontrar a tela que você precisa.
|
||||
**Geralmente temos duas 'telas':**
|
||||
- ConnectionInterface - conectando a um BD
|
||||
- CoreInterface - interagindo com um banco de dados
|
||||
|
||||
**No geral nós temos duas telas:**
|
||||
### Como submeter uma mudança?
|
||||
|
||||
- ConnectionInterface: Conectando com um Banco de dados
|
||||
- CoreInterface - Interação com o Banco de Dados
|
||||
|
||||
### Como submeter um alteração?
|
||||
- Faça push das suas mudanças para o seu repositório e abra um Pull Request da nossa página do GitHub (esta página)
|
||||
- Certifique-se de escrever algumas notas sobre o que sua mudança faz! Um gif é sempre bem-vindo para mudanças visuais.
|
||||
|
||||
- Suba as alterações para o seu repositório (seu fork) e abra um Pull Request para o nosso repositório (essa página).
|
||||
- Certifique-se de escrever alguma descrição sobre o que suas alterações fazem.
|
||||
## Notas para Mantenedores (leitores casuais podem ignorar isso)
|
||||
|
||||
## Notas para os mantenedores (leitores casuais podem ignorar)
|
||||
### Considerações ao Atualizar o Electron
|
||||
|
||||
### Processo de release
|
||||
Isso é sempre uma dor total e vai quebrar o build 9 em 10 vezes.
|
||||
|
||||
1. Incremente a versão no package.json
|
||||
2. Substitua `build/release-notes.md` com as últimas notas da release. Siga o formato que está aqui.
|
||||
- execute `git log <last-tag>..HEAD --oneline | grep 'Merge pull'` para encontrar os Pull Requests mergeados.
|
||||
3. Commit
|
||||
4. Push para master
|
||||
5. Crie uma tag `git tag v<version>`. Precisa começar com a letra 'v'
|
||||
6. `git push origin <tagname>`
|
||||
- Agora espere pela ação de _build/publish_ completar no GitHub.
|
||||
7. Subir a nova release
|
||||
Algumas coisas que você precisa considerar ao atualizar o Electron:
|
||||
|
||||
- Vá para o "rascunho" da nova release na aba de releases do GitHub, edite as notas e publique
|
||||
- Faça Login em snapcraft.io, arraste a versão enviada para o canal 'estável' de cada arquitetura.
|
||||
1. Ele usa uma versão diferente do node? Ex: Electron-18 usa node 14, 22 usa node 16. Então todos precisam atualizar
|
||||
2. O node-abi precisa ser atualizado para poder entender a versão do Electron? Isso é usado no build para buscar pacotes pré-compilados. Você precisa atualizar isso em root/package.json#resolutions
|
||||
3. Alguma API foi depreciada ou removida? Certifique-se de que todos os recursos que interagem com as APIs do Electron ainda funcionam, coisas como - selecionar um arquivo, maximizar uma janela, executar uma consulta, etc.
|
||||
|
||||
## Agradecimentos
|
||||
|
||||
Beekeeper Studio não existiria sem [Sqlectron-core](https://github.com/sqlectron/sqlectron-core), a biblioteca principal de Banco de Dados (agora não mais mantida) Sqlectron project. O Beekeeper Studio começou como um fork experimental desse repositório. Um grande obrigado ao @maxcnunes e os outros membros da comunidade Sqlectron.
|
||||
### Processo de Release
|
||||
|
||||
1. Aumente o número da versão em package.json
|
||||
2. Substitua `build/release-notes.md` com as últimas notas de release. Siga o formato que está lá.
|
||||
- execute `git log <last-tag>..HEAD --oneline | grep 'Merge pull'` para encontrar PRs mergeados
|
||||
2. Commit
|
||||
3. Push para master
|
||||
4. Crie uma tag `git tag v<version>`. Deve começar com 'v'
|
||||
5. `git push origin <tagname>`
|
||||
- Agora espere a ação de build/publish completar no Github
|
||||
6. Publique a nova release
|
||||
- Vá para a nova release 'rascunho' na aba de releases do GitHub, edite as notas, publique
|
||||
- Faça login no snapcraft.io, arraste a release enviada para o canal 'stable' para cada arquitetura.
|
||||
|
||||
Isso também deve publicar a documentação mais recente
|
||||
|
||||
Pós Release:
|
||||
1. Copie as notas de release para um post de blog, publique no site
|
||||
2. Tweet do link
|
||||
3. Compartilhe no LinkedIn
|
||||
4. Envie para a lista de emails no SendInBlue
|
||||
|
||||
|
||||
## Muito Obrigado
|
||||
|
||||
Beekeeper Studio não existiria sem [Sqlectron-core](https://github.com/sqlectron/sqlectron-core), as bibliotecas principais de banco de dados do [projeto Sqlectron](https://github.com/sqlectron/sqlectron-gui). Beekeeper Studio começou como um fork experimental daquele repositório. Um grande obrigado ao @maxcnunes e ao resto da comunidade Sqlectron.
|
||||
|
||||
A licença original do sqlectron-core está incluída aqui:
|
||||
|
||||
```
|
||||
Copyright (c) 2015 The SQLECTRON Team
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining
|
||||
a copy of this software and associated documentation files (the
|
||||
'Software'), to deal in the Software without restriction, including
|
||||
without limitation the rights to use, copy, modify, merge, publish,
|
||||
distribute, sublicense, and/or sell copies of the Software, and to
|
||||
permit persons to whom the Software is furnished to do so, subject to
|
||||
the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be
|
||||
included in all copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
|
||||
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
||||
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
||||
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
||||
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
||||
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
||||
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user