Markdown olarak gör

Dvina, notları, yazışmaları ve gerekçeleri göz önünde bulundurarak bilgisayarınızdaki projenizde kod yazar. Ne istediğinizi anlatır, yaptığı değişiklikleri inceler ve kodu kullanıma sunarsınız. Bunların hepsini, diğer işleriniz için de kullandığınız aynı uygulamada yaparsınız.

Başlamadan önce

Kod, Mac, Windows ve Linux'ta Dvina masaüstü uygulamasının bir parçasıdır. Ayrı bir kurulum gerekmez. Dvina'nın en az bir bilgisayarda bulunması gerekir; diğer tüm cihazlardan işi başlatabilir ve takip edebilirsiniz.

Masaüstü uygulamasını edinmek için Dvina'yı indirme ve yükleme sayfasına bakın.

Bir proje açın

Proje, bilgisayarınızdaki bir klasördür: bir kod deposu veya sıradan bir klasör olabilir.

  1. Masaüstü uygulamasında Dock'u açın ve proje satırını (Projeler) seçin.
  2. Bir klasör veya kod deposu seçmek için Aç…, bu bilgisayarda yeni bir klasör oluşturmak için Yeni Proje… seçeneğini seçin.

Yeni bir proje oluştururken Git deposu oluştur seçeneğini açın. Böylece her değişikliğin geçmişi tutulur ve Dvina'nın düzenlemeleri geri alınabilir.

Sohbet, seçtiğiniz projede çalışır. Bir kod projesinde Dock, projenin dalını da gösterir.

Yapılacak işi anlatın

Ne istediğinizi anlatın; örneğin, "CSV dışa aktarımında doğru tarihlerin kullanılmasını sağla". Dvina bunu bilgisayarınızda bir görev olarak yürütür. Bu sırada konuşmaya devam edebilir veya başka görevler başlatabilirsiniz. Birden fazla görev aynı depoda çalışabilir ve hangisinin önce commit oluşturacağına kendi aralarında karar verebilir.

Dvina, kod yazmadan önce projeyi çevresindeki bağlamla birlikte okur: geçmiş sohbetlerinizi ve dosyalarınızı arar, böylece gerekçeleri de hesaba katar. Ayrıca projenizdeki AGENTS.md veya CLAUDE.md dosyasına da uyar.

Değişiklikleri inceleyin

Her görevin yanıtı, yaptığı değişikliklerle birlikte, görevin adını taşıyan ve İncelemeye hazır yazan bir kartta gelir.

  • Nelerin değiştiğini görün: Her dosyadaki değişiklikleri yan panelde görmek için Değişiklikler seçeneğini seçin. Dosyalar ile projeye göz atabilirsiniz.
  • Bir adımı geri alın: Dosyaları değiştiren bir yanıtın altında, kaç dosyanın değiştiğini belirten satırı seçin. Ardından Geri al seçeneğini seçip Bu adım geri alınsın mı? sorusunu onaylayın. Dosyalar o adımdan önceki hâline döner; sonradan yapılan değişiklikler korunur.

Commit oluşturun ve pull request açın

  1. Görevin kartında Commit oluştur seçeneğini seçin.
  2. Değişiklikler için commit oluştur ekranı, dalınızda commit'e dahil edilecek dosyaları, önerilen bir Başlık ve Mesaj ile listeler. Commit oluştur seçeneğini seçin. Hiçbir şey uzak depoya gönderilmez.
  3. Pull request açmak için Gönder ve PR oluştur seçeneğini seçin. Dvina önce mevcut dalı uzak depoya gönderir, ardından pull request açar. Commit'e dahil edilmemiş dosyalar eklenmez.

Pull request, kendi Git oturumunuz üzerinden açılır. Dvina bunu GitHub veya GitLab'da açar; diğer barındırma hizmetlerinde ise hizmetin kendi yeni pull request sayfası tarayıcınızda açılır. İşlem tamamlandığında PR'ı görüntüle seçeneğini seçin.

Onaylar

Derleme ve testler doğrudan çalışır. Dosya silme, uzak depoya gönderme, veritabanı değişiklikleri, dağıtım ve gizli bilgilere erişen tüm işlemler onayınızı bekler. Kartta neden onay gerektiği belirtilir; örneğin Bu komut çalıştırılsın mı? sorusuyla birlikte Dosyaları siler veya Veritabanında değişiklik yapar açıklaması gösterilir. Siz de İzin ver veya Reddet seçeneğini seçersiniz. Yöneticiniz hangi işlemlerin her zaman onay isteyeceğini ayarlayabilir.

Önemli

Siz onay vermeden hiçbir şey uzak depoya gönderilmez. Projeniz bilgisayarınızdaki bir klasördür ve Git sayesinde Dvina'nın yaptığı her değişiklik geri alınabilir.

Simülatörde veya emülatörde test edin

Masaüstü uygulamasında Dvina, uygulamanızı bu bilgisayarda kullanıcılarınızın kullanacağı şekilde deneyebilir: tarayıcıda, Mac'te iOS Simülatörü'nde ya da Mac, Windows veya Linux'ta Android Emülatörü'nde.

  1. Dock'u açın ve Cihaz olarak işaretlenmiş satırı seçin.
  2. Bu cihaz altında Tarayıcı, iOS Simülatörü veya Android Emülatörü seçeneğini seçin.

Bölme, yan panelde açılır. Kapalı olan bir simülatör, açtığınızda başlatılır. Başka bir simülatör kullanmak için bölmenin üst kısmındaki Cihaz seç seçeneğini seçin. Her cihazın sistemi ve Çalışıyor veya Kapalı durumu gösterilir.

