# Kod

> Zleć Dvina napisanie kodu w projekcie na Twoim komputerze, przejrzyj każdą zmianę, a następnie utwórz commit i otwórz pull request bezpośrednio z czatu.

Dvina pisze kod w Twoim projekcie na Twoim komputerze, uwzględniając notatki, wątki i powody podjętych decyzji. Opisujesz, czego potrzebujesz, przeglądasz wprowadzone zmiany i oddajesz je do użytku — w tej samej aplikacji, której używasz do wszystkiego innego.

## Zanim zaczniesz

Kod jest częścią aplikacji komputerowej Dvina na Mac, Windows i Linux. Nie musisz instalować niczego osobno. Dvina musi być zainstalowana na co najmniej jednym komputerze; na każdym innym urządzeniu możesz rozpoczynać pracę i śledzić jej postępy.

Aby pobrać aplikację komputerową, zobacz [Pobieranie i instalowanie Dvina](/docs/use-dvina/get-started/install).

## Otwórz projekt

Projekt to folder na Twoim komputerze: repozytorium kodu lub zwykły folder.

1. W aplikacji komputerowej otwórz Dock i wybierz wiersz projektów (**Projekty**).
2. Wybierz **Otwórz…**, aby wskazać folder lub repozytorium kodu, albo **Nowy projekt…**, aby utworzyć nowy folder na tym komputerze.

Podczas tworzenia nowego projektu włącz **Utwórz repozytorium Git**, aby zachować historię wszystkich zmian i móc cofnąć zmiany wprowadzone przez Dvina.

Czat pracuje w wybranym przez Ciebie projekcie. W przypadku projektu z kodem Dock pokazuje też jego gałąź.

## Zleć pracę

Opisz, czego potrzebujesz, na przykład „Popraw daty używane przy eksporcie do CSV”. Dvina wykonuje to jako zadanie na Twoim komputerze, a Ty możesz dalej rozmawiać lub uruchamiać kolejne zadania. Kilka zadań może pracować w jednym repozytorium i ustalać między sobą, które jako pierwsze utworzy commit.

Zanim Dvina zacznie pisać, zapoznaje się z projektem i jego kontekstem: przeszukuje Twoje wcześniejsze czaty i pliki, by uwzględnić powody podjętych decyzji. Stosuje się też do instrukcji w pliku AGENTS.md lub CLAUDE.md w Twoim projekcie.

## Przejrzyj zmiany

Odpowiedź na każde zadanie pojawia się wraz ze zmianami na karcie z nazwą zadania i statusem **Gotowe do przeglądu**.

- **Zobacz, co się zmieniło:** Wybierz **Zmiany**, aby zobaczyć zmiany w każdym pliku w panelu bocznym. Opcja **Pliki** pozwala przeglądać projekt.
- **Cofnij zmiany z jednej odpowiedzi:** Pod odpowiedzią, która zmieniła pliki, wybierz wiersz z liczbą zmienionych plików, następnie **Cofnij** i potwierdź **Cofnąć zmiany z tej odpowiedzi?**. Pliki wrócą do stanu sprzed tej odpowiedzi, a późniejsze zmiany zostaną zachowane.

## Utwórz commit i otwórz pull request

1. Na karcie zadania wybierz **Utwórz commit**.
2. Okno **Utwórz commit ze zmian** pokazuje pliki, które zostaną zapisane w commicie na Twojej gałęzi, oraz sugerowany **Tytuł** i **Opis**. Wybierz **Utwórz commit**. Nic nie jest wysyłane do zdalnego repozytorium.
3. Aby otworzyć pull request, wybierz **Wyślij i utwórz PR**. Dvina najpierw wysyła bieżącą gałąź, a następnie otwiera pull request. Pliki niezapisane w commicie nie są uwzględniane.

Pull request jest tworzony z użyciem Twoich danych logowania do Git. Dvina otwiera go w GitHub lub GitLab; w przypadku każdego innego hosta otwiera w przeglądarce jego stronę tworzenia nowego pull requestu. Po zakończeniu wybierz **Zobacz PR**.

## Zatwierdzanie

Kompilacje i testy uruchamiają się bez pytania. Usuwanie plików, wysyłanie zmian do repozytorium, zmiany w bazie danych, wdrożenia i wszelkie działania związane z sekretami wymagają Twojej zgody. Karta wyjaśnia powód, na przykład **Uruchomić to polecenie?** z informacją **Usuwa pliki** lub **Zmienia bazę danych**, a Ty wybierasz **Zezwól** lub **Odrzuć**. Administrator może określić, które działania zawsze wymagają zgody.

> [!IMPORTANT]
> Żadne zmiany nie są wysyłane do repozytorium bez Twojej zgody. Twój projekt to folder na Twoim komputerze, a dzięki Git każdą zmianę wprowadzoną przez Dvina można cofnąć.

## Testuj w symulatorze lub emulatorze

W aplikacji komputerowej Dvina może testować Twoją aplikację na tym komputerze tak, jak będą z niej korzystać użytkownicy: w przeglądarce, w iOS Simulator na Macu lub w Android Emulator na Macu, w systemie Windows albo Linux.

1. Otwórz Dock i wybierz wiersz **Urządzenie**.
2. W sekcji **To urządzenie** wybierz **Przeglądarka**, **iOS Simulator** lub **Android Emulator**.

Widok otworzy się w panelu bocznym. Wyłączony symulator uruchomi się po otwarciu. Aby użyć innego, wybierz **Wybierz urządzenie** u góry widoku. Przy każdym urządzeniu widoczny jest jego system oraz stan: **Uruchomione** lub **Wyłączone**.

