Dvina kirjoittaa koodia tietokoneellasi olevaan projektiin ja pitää muistiinpanot, keskusteluketjut ja perustelut mukana. Kerrot, mitä haluat, tarkistat tehdyt muutokset ja toimitat ne käyttöön samassa sovelluksessa, jota käytät kaikkeen muuhunkin.

Ennen kuin aloitat

Koodi on osa Dvina-työpöytäsovellusta Macilla, Windowsilla ja Linuxilla. Mitään erillistä ei tarvitse asentaa. Dvina on oltava vähintään yhdellä tietokoneella. Kaikilla muilla laitteilla voit käynnistää työn ja seurata sitä.

Saat työpöytäsovelluksen ohjeen Lataa ja asenna Dvina avulla.

Avaa projekti

Projekti on tietokoneellasi oleva kansio: koodin tietovarasto tai tavallinen kansio.

  1. Avaa työpöytäsovelluksessa Dock ja valitse projektirivi (Projektit).
  2. Valitse Avaa…, jos haluat valita kansion tai koodin tietovaraston, tai Uusi projekti…, jos haluat luoda uuden kansion tälle tietokoneelle.

Kun luot uuden projektin, ota käyttöön Luo Git-tietovarasto, jotta kaikista muutoksista säilyy historia ja Dvina-sovelluksen tekemät muokkaukset voidaan kumota.

Keskustelu käyttää valitsemaasi projektia. Jos kyseessä on koodiprojekti, Dock näyttää myös sen haaran.

Pyydä tekemään työ

Kuvaile, mitä haluat, esimerkiksi "Korjaa CSV-vienti käyttämään oikeita päivämääriä". Dvina suorittaa työn tehtävänä tietokoneellasi, ja voit jatkaa keskustelua tai käynnistää lisää tehtäviä. Useat tehtävät voivat työskennellä samassa tietovarastossa ja sopia keskenään, mikä niistä tekee commitin ensin.

Ennen koodin kirjoittamista Dvina lukee projektin ja sen taustatiedot: se etsii tietoa aiemmista keskusteluistasi ja tiedostoistasi, jotta myös perustelut pysyvät mukana. Se noudattaa myös projektisi AGENTS.md- tai CLAUDE.md-tiedoston ohjeita.

Tarkista muutokset

Kunkin tehtävän vastaus ja muutokset näkyvät tehtävän mukaan nimetyssä kortissa, jossa lukee Valmis tarkistettavaksi.

  • Katso, mikä muuttui: Valitse Muutokset, niin näet kunkin tiedoston muutokset sivupaneelissa. Valitsemalla Tiedostot voit selata projektia.
  • Kumoa yhden vastausvuoron muutokset: Valitse tiedostoja muuttaneen vastauksen alta rivi, joka kertoo muuttuneiden tiedostojen määrän. Valitse sitten Kumoa ja vahvista Kumotaanko tämän vuoron muutokset?. Tiedostot palautuvat vuoroa edeltäneeseen tilaan, ja sen jälkeen tehdyt muutokset säilyvät.

Tee commit ja avaa vetopyyntö

  1. Valitse tehtävän kortista Tee commit.
  2. Tee muutoksista commit näyttää tiedostot, jotka sisällytetään haarasi commitiin, sekä ehdotetun Otsikon ja Viestin. Valitse Tee commit. Mitään ei lähetetä etätietovarastoon.
  3. Avaa vetopyyntö valitsemalla Lähetä ja luo vetopyyntö. Dvina lähettää ensin nykyisen haaran etätietovarastoon ja avaa sitten vetopyynnön. Tiedostot, joista ei ole tehty commitia, eivät tule mukaan.

Vetopyyntö tehdään omalla Git-kirjautumisellasi. Dvina avaa sen GitHubissa tai GitLabissa. Muissa palveluissa selaimeesi avautuu palvelun oma uuden vetopyynnön sivu. Kun se on valmis, valitse Näytä vetopyyntö.

Hyväksynnät

Koontiversiot ja testit suoritetaan automaattisesti. Tiedostojen poistaminen, muutosten lähettäminen etärepositorioon, tietokantamuutokset, käyttöönotot ja kaikki salaisuuksia käsittelevät toimet odottavat hyväksyntääsi. Kortti kertoo syyn, esimerkiksi Suoritetaanko tämä komento? ja Poistaa tiedostoja tai Muuttaa tietokantaa. Valitse Salli tai Hylkää. Ylläpitäjäsi voi määrittää, mitkä toimet vaativat aina hyväksynnän.

Tärkeää

Mitään ei lähetetä etärepositorioon ilman lupaasi. Projektisi on kansio tietokoneellasi, ja Gitin avulla voit kumota jokaisen Dvinan tekemän muutoksen.

Testaa simulaattorilla tai emulaattorilla

Työpöytäsovelluksessa Dvina voi kokeilla sovellustasi tällä tietokoneella samalla tavalla kuin käyttäjäsi: selaimessa, iOS-simulaattorissa Macilla tai Android-emulaattorissa Macilla, Windowsissa tai Linuxissa.

  1. Avaa Dock ja valitse Laite-rivi.
  2. Valitse kohdasta Tämä laite joko Selain, iOS-simulaattori tai Android-emulaattori.

