# Msimbo

> Agiza Dvina iandike msimbo katika mradi kwenye kompyuta yako, kagua kila badiliko, kisha fanya commit na ufungue ombi la kuunganisha mabadiliko kutoka kwenye gumzo.

Dvina huandika msimbo katika mradi wako, kwenye kompyuta yako, huku ikizingatia madokezo, mazungumzo na sababu za kufanya kazi hiyo. Unaeleza unachotaka, unakagua ilichobadilisha na kutoa kazi hiyo kwa matumizi, ndani ya programu ileile unayotumia kwa mambo mengine yote.

## Kabla ya kuanza

Msimbo ni sehemu ya programu ya Dvina ya kompyuta, kwenye Mac, Windows na Linux. Hakuna kitu kingine cha kusakinisha. Dvina inahitaji kuwa kwenye angalau kompyuta moja; vifaa vingine vyote vinaweza kuanzisha kazi na kufuatilia maendeleo yake.

Ili kupata programu ya kompyuta, angalia [Pakua na usakinishe Dvina](/docs/use-dvina/get-started/install).

## Fungua mradi

Mradi ni folda kwenye kompyuta yako: hazina ya msimbo au folda ya kawaida.

1. Katika programu ya kompyuta, fungua Dock na uchague safu ya mradi (**Miradi**).
2. Chagua **Fungua…** ili kuchagua folda au hazina ya msimbo, au **Mradi Mpya…** ili kuunda folda mpya kwenye kompyuta hii.

Unapounda mradi mpya, washa **Unda hazina ya Git** ili kuweka historia ya kila badiliko, na hivyo kuweza kutengua mabadiliko ya Dvina.

Mradi unaochagua ndio unaotumiwa na gumzo kufanya kazi. Kwa mradi wa msimbo, Dock pia huonyesha tawi lake.

## Omba kazi ifanywe

Eleza unachotaka, kwa mfano "Hakikisha faili za CSV zinazotolewa zinatumia tarehe sahihi". Dvina hutekeleza ombi hilo kama kazi kwenye kompyuta yako, na unaweza kuendelea kuzungumza au kuanzisha kazi zaidi. Kazi kadhaa zinaweza kufanyika kwenye hazina moja na kuamua zenyewe ni ipi itafanya commit kwanza.

Kabla ya kuandika, Dvina husoma mradi pamoja na taarifa zinazouzunguka: hutafuta kwenye mazungumzo na faili zako za awali, ili izingatie pia sababu za kufanya kazi hiyo. Pia hufuata AGENTS.md au CLAUDE.md iliyo kwenye mradi wako.

## Kagua mabadiliko

Jibu la kila kazi huja pamoja na mabadiliko yake, kwenye kadi yenye jina la kazi na maneno **Tayari kukaguliwa**.

- **Angalia kilichobadilika:** Chagua **Mabadiliko** ili kuona mabadiliko ya kila faili kwenye paneli ya pembeni. **Faili** hukuwezesha kuvinjari mradi.
- **Tengua mabadiliko ya hatua moja:** Chini ya jibu lililobadilisha faili, chagua mstari unaosema ni faili ngapi zilibadilika, kisha **Tengua**, na uthibitishe **Ungependa kutengua hatua hii?**. Faili hurudi katika hali yake ya kabla ya hatua hiyo, na mabadiliko yaliyofanywa baada yake hubaki.

## Fanya commit na ufungue ombi la kuunganisha mabadiliko

1. Kwenye kadi ya kazi, chagua **Fanya commit**.
2. **Fanya commit ya mabadiliko** huorodhesha faili zitakazojumuishwa kwenye commit katika tawi lako, pamoja na **Kichwa** na **Ujumbe** unaopendekezwa. Chagua **Fanya commit**. Hakuna kinachotumwa kwenye hazina ya mbali.
3. Ili kufungua ombi la kuunganisha mabadiliko, chagua **Tuma na uunde PR**. Dvina hutuma tawi la sasa kwenye hazina ya mbali kwanza, kisha hufungua ombi la kuunganisha mabadiliko. Faili ambazo hazijafanyiwa commit hazijumuishwi.

