# کوڈ

> Dvina سے اپنے کمپیوٹر پر کسی پروجیکٹ میں کوڈ لکھوائیں، ہر تبدیلی کا جائزہ لیں، پھر چیٹ سے ہی کمیٹ کریں اور پُل ریکویسٹ کھولیں۔

Dvina آپ کے کمپیوٹر پر آپ کے پروجیکٹ میں کوڈ لکھتا ہے، اور نوٹس، گفتگو کے سلسلے اور کام کی وجوہات کو سامنے رکھتا ہے۔ آپ بتاتے ہیں کہ آپ کیا چاہتے ہیں، اس کی تبدیلیوں کا جائزہ لیتے ہیں اور کام ریلیز کرتے ہیں—اسی ایپ میں جسے آپ باقی سب کاموں کے لیے استعمال کرتے ہیں۔

## شروع کرنے سے پہلے

کوڈ، Mac، Windows اور Linux پر Dvina ڈیسک ٹاپ ایپ کا حصہ ہے۔ الگ سے کچھ انسٹال کرنے کی ضرورت نہیں۔ Dvina کم از کم ایک کمپیوٹر پر ہونا چاہیے؛ باقی ہر ڈیوائس سے کام شروع کیا جا سکتا ہے اور اس کی پیش رفت دیکھی جا سکتی ہے۔

ڈیسک ٹاپ ایپ حاصل کرنے کے لیے، [Dvina ڈاؤن لوڈ اور انسٹال کریں](/docs/use-dvina/get-started/install) دیکھیں۔

## پروجیکٹ کھولیں

پروجیکٹ آپ کے کمپیوٹر پر ایک فولڈر ہوتا ہے: کوڈ ریپوزٹری یا عام فولڈر۔

1. ڈیسک ٹاپ ایپ میں ڈاک کھولیں اور پروجیکٹ کی قطار (**پروجیکٹس**) منتخب کریں۔
2. فولڈر یا کوڈ ریپوزٹری منتخب کرنے کے لیے **کھولیں…** منتخب کریں، یا اس کمپیوٹر پر نیا فولڈر بنانے کے لیے **نیا پروجیکٹ…** منتخب کریں۔

نیا پروجیکٹ بناتے وقت **Git ریپوزٹری بنائیں** کو فعال کریں تاکہ ہر تبدیلی کی تاریخ محفوظ رہے اور Dvina کی تبدیلیاں واپس لی جا سکیں۔

چیٹ اسی پروجیکٹ میں کام کرتی ہے جسے آپ منتخب کرتے ہیں۔ کوڈ پروجیکٹ کے لیے ڈاک اس کی برانچ بھی دکھاتا ہے۔

## کام بتائیں

بتائیں کہ آپ کیا چاہتے ہیں، مثلاً "CSV ایکسپورٹ میں درست تاریخیں استعمال کریں"۔ Dvina اسے آپ کے کمپیوٹر پر ایک ٹاسک کے طور پر چلاتا ہے، اور آپ گفتگو جاری رکھ سکتے ہیں یا مزید ٹاسک شروع کر سکتے ہیں۔ ایک ہی ریپوزٹری پر کئی ٹاسک کام کر سکتے ہیں اور آپس میں طے کر سکتے ہیں کہ پہلے کون کمیٹ کرے گا۔

لکھنے سے پہلے Dvina پروجیکٹ کو اس کے متعلقہ سیاق و سباق کے ساتھ پڑھتا ہے: یہ آپ کی پچھلی چیٹس اور فائلوں میں تلاش کرتا ہے، تاکہ کام کی وجوہات بھی ساتھ رہیں۔ یہ آپ کے پروجیکٹ میں موجود AGENTS.md یا CLAUDE.md کی ہدایات پر بھی عمل کرتا ہے۔

## تبدیلیوں کا جائزہ لیں

ہر ٹاسک کا جواب اس کی تبدیلیوں کے ساتھ، اسی ٹاسک کے نام والے کارڈ میں آتا ہے، جس پر **جائزے کے لیے تیار** لکھا ہوتا ہے۔