Näkymä avautuu sivupaneeliin. Jos simulaattori on sammutettu, se käynnistyy, kun avaat sen. Jos haluat käyttää toista laitetta, valitse näkymän yläreunasta Valitse laite. Kunkin laitteen kohdalla näkyy sen käyttöjärjestelmä sekä tila Käynnissä tai Sammutettu.

Näytä tai piilota selain painamalla Macilla ⌘ ⇧ B tai Windowsissa ja Linuxissa Ctrl Shift B. Kun Dvina työskentelee näkymässä, jota et katsele, Laite-rivillä näkyy piste.

Anna Dvinan käyttää laitetta

Kun Dvina käyttää simulaattoria tai emulaattoria ensimmäisen kerran, se kysyy esimerkiksi Saako Dvina käyttää laitetta iPhone 17 Pro? Dvina näkee laitteen näytön, joten älä kirjaudu sillä oikeille tileillesi. Valitse Salli tai Hylkää. Vastauksesi tallennetaan laitekohtaisesti, joten sitä ei kysytä uudelleen toisessa keskustelussa. Kunnes annat luvan, näkymässä on vaihtoehto Anna Dvinan käyttää laitetta.

Kun Dvina työskentelee, näkymässä lukee Dvina käyttää tätä laitetta, ja keskustelussa näkyy laitteen reaaliaikainen näkymä. Valitse Näytä suurempana, jos haluat nähdä sen suurempana. Lähettäminen, maksaminen ja poistaminen laitteella odottavat hyväksyntääsi joka kerta.

Jos haluat käyttää laitetta itse, valitse Ota hallinta. Napautuksesi ja näppäinpainalluksesi välitetään laitteelle. Voit painaa Koti-painiketta ja Androidissa myös Takaisin- ja Viimeaikaiset sovellukset -painikkeita. Kun olet valmis, valitse Palauta hallinta, niin Dvina jatkaa.

Ota iOS-simulaattori käyttöön

Jos iOS-simulaattoria ei ole otettu käyttöön, sen riviltä avautuu tarkistuslista Ota iOS-simulaattori käyttöön. Jokainen vaihe merkitään automaattisesti tehdyksi, kun se on valmis, vaikka olisit tehnyt sen muualla.

  1. Asenna Xcode: Valitse Avaa App Store. Xcode on ilmainen ja sen koko on noin 7 GB. Avaa se kerran asennuksen valmistuttua.
  2. Valitse Xcode: Valitse Kopioi komento ja suorita se Terminalissa. Komento pyytää salasanaasi, joten Dvina ei koskaan suorita sitä puolestasi.
  3. Lisää iOS-simulaattori: Siirry Xcodessa kohtaan Settings › Components ja lataa iOS tai suorita komento Terminalissa.
  4. Luo laite: Valitse Luo iPhone. Mitään ei ladata.

Ota Android-emulaattori käyttöön

Jos Android-emulaattoria ei ole otettu käyttöön, sen riviltä avautuu tarkistuslista Ota Android-emulaattori käyttöön.

  1. Asenna Android Studio: Valitse Hanki Android Studio. Se asentaa emulaattorin tarvitsemat ohjelmistot. Avaa se kerran asennuksen valmistuttua.
  2. Lisää emulaattori ja alustatyökalut: Suorita komento päätteessä tai lisää ne kohdassa Android Studio › SDK Manager.
  3. Ota laitteistokiihdytys käyttöön: Suorita komento itse Windowsissa ja Linuxissa, sillä se vaatii salasanasi tai ylläpitäjän oikeudet. Kirjaudu sitten Linuxissa ulos ja takaisin sisään tai käynnistä Windows uudelleen. Macilla tässä vaiheessa ei tarvitse tehdä mitään.
  4. Lisää järjestelmälevykuva: Suorita komento päätteessä tai lisää levykuva kohdassa Android Studio › SDK Manager. Ladattava tiedosto on suuri.
  5. Luo emulaattori: Valitse Luo emulaattori. Mitään ei ladata.

Jos ylläpitäjäsi on poistanut simulaattorit käytöstä, riveillä lukee Ylläpitäjä on poistanut käytöstä.

Työskentele missä tahansa

Pyydä työtä keskustelussa puhelimellasi tai verkossa. Dvina tekee työn tietokoneellasi olevassa projektissa, ja muutokset jäävät odottamaan tarkistustasi. Tietokoneesi on oltava päällä ja Dvinan avoinna.

Milloin käyttää

  • Työstät oikeaa ohjelmistoa ja haluat hyödyntää kaikkea aiempaa taustatietoa: muistiinpanoja, päätöksiä ja viime kuun keskusteluja.
  • Haluat korjauksen valmiiksi, kun olet poissa työpöytäsi äärestä.
  • Haluat, että useita muutoksia työstetään yhtä aikaa ja jokainen niistä on valmis tarkistettavaksi.

Vinkkejä

  • Kirjaa omat pelisääntösi. Kirjoita työskentelytapasi AGENTS.md- tai CLAUDE.md-tiedostoon, niin Dvina noudattaa niitä.
  • Testaa puhelimella. Rakennatko sovellusta? Dvina voi testata sitä iPhone-simulaattorissa tai Android-emulaattorissa ja napautella sitä samalla tavalla kuin käyttäjäsi. Katso Testaa simulaattorissa tai emulaattorissa.
  • Etkö ole kehittäjä? Jos haluat tehdä toimivia sovelluksia ja sivuja, käytä sen sijaan Luo-toimintoa.