Ombi la kuunganisha mabadiliko hutumia akaunti yako mwenyewe ya Git uliyoingia nayo. Dvina hulifungua kwenye GitHub au GitLab; huduma nyingine yoyote inayohifadhi hazina hufungua ukurasa wake wa ombi jipya la kuunganisha mabadiliko kwenye kivinjari chako. Ikimaliza, chagua **Angalia PR**.

## Idhini

Ujenzi na majaribio huendeshwa bila kuomba idhini. Kufuta faili, kutuma mabadiliko, kubadilisha hifadhidata, kupeleka programu kwenye mazingira ya matumizi na chochote kinachohusisha siri husubiri idhini yako. Kadi inaeleza sababu, kwa mfano **Uendeshe amri hii?** pamoja na **Inafuta faili** au **Inabadilisha hifadhidata**, nawe unachagua **Ruhusu** au **Kataa**. Msimamizi wako anaweza kuweka ni vitendo vingapi vinavyohitaji kuomba idhini kila wakati.

> [!IMPORTANT]
> Hakuna mabadiliko yanayotumwa hadi utoe idhini. Mradi wako ni folda kwenye kompyuta yako, na ukitumia Git, unaweza kutengua kila badiliko linalofanywa na Dvina.

## Jaribu kwenye simulator au emulator

Katika programu ya kompyuta, Dvina inaweza kujaribu programu yako kwenye kompyuta hii jinsi watumiaji wako watakavyoitumia: kwenye kivinjari, kwenye iOS Simulator katika Mac, au kwenye Android Emulator katika Mac, Windows au Linux.

1. Fungua Dock na uchague safu iliyoandikwa **Kifaa**.
2. Chini ya **Kifaa hiki**, chagua **Kivinjari**, **iOS Simulator** au **Android Emulator**.

Kidirisha kinafunguka kwenye paneli ya pembeni. Simulator iliyozimwa huanza kufanya kazi unapoifungua. Ili kutumia nyingine, chagua **Chagua kifaa** juu ya kidirisha; kila kifaa kinaonyesha mfumo wake na kama **Kinafanya kazi** au **Kimezimwa**.

Ili kuonyesha au kuficha kivinjari, bonyeza <kbd>⌘</kbd> <kbd>⇧</kbd> <kbd>B</kbd> kwenye Mac au <kbd>Ctrl</kbd> <kbd>Shift</kbd> <kbd>B</kbd> kwenye Windows na Linux. Dvina inapofanya kazi kwenye kidirisha usichokitazama, safu ya **Kifaa** huwa na nukta.

### Ruhusu Dvina kutumia kifaa

Mara ya kwanza Dvina inapotumia simulator au emulator, huomba ruhusa, kwa mfano **Uruhusu Dvina kutumia iPhone 17 Pro?**, kwa sababu Dvina inaona skrini yake, kwa hiyo usiingie kwenye akaunti zako halisi kwenye kifaa hicho. Chagua **Ruhusu** au **Kataa**. Kifaa huhifadhi jibu lako, kwa hiyo gumzo jingine haliombi ruhusa tena. Hadi uiruhusu, kidirisha huonyesha chaguo la **Ruhusu Dvina kukitumia**.

Dvina inapofanya kazi, kidirisha huonyesha **Dvina inatumia kifaa hiki**, na gumzo huonyesha kifaa moja kwa moja. Chagua **Tazama kwa ukubwa zaidi** ili kukiona kikiwa kikubwa zaidi. Kutuma, kulipa na kufuta kwenye kifaa husubiri idhini yako kila wakati.

Ili kutumia kifaa mwenyewe, chagua **Chukua udhibiti**. Miguso yako na vibonye unavyobonyeza huelekezwa kwenye kifaa, na unaweza kubonyeza **Mwanzo**, na kwenye Android, **Nyuma** na **Programu za hivi karibuni**. Ukimaliza, chagua **Rudisha udhibiti**, na Dvina inaendelea.

### Sanidi iOS Simulator