- **دیکھیں کیا بدلا ہے:** سائیڈ پینل میں ہر فائل کی تبدیلیاں دیکھنے کے لیے **تبدیلیاں** منتخب کریں۔ **فائلیں** سے آپ پروجیکٹ کی فائلیں دیکھ سکتے ہیں۔
- **ایک باری کی تبدیلیاں واپس لیں:** جس جواب نے فائلیں تبدیل کی ہوں، اس کے نیچے وہ سطر منتخب کریں جو بتاتی ہے کہ کتنی فائلیں بدلی ہیں، پھر **واپس کریں** منتخب کریں، اور **اس باری کی تبدیلیاں واپس کریں؟** کی تصدیق کریں۔ فائلیں اس باری سے پہلے والی حالت میں واپس آ جاتی ہیں، جبکہ اس کے بعد کی گئی تبدیلیاں برقرار رہتی ہیں۔

## کمیٹ کریں اور پُل ریکویسٹ کھولیں

1. ٹاسک کے کارڈ میں **کمیٹ کریں** منتخب کریں۔
2. **تبدیلیاں کمیٹ کریں** میں ان فائلوں کی فہرست دکھائی جاتی ہے جو آپ کی برانچ پر کمیٹ ہوں گی، ساتھ ہی ایک تجویز کردہ **عنوان** اور **پیغام** بھی ہوتا ہے۔ **کمیٹ کریں** منتخب کریں۔ کچھ بھی پُش نہیں ہوتا۔
3. پُل ریکویسٹ کھولنے کے لیے **پُش کریں اور PR بنائیں** منتخب کریں۔ Dvina پہلے موجودہ برانچ پُش کرتا ہے، پھر پُل ریکویسٹ کھولتا ہے۔ جو فائلیں کمیٹ نہیں ہوئیں، وہ شامل نہیں ہوتیں۔

پُل ریکویسٹ آپ کے اپنے Git سائن اِن کے ذریعے بنتی ہے۔ Dvina اسے GitHub یا GitLab پر کھولتا ہے؛ کسی دوسرے ہوسٹ کے لیے آپ کے براؤزر میں اس ہوسٹ کا نئی پُل ریکویسٹ بنانے والا صفحہ کھلتا ہے۔ مکمل ہونے پر **PR دیکھیں** منتخب کریں۔

## منظوری

بلڈ اور ٹیسٹ خود ہی چل جاتے ہیں۔ فائلیں حذف کرنا، پُش کرنا، ڈیٹابیس میں تبدیلیاں، ڈیپلائے کرنا اور خفیہ معلومات سے متعلق کوئی بھی کام آپ کی منظوری کا انتظار کرتا ہے۔ کارڈ پر اس کی وجہ لکھی ہوتی ہے، مثلاً **یہ کمانڈ چلائیں؟** کے ساتھ **فائلیں حذف کرتی ہے** یا **ڈیٹابیس میں تبدیلی کرتی ہے**، اور آپ **اجازت دیں** یا **مسترد کریں** منتخب کرتے ہیں۔ آپ کا منتظم طے کر سکتا ہے کہ کن کاموں کے لیے ہمیشہ منظوری مانگی جائے۔

> [!IMPORTANT]
> جب تک آپ نہ کہیں، کچھ بھی پُش نہیں کیا جاتا۔ آپ کا پروجیکٹ آپ کے کمپیوٹر پر ایک فولڈر ہے، اور Git کے ذریعے Dvina کی کی ہوئی ہر تبدیلی واپس لی جا سکتی ہے۔

## سیمولیٹر یا ایمولیٹر پر ٹیسٹ کریں

ڈیسک ٹاپ ایپ میں Dvina اسی کمپیوٹر پر آپ کی ایپ کو اس طرح آزما سکتا ہے جیسے آپ کے صارفین اسے استعمال کریں گے: براؤزر میں، Mac پر iOS Simulator میں، یا Mac، Windows یا Linux پر Android Emulator میں۔

1. Dock کھولیں اور **ڈیوائس** والی قطار منتخب کریں۔
2. **یہ ڈیوائس** کے تحت **براؤزر**، **iOS Simulator** یا **Android Emulator** منتخب کریں۔