Aby pokazać lub ukryć przeglądarkę, naciśnij <kbd>⌘</kbd> <kbd>⇧</kbd> <kbd>B</kbd> na Macu lub <kbd>Ctrl</kbd> <kbd>Shift</kbd> <kbd>B</kbd> w systemach Windows i Linux. Gdy Dvina pracuje w widoku, którego nie oglądasz, przy wierszu **Urządzenie** pojawia się kropka.

### Zezwól Dvina na korzystanie z urządzenia

Gdy Dvina po raz pierwszy korzysta z symulatora lub emulatora, prosi o zgodę, na przykład **Zezwolić Dvina na korzystanie z iPhone 17 Pro?**. Dvina widzi ekran urządzenia, więc nie loguj się na nim na swoje rzeczywiste konta. Wybierz **Zezwól** lub **Odrzuć**. Twoja odpowiedź zostaje zapamiętana dla tego urządzenia, więc w innym czacie pytanie nie pojawi się ponownie. Dopóki nie wyrazisz zgody, w widoku dostępna jest opcja **Zezwól Dvina na korzystanie**.

Podczas pracy Dvina w widoku pojawia się komunikat **Dvina korzysta z tego urządzenia**, a w czacie widać urządzenie na żywo. Wybierz **Powiększ podgląd**, aby zobaczyć je w większym rozmiarze. Wysyłanie, płacenie i usuwanie na urządzeniu za każdym razem wymagają Twojej zgody.

Aby samodzielnie korzystać z urządzenia, wybierz **Przejmij sterowanie**. Twoje dotknięcia i naciśnięcia klawiszy trafiają wtedy do urządzenia. Możesz też nacisnąć **Ekran główny**, a w systemie Android także **Wstecz** i **Ostatnie aplikacje**. Gdy skończysz, wybierz **Oddaj sterowanie**, a Dvina wznowi pracę.

### Skonfiguruj iOS Simulator

Jeśli iOS Simulator nie jest skonfigurowany, jego wiersz otwiera listę kontrolną **Skonfiguruj iOS Simulator**. Każdy krok jest automatycznie oznaczany jako wykonany, nawet jeśli wykonasz go poza tą listą.

1. **Zainstaluj Xcode:** Wybierz **Otwórz App Store**. Xcode jest bezpłatny i zajmuje około 7 GB. Po instalacji otwórz go raz.
2. **Wybierz Xcode:** Wybierz **Kopiuj polecenie** i uruchom je w Terminalu. Polecenie wymaga Twojego hasła, więc Dvina nigdy nie uruchamia go za Ciebie.
3. **Dodaj symulator iOS:** W Xcode przejdź do Settings › Components i pobierz iOS lub uruchom polecenie w Terminalu.
4. **Utwórz urządzenie:** Wybierz **Utwórz iPhone'a**. Nic nie zostanie pobrane.

### Skonfiguruj Android Emulator

Jeśli Android Emulator nie jest skonfigurowany, jego wiersz otwiera listę kontrolną **Skonfiguruj emulator Androida**.

1. **Zainstaluj Android Studio:** Wybierz **Pobierz Android Studio**. Zainstaluje ono środowisko potrzebne do działania emulatora. Po instalacji otwórz je raz.
2. **Dodaj emulator i narzędzia platformy:** Uruchom polecenie w terminalu lub dodaj je w Android Studio › SDK Manager.
3. **Włącz przyspieszenie sprzętowe:** W systemach Windows i Linux uruchom polecenie samodzielnie, ponieważ wymaga ono Twojego hasła lub uprawnień administratora. Następnie w systemie Linux wyloguj się i zaloguj ponownie, a w systemie Windows uruchom komputer ponownie. Na Macu nie trzeba nic robić w tym kroku.
4. **Dodaj obraz systemu:** Uruchom polecenie w terminalu lub dodaj obraz w Android Studio › SDK Manager. Wymaga to pobrania dużego pliku.
5. **Utwórz emulator:** Wybierz **Utwórz emulator**. Nic nie zostanie pobrane.

Jeśli administrator wyłączył symulatory, w ich wierszach pojawi się komunikat **Wyłączone przez administratora**.

## Pracuj z dowolnego miejsca

Z telefonu lub przez przeglądarkę zleć pracę na czacie. Dvina wykona ją w projekcie na Twoim komputerze, a zmiany będą czekać na Twoją weryfikację. Komputer musi być włączony, a Dvina — otwarta.

## Kiedy korzystać

- Pracujesz nad rzeczywistym oprogramowaniem i chcesz mieć pełny kontekst: notatki, decyzje i wątki z zeszłego miesiąca.
- Chcesz, by poprawka została wprowadzona, gdy jesteś z dala od biurka.
- Chcesz, by praca nad kilkoma zmianami przebiegała jednocześnie, a każda z nich była gotowa do weryfikacji.

## Wskazówki

- **Spisz swoje zasady pracy.** Opisz swój sposób pracy w AGENTS.md lub CLAUDE.md, a Dvina będzie się go trzymać.
- **Testuj na telefonie.** Tworzysz aplikację? Dvina może przetestować ją w symulatorze iPhone’a lub emulatorze Androida, przechodząc przez nią dotknięciami tak jak Twoi użytkownicy. Zobacz [Testowanie w symulatorze lub emulatorze](#test-on-a-simulator-or-emulator).
- **Nie zajmujesz się programowaniem?** Aby tworzyć działające aplikacje i strony, skorzystaj z funkcji [Tworzenie](/docs/use-dvina/features/create).

## Powiązane

- [Projekty](/docs/use-dvina/features/projects)
- [Zadania](/docs/use-dvina/features/tasks)
- [Obsługa komputera](/docs/use-dvina/features/computer-use)
- [Instalacja](/docs/use-dvina/get-started/install)