Ikiwa iOS Simulator haijasanidiwa, safu yake hufungua orodha ya ukaguzi, **Sanidi iOS Simulator**. Kila hatua huwekwa alama kiotomatiki inapokamilika, hata kama uliifanya mahali pengine.

1. **Sakinisha Xcode:** Chagua **Fungua App Store**. Xcode ni ya bure na ina ukubwa wa takribani 7 GB; ifungue mara moja baada ya usakinishaji kukamilika.
2. **Chagua Xcode:** Chagua **Nakili amri** na uiendeshe kwenye Terminal. Inakuomba nenosiri lako, kwa hiyo Dvina haiendeshi kamwe kwa niaba yako.
3. **Ongeza simulator ya iOS:** Katika Xcode, nenda kwenye Settings › Components na upakue iOS, au endesha amri kwenye Terminal.
4. **Unda kifaa:** Chagua **Unda iPhone**. Hakuna kinachopakuliwa.

### Sanidi Android Emulator

Ikiwa Android Emulator haijasanidiwa, safu yake hufungua orodha ya ukaguzi, **Sanidi emulator ya Android**.

1. **Sakinisha Android Studio:** Chagua **Pata Android Studio**. Inasakinisha vinavyohitajika ili emulator ifanye kazi; ifungue mara moja baada ya usakinishaji kukamilika.
2. **Ongeza emulator na zana za jukwaa:** Endesha amri kwenye terminal, au uziongeze katika Android Studio › SDK Manager.
3. **Washa uharakishaji wa maunzi:** Kwenye Windows na Linux, endesha amri mwenyewe, kwa kuwa inahitaji nenosiri lako au msimamizi. Kisha ondoka kwenye akaunti na uingie tena kwenye Linux, au uanzishe upya kompyuta kwenye Windows. Mac haihitaji hatua yoyote hapa.
4. **Ongeza taswira ya mfumo:** Endesha amri kwenye terminal, au uongeze moja katika Android Studio › SDK Manager. Upakuaji wake ni mkubwa.
5. **Unda emulator:** Chagua **Unda emulator**. Hakuna kinachopakuliwa.

Ikiwa msimamizi wako amezima simulator, safu zinaonyesha **Zimezimwa na msimamizi wako**.

## Fanya kazi ukiwa popote

Ukiwa kwenye simu yako au wavuti, omba kazi ifanywe kwenye mazungumzo yako. Dvina inaifanyia kazi ndani ya mradi kwenye kompyuta yako, na mabadiliko yanakusubiri uyakague. Kompyuta yako inahitaji kuwa imewashwa na Dvina ikiwa imefunguliwa.

## Wakati wa kutumia

- Unatengeneza programu halisi na unataka kuwa na muktadha wote wa kazi yako: madokezo, maamuzi na mazungumzo ya mwezi uliopita.
- Unataka marekebisho yafanywe ukiwa mbali na dawati lako.
- Unataka mabadiliko kadhaa yafanyiwe kazi kwa wakati mmoja, kila moja likiwa tayari kukaguliwa.

## Vidokezo

- **Andika kanuni zako za kazi.** Eleza jinsi unavyofanya kazi katika AGENTS.md au CLAUDE.md, na Dvina itafuata maelekezo hayo.
- **Jaribu kwenye simu.** Unatengeneza programu? Dvina inaweza kuijaribu kwenye simulator ya iPhone au emulator ya Android, ikigusa sehemu mbalimbali jinsi watumiaji wako watakavyofanya. Angalia [Jaribu kwenye simulator au emulator](#test-on-a-simulator-or-emulator).
- **Wewe si msanidi programu?** Ili kutengeneza programu na kurasa zinazofanya kazi, tumia [Unda](/docs/use-dvina/features/create) badala yake.

## Yanayohusiana

- [Miradi](/docs/use-dvina/features/projects)
- [Kazi](/docs/use-dvina/features/tasks)
- [Matumizi ya kompyuta](/docs/use-dvina/features/computer-use)
- [Sakinisha](/docs/use-dvina/get-started/install)