پین سائیڈ پینل میں کھلتا ہے۔ اگر سیمولیٹر بند ہو تو اسے کھولنے پر وہ شروع ہو جاتا ہے۔ کوئی دوسرا سیمولیٹر استعمال کرنے کے لیے پین کے اوپر **ڈیوائس منتخب کریں** منتخب کریں؛ ہر ڈیوائس کے ساتھ اس کا سسٹم اور یہ دکھایا جاتا ہے کہ وہ **چل رہی ہے** یا **بند ہے**۔

براؤزر دکھانے یا چھپانے کے لیے Mac پر <kbd>⌘</kbd> <kbd>⇧</kbd> <kbd>B</kbd> یا Windows اور Linux پر <kbd>Ctrl</kbd> <kbd>Shift</kbd> <kbd>B</kbd> دبائیں۔ جب Dvina کسی ایسے پین میں کام کر رہا ہو جسے آپ نہیں دیکھ رہے، تو **ڈیوائس** کی قطار پر ایک نقطہ نظر آتا ہے۔

### Dvina کو ڈیوائس استعمال کرنے کی اجازت دیں

جب Dvina پہلی بار کسی سیمولیٹر یا ایمولیٹر کو استعمال کرتا ہے تو وہ اجازت مانگتا ہے، مثلاً **Dvina کو iPhone 17 Pro استعمال کرنے دیں؟**، کیونکہ Dvina اس کی اسکرین دیکھتا ہے، اس لیے اس پر اپنے اصل اکاؤنٹس میں سائن اِن نہ کریں۔ **اجازت دیں** یا **مسترد کریں** منتخب کریں۔ ڈیوائس آپ کا جواب محفوظ رکھتی ہے، اس لیے کسی دوسری چیٹ میں دوبارہ نہیں پوچھا جاتا۔ جب تک آپ اجازت نہیں دیتے، پین میں **Dvina کو اسے استعمال کرنے دیں** کا اختیار نظر آتا ہے۔

جب Dvina کام کر رہا ہوتا ہے تو پین میں **Dvina یہ ڈیوائس استعمال کر رہا ہے** لکھا ہوتا ہے، اور چیٹ میں ڈیوائس براہِ راست نظر آتی ہے۔ اسے بڑا دیکھنے کے لیے **بڑی اسکرین پر دیکھیں** منتخب کریں۔ ڈیوائس پر کچھ بھی بھیجنے، ادائیگی کرنے اور حذف کرنے کے لیے ہر بار آپ کی منظوری کا انتظار کیا جاتا ہے۔

ڈیوائس خود استعمال کرنے کے لیے **کنٹرول سنبھالیں** منتخب کریں۔ آپ کے ٹیپ اور دبائی گئی کیز ڈیوائس پر کام کرتی ہیں، اور آپ **ہوم**، اور Android پر **واپس** اور **حالیہ ایپس** دبا سکتے ہیں۔ کام مکمل ہونے پر **کنٹرول واپس دیں** منتخب کریں، اور Dvina اپنا کام جاری رکھتا ہے۔

### iOS Simulator سیٹ اپ کریں

اگر iOS Simulator سیٹ اپ نہیں ہے تو اس کی قطار سے **iOS Simulator سیٹ اپ کریں** کی چیک لسٹ کھلتی ہے۔ ہر مرحلہ مکمل ہونے پر خود ہی نشان زد ہو جاتا ہے، چاہے آپ نے اسے کہیں اور مکمل کیا ہو۔

1. **Xcode انسٹال کریں:** **App Store کھولیں** منتخب کریں۔ Xcode مفت ہے اور تقریباً 7 GB کا ہے؛ انسٹال ہونے کے بعد اسے ایک بار کھولیں۔
2. **Xcode منتخب کریں:** **کمانڈ کاپی کریں** منتخب کریں اور اسے Terminal میں چلائیں۔ یہ آپ کا پاس ورڈ مانگتی ہے، اس لیے Dvina اسے کبھی آپ کی طرف سے نہیں چلاتا۔
3. **iOS سیمولیٹر شامل کریں:** Xcode میں Settings › Components پر جائیں اور iOS حاصل کریں، یا Terminal میں کمانڈ چلائیں۔
4. **ڈیوائس بنائیں:** **ایک iPhone بنائیں** منتخب کریں۔ کچھ بھی ڈاؤن لوڈ نہیں ہوتا۔