Tarayıcıyı göstermek veya gizlemek için Mac'te ⌘ ⇧ B, Windows ve Linux'ta Ctrl Shift B tuşlarına basın. Dvina, bakmadığınız bir bölmede çalışırken Cihaz satırında bir nokta görünür.

Dvina'nın bir cihazı kullanmasına izin verin

Dvina bir simülatörü veya emülatörü ilk kez kullanırken, örneğin Dvina'nın iPhone 17 Pro'yu kullanmasına izin verilsin mi? diye sorar. Dvina cihazın ekranını görebildiği için cihazda gerçek hesaplarınıza giriş yapmayın. İzin ver veya Reddet seçeneğini seçin. Cihaz yanıtınızı hatırlar; böylece başka bir sohbette yeniden sorulmaz. İzin verene kadar bölmede Dvina'nın kullanmasına izin ver seçeneği sunulur.

Dvina çalışırken bölmede Dvina bu cihazı kullanıyor yazısı görünür ve sohbette cihaz canlı olarak gösterilir. Daha büyük görmek için Büyük izle seçeneğini seçin. Cihazdaki gönderme, ödeme ve silme işlemleri her seferinde onayınızı bekler.

Cihazı kendiniz kullanmak için Kontrolü devral seçeneğini seçin. Dokunuşlarınız ve tuş girişleriniz cihaza iletilir. Ana ekran düğmesine, Android'de ayrıca Geri ve Son uygulamalar düğmelerine basabilirsiniz. İşiniz bittiğinde Kontrolü geri ver seçeneğini seçin; Dvina çalışmaya devam eder.

iOS Simülatörü'nü kurun

iOS Simülatörü kurulu değilse ilgili satır, iOS Simülatörü'nü kur kontrol listesini açar. Her adım, başka bir yerde tamamlamış olsanız bile, tamamlandığında otomatik olarak işaretlenir.

  1. Xcode'u yükleyin: App Store'u aç seçeneğini seçin. Xcode ücretsizdir ve yaklaşık 7 GB boyutundadır; yükleme tamamlandığında bir kez açın.
  2. Xcode'u seçin: Komutu kopyala seçeneğini seçin ve komutu Terminal'de çalıştırın. Komut parolanızı ister; bu nedenle Dvina komutu asla sizin yerinize çalıştırmaz.
  3. iOS simülatörünü ekleyin: Xcode'da Ayarlar › Bileşenler bölümüne gidip iOS'u indirin veya komutu Terminal'de çalıştırın.
  4. Bir cihaz oluşturun: iPhone oluştur seçeneğini seçin. Hiçbir şey indirilmez.

Android Emülatörü'nü kurun

Android Emülatörü kurulu değilse ilgili satır, Android emülatörünü kur kontrol listesini açar.

  1. Android Studio'yu yükleyin: Android Studio'yu indir seçeneğini seçin. Bu, emülatörün çalışması için gereken bileşenleri yükler; yükleme tamamlandığında bir kez açın.
  2. Emülatörü ve platform araçlarını ekleyin: Komutu bir terminalde çalıştırın veya bunları Android Studio › SDK Manager bölümünden ekleyin.
  3. Donanım hızlandırmayı açın: Windows ve Linux'ta komutu kendiniz çalıştırın; çünkü parolanız veya yönetici yetkisi gerekir. Ardından Linux'ta oturumu kapatıp yeniden açın, Windows'ta ise bilgisayarı yeniden başlatın. Mac'te bu adımda bir şey yapmanız gerekmez.
  4. Bir sistem imajı ekleyin: Komutu bir terminalde çalıştırın veya Android Studio › SDK Manager bölümünden bir imaj ekleyin. İndirme boyutu büyüktür.
  5. Bir emülatör oluşturun: Emülatör oluştur seçeneğini seçin. Hiçbir şey indirilmez.

Yöneticiniz simülatörleri kapattıysa satırlarda Yöneticiniz tarafından kapatıldı yazısı görünür.

Her yerden çalışın

Telefonunuzdan veya web üzerinden sohbetinizde yapılmasını istediğiniz işi belirtin. Dvina, bilgisayarınızdaki projede bu iş üzerinde çalışır; değişiklikler incelemenizi bekler. Bilgisayarınızın açık ve Dvina'nın çalışır durumda olması gerekir.

Ne zaman kullanılır

  • Gerçek bir yazılım üzerinde çalışıyor ve tüm geçmişin elinizin altında olmasını istiyorsanız: notlar, kararlar ve geçen ayki yazışmalar.
  • Masanızdan uzaktayken bir düzeltmenin yapılmasını istiyorsanız.
  • Birden fazla değişiklik üzerinde aynı anda çalışılmasını ve her birinin incelemeye hazır olmasını istiyorsanız.

İpuçları

  • Çalışma kurallarınızı yazın. Nasıl çalıştığınızı AGENTS.md veya CLAUDE.md dosyasına yazın; Dvina bunlara uyar.
  • Telefonda test edin. Bir uygulama mı geliştiriyorsunuz? Dvina, uygulamanızı bir iPhone simülatöründe veya Android emülatöründe, kullanıcılarınızın yapacağı gibi dokunarak test edebilir. Simülatörde veya emülatörde test etme bölümüne bakın.
  • Geliştirici değil misiniz? Çalışan uygulamalar ve sayfalar için bunun yerine Oluştur özelliğini kullanın.