mirror of
https://github.com/usebruno/bruno.git
synced 2024-12-29 01:59:31 +01:00
98 lines
3.0 KiB
Markdown
98 lines
3.0 KiB
Markdown
[English](../../contributing.md)
|
|
| [Українська](./contributing_ua.md)
|
|
| [Русский](./contributing_ru.md)
|
|
| [Türkçe](./contributing_tr.md)
|
|
| [Deutsch](./contributing_de.md)
|
|
| [Français](./contributing_fr.md)
|
|
| [Português (BR)](./contributing_pt_br.md)
|
|
| [한국어](./contributing_kr.md)
|
|
| [বাংলা](./contributing_bn.md)
|
|
| [Español](./contributing_es.md)
|
|
| [Italiano](./contributing_it.md)
|
|
| **Română**
|
|
| [Polski](./contributing_pl.md)
|
|
| [简体中文](./contributing_cn.md)
|
|
| [正體中文](./contributing_zhtw.md)
|
|
| [日本語](./contributing_ja.md)
|
|
| [हिंदी](./contributing_hi.md)
|
|
|
|
## Haideţi să îmbunătățim Bruno, împreună!!
|
|
|
|
Ne bucurăm că doriți să îmbunătățiți bruno. Mai jos sunt instrucțiunile pentru ca să porniți bruno pe calculatorul dvs.
|
|
|
|
### Stack-ul tehnologic
|
|
|
|
Bruno este construit cu Next.js și React. De asemenea, folosim electron pentru a livra o versiune desktop (care poate folosi colecții locale)
|
|
|
|
Bibliotecile pe care le folosim
|
|
|
|
- CSS - Tailwind
|
|
- Editori de cod - Codemirror
|
|
- Management de condiție - Redux
|
|
- Icoane - Tabler Icons
|
|
- Formulare - formik
|
|
- Validarea schemelor - Yup
|
|
- Cererile client - axios
|
|
- Observatorul sistemului de fișiere - chokidar
|
|
|
|
### Dependențele
|
|
|
|
Veți avea nevoie de [Node v18.x sau cea mai recentă versiune LTS](https://nodejs.org/en/) și npm 8.x. Noi folosim spații de lucru npm în proiect
|
|
|
|
## Dezvoltarea
|
|
|
|
Bruno este dezvoltat ca o aplicație desktop. Ca să porniți aplicatia trebuie să rulați aplicația Next.js într-un terminal și apoi să rulați aplicația electron într-un alt terminal.
|
|
|
|
```shell
|
|
# folosiți nodejs versiunea 18
|
|
nvm use
|
|
|
|
# instalați dependențele
|
|
npm i --legacy-peer-deps
|
|
|
|
# construiți documente graphql
|
|
npm run build:graphql-docs
|
|
|
|
# construiți bruno query
|
|
npm run build:bruno-query
|
|
|
|
# rulați aplicația next (terminal 1)
|
|
npm run dev:web
|
|
|
|
# rulați aplicația electron (terminal 2)
|
|
npm run dev:electron
|
|
```
|
|
|
|
### Depanare
|
|
|
|
Este posibil să întâmpinați o eroare `Unsupported platform` când rulați „npm install”. Pentru a remedia acest lucru, va trebui să ștergeți `node_modules` și `package-lock.json` și să rulați `npm install`. Aceasta ar trebui să instaleze toate pachetele necesare pentru a rula aplicația.
|
|
|
|
```shell
|
|
# Ștergeți node_modules din subdirectoare
|
|
find ./ -type d -name "node_modules" -print0 | while read -d $'\0' dir; do
|
|
rm -rf "$dir"
|
|
done
|
|
|
|
# Ștergeți package-lock din subdirectoare
|
|
find . -type f -name "package-lock.json" -delete
|
|
```
|
|
|
|
### Testarea
|
|
|
|
```shell
|
|
# bruno-schema
|
|
npm test --workspace=packages/bruno-schema
|
|
|
|
# bruno-lang
|
|
npm test --workspace=packages/bruno-lang
|
|
```
|
|
|
|
### Crearea unui Pull Request
|
|
|
|
- Vă rugăm să păstrați PR-urile mici și concentrate pe un singur lucru
|
|
- Vă rugăm să urmați formatul de creare a branchurilor
|
|
- feature/[Numele funcției]: Acest branch ar trebui să conțină modificări pentru o funcție anumită
|
|
- Exemplu: feature/dark-mode
|
|
- bugfix/[Numele eroarei]: Acest branch ar trebui să conţină numai remedieri pentru o eroare anumită
|
|
- Exemplu bugfix/bug-1
|