### Android Emulator سیٹ اپ کریں

اگر Android Emulator سیٹ اپ نہیں ہے تو اس کی قطار سے **Android ایمولیٹر سیٹ اپ کریں** کی چیک لسٹ کھلتی ہے۔

1. **Android Studio انسٹال کریں:** **Android Studio حاصل کریں** منتخب کریں۔ یہ وہ سافٹ ویئر انسٹال کرتا ہے جس پر ایمولیٹر چلتا ہے؛ انسٹال ہونے کے بعد اسے ایک بار کھولیں۔
2. **ایمولیٹر اور پلیٹ فارم ٹولز شامل کریں:** ٹرمینل میں کمانڈ چلائیں، یا انہیں Android Studio › SDK Manager میں شامل کریں۔
3. **ہارڈویئر ایکسلریشن فعال کریں:** Windows اور Linux پر کمانڈ خود چلائیں، کیونکہ اس کے لیے آپ کا پاس ورڈ یا منتظم درکار ہوتا ہے۔ پھر Linux پر سائن آؤٹ کر کے دوبارہ سائن اِن کریں، یا Windows پر ری اسٹارٹ کریں۔ Mac پر اس مرحلے میں کچھ کرنے کی ضرورت نہیں۔
4. **سسٹم امیج شامل کریں:** ٹرمینل میں کمانڈ چلائیں، یا Android Studio › SDK Manager میں سسٹم امیج شامل کریں۔ یہ ایک بڑی ڈاؤن لوڈ ہے۔
5. **ایمولیٹر بنائیں:** **ایمولیٹر بنائیں** منتخب کریں۔ کچھ بھی ڈاؤن لوڈ نہیں ہوتا۔

اگر آپ کے منتظم نے سیمولیٹرز بند کر دیے ہیں تو قطاروں میں **آپ کے منتظم نے بند کیا ہے** لکھا ہوتا ہے۔

## کہیں سے بھی کام کریں

اپنے فون یا ویب سے چیٹ میں کام کرنے کو کہیں۔ Dvina آپ کے کمپیوٹر پر موجود پروجیکٹ میں وہ کام کرتا ہے، اور تبدیلیاں آپ کے جائزے کے لیے تیار رہتی ہیں۔ آپ کا کمپیوٹر آن ہونا چاہیے اور اس پر Dvina کھلا ہونا چاہیے۔

## کب استعمال کریں

- آپ کسی حقیقی سافٹ ویئر پر کام کر رہے ہیں اور اس کا پورا پس منظر ساتھ رکھنا چاہتے ہیں: نوٹس، فیصلے اور پچھلے مہینے کی گفتگو کے تھریڈز۔
- آپ چاہتے ہیں کہ آپ کی میز سے دور ہونے کے دوران کوئی مسئلہ ٹھیک کر دیا جائے۔
- آپ چاہتے ہیں کہ کئی تبدیلیوں پر ایک ساتھ کام ہو اور ہر ایک جائزے کے لیے تیار ہو۔

## مفید مشورے

- **اپنے کام کے اصول لکھ دیں۔** اپنے کام کرنے کا طریقہ AGENTS.md یا CLAUDE.md میں لکھیں، اور Dvina اس پر عمل کرے گا۔
- **فون پر ٹیسٹ کریں۔** کوئی ایپ بنا رہے ہیں؟ Dvina اسے iPhone سمیولیٹر یا Android ایمولیٹر میں ٹیسٹ کر سکتا ہے، اس میں اسی طرح ٹیپ کر کے جیسے آپ کے صارفین کریں گے۔ [سمیولیٹر یا ایمولیٹر پر ٹیسٹ کریں](#test-on-a-simulator-or-emulator) دیکھیں۔
- **ڈیولپر نہیں ہیں؟** کام کرنے والی ایپس اور صفحات بنانے کے لیے اس کے بجائے [تخلیق کریں](/docs/use-dvina/features/create) استعمال کریں۔

## متعلقہ

- [پروجیکٹس](/docs/use-dvina/features/projects)
- [ٹاسکس](/docs/use-dvina/features/tasks)
- [کمپیوٹر کا استعمال](/docs/use-dvina/features/computer-use)
- [انسٹال کریں](/docs/use-dvina/get-started